Je project online zetten

Op EduInsights zet je je code online vanuit een GitHub-repository. Jij pusht je code naar GitHub, EduInsights haalt hem op, bouwt hem en serveert je site op een eigen adres. Deze gids laat de hele weg zien: een app aanmaken, een database koppelen en de dev-loop van je laptop naar een live website.

Wat heb je nodig?
Je code in een GitHub-repository binnen de schoolorganisatie. Heb je nog geen repo? Maak er eerst een en push je project erheen.

Het grote plaatje

text
Jouw laptop  ──push──▶  GitHub  ──Opnieuw deployen──▶  EduInsights bouwt & host
                                                              │
                                                              ▼
                                    https://<gebruikersnaam>-<slug>.eduinsights.nl

Je werkt dus altijd lokaal, pusht naar GitHub, en EduInsights maakt daar een live website van.

1. Een nieuwe app aanmaken

  1. Ga naar Cloud → Apps en klik op Nieuw project.
  2. Repository kiezen — selecteer de GitHub-repo met jouw code.
  3. Naam & URL — geef je project een naam en kies een slug (het stukje in de URL). Je site komt op:
    text
    https://<gebruikersnaam>-<slug>.eduinsights.nl
  4. Type project — kies hoe je app gehost wordt (zie de tabel hieronder).
  5. Opties — optioneel: een hoofdmap als je code in een submap staat, wachtwoordbeveiliging, en (voor Next.js/Go) build-commando's.

Klik op Project aanmaken. EduInsights haalt meteen je code op en doet de eerste deploy.

2. Welk type project?

Het type bepaalt hoe je app gebouwd en gedraaid wordt.

TypeWaarvoorBuild?
StatischHTML, CSS en JavaScript (portfolio, landingspagina)Nee — bestanden worden direct geserveerd
PHPServer-side PHP, meestal met MySQLNee — direct geserveerd door PHP
Next.jsFull-stack React met server-side renderingJa — wordt gebouwd in een container
GoGo HTTP-serverJa — wordt gecompileerd in een container
Twijfel je?
Alleen HTML/CSS/JS? Kies Statisch. Server-side PHP met een database? Kies PHP. Een Next.js-app? Kies Next.js. Voor Next.js en Go gelden extra build-instellingen — zie Build, env vars & commando's.

3. Een database koppelen

Sla je gegevens op (gebruikers, berichten, producten)? Maak een MySQL-database aan en koppel hem aan je app. Zodra je koppelt, krijgt je app automatisch de DB_* omgevingsvariabelen.

  1. Maak een database aan onder Cloud → DatabasesNieuwe database.
  2. Open je app en ga naar het tabblad Database → kies je database.

Hele uitleg in Databases bij EduInsights en Verbindingsgegevens.

Nooit wachtwoorden in je code
Lees database-gegevens altijd uit de DB_* omgevingsvariabelen (getenv(), process.env, os.environ). Zo staan ze nóóit in je GitHub-repo. Zie Veiligheid.

4. De dev-loop: van lokaal naar live

Dit is je dagelijkse ritme tijdens het bouwen:

  1. Code lokaal op je laptop.
  2. Test lokaal — bijv. npm run dev (Next.js), de PHP-server of XAMPP, of go run . (Go).
  3. Commit & push naar GitHub:
    bash
    git add .
    git commit -m "Mijn wijziging"
    git push
  4. Open je app op EduInsights en klik op Opnieuw deployen. Die knop haalt de nieuwste code van GitHub op en deployt opnieuw.
  5. Volg de voortgang. Een Next.js/Go-build duurt een paar minuten; je ziet de status op Bezig… staan en daarna Actief.
  6. Klik op Bekijk site om het resultaat te zien.
Pushen is niet hetzelfde als deployen
Een git push zet je code op GitHub, maar zet hem nog niet live. Klik daarna altijd op Opnieuw deployen om je nieuwste code op te halen en te deployen.
Statische en PHP-sites kunnen automatisch updaten
Heeft je docent de GitHub-webhook ingesteld, dan worden statische en PHP-sites bij een push automatisch opnieuw gedeployd. Next.js- en Go-apps moet je altijd zelf opnieuw deployen met de knop. Werkt het niet automatisch? Gebruik dan gewoon Opnieuw deployen — dat werkt altijd.

5. Status van je app

Bovenaan de detailpagina staat de status:

StatusBetekenis
Bezig…De build/deploy loopt nog. Even wachten.
ActiefJe site is live en bereikbaar.
MisluktDe build is mislukt. Open het tabblad Deployments voor de foutmelding en build-uitvoer.
UitgeschakeldDe app is (tijdelijk) uitgezet.

Loopt een deploy mis? Open het tabblad Deployments en klik de mislukte deploy open voor de build-uitvoer (git clone, installatie, build). Elke deploy wordt daar bewaard met status en tijdstip. Zie Build, env vars & commando's voor het lezen van logs.

Volgende stappen

Meer in Aan de slag