Ga naar inhoud

Hoe bouwen werkt

Een service die je koppelt aan een GitHub-repository, bouwt HostStuff zelf. Elke push naar de gekozen branch start een nieuwe build. Als die slaagt, rolt de nieuwe versie automatisch uit.

HostStuff kijkt in de map van je service (de repository, of de hoofdmap die je opgeeft, bijvoorbeeld apps/web):

  • Staat er een Dockerfile? Dan bouwt HostStuff die. Je hebt dan volledige controle.
  • Geen Dockerfile? Dan maakt Railpack een bouwplan. Railpack herkent de taal en het framework aan bestanden als package.json, requirements.txt, go.mod of Gemfile, en kiest zelf de runtime, de installatie en het startcommando. Met een railpack.json in de repository kun je dat plan bijsturen.

Railpack is dezelfde aanpak als bij Railway: voor de meeste apps hoef je niets te configureren.

  1. In de wachtrij. De build wacht op een vrije plek. Zo nodig start er een extra build-machine; dat duurt een paar minuten. Wachten mag maximaal een uur duren.
  2. Bouwen. HostStuff haalt de code op, bouwt het image en zet het in de registry van HostStuff (in Amsterdam).
  3. Uitrollen. De service start met het nieuwe image. Pas als de nieuwe versie klaar is, verdwijnt de oude.

Je volgt de build live op het tabblad Builds van je service, met de volledige log.

  • Bouwtijd: maximaal 30 minuten, gerekend vanaf het moment dat de build echt start (wachten telt niet mee). Daarna stopt de build met de melding “Tijdslimiet van 30 minuten overschreden”.
  • Cache: HostStuff bewaart per service een cache van de laatste build. Een tweede build van dezelfde app is daardoor vaak veel sneller.
  • Afgeschermd: builds draaien in een sandbox op eigen machines, los van de machines waar apps en databases draaien. Een build kan alleen naar buiten via HTTPS (git, package-registries).

Sommige frameworks lezen variabelen al tijdens het bouwen, bijvoorbeeld NEXT_PUBLIC_* bij Next.js of VITE_* bij Vite. Zet bij zo’n variabele het vinkje Ook tijdens build.

  • Met Railpack zijn ze gewoon beschikbaar als omgevingsvariabele.
  • In een eigen Dockerfile gebruik je ARG NAAM, of voor geheimen RUN --mount=type=secret,id=NAAM.

Een gewijzigde build-variabele werkt pas na een nieuwe build.

  • Luister op de poort uit PORT. HostStuff geeft een web service de variabele PORT mee (standaard 8080) en stuurt verkeer naar die poort. Een app die vast op een andere poort luistert, is niet bereikbaar.
  • Luister op alle adressen (0.0.0.0), niet alleen op localhost.
  • Geen bestanden bewaren in de container. Bij een nieuwe versie of een herstart begint de container leeg. Bewaar data in Postgres, Valkey of Supabase Storage.
  • Een worker blijft draaien. Een programma dat iets doet en dan stopt, wordt steeds opnieuw gestart (en staat dan op “Crasht steeds”). Voor taken die op vaste tijden lopen en dan stoppen, gebruik je een cronjob.

Elke geslaagde build blijft bewaard (de laatste 20 per service). Op het tabblad Builds kies je bij een eerdere build Terugrollen: die versie draait dan binnen een minuut weer, zonder opnieuw te bouwen.