Ga naar inhoud

Soorten services

Een project bestaat uit services. Elke service heeft een naam: kleine letters, cijfers en streepjes, beginnend met een letter, maximaal 30 tekens. De namen supabase en shared zijn gereserveerd.

Een app of API met een eigen adres (https://<service>-<ref>.apps.hoststuff.nl), uit een GitHub-repository of een image.

  • HostStuff geeft de variabele PORT mee (standaard 8080) en stuurt verkeer naar die poort. Kies een andere poort in de wizard als je app vast op bijvoorbeeld 3000 luistert. Toegestaan: 1024 tot 65535.
  • Replica’s: 0 tot 5 kopieën naast elkaar (standaard 1). Meer replica’s geven meer capaciteit en geen onderbreking als er één herstart.
  • Optioneel een eigen startcommando.

HTML of een single-page app (bijvoorbeeld Vite + React of Astro). HostStuff bouwt de site en serveert de bestanden zelf. Je krijgt hetzelfde adres als bij een web service, en ook eigen domeinen werken.

Achtergrondwerk zonder adres, voor iets dat altijd moet draaien: een queue-consumer, een bot, een sync-proces. Een worker die stopt, wordt opnieuw gestart. Stopt hij steeds, dan staat hij op Crasht steeds.

Een taak die op vaste tijden draait en dan stopt, zoals een nachtelijke export.

  • Het schema is een gewone cron-regel met vijf velden, bijvoorbeeld 0 3 * * * (elke nacht om 3:00 UTC). De wizard heeft voorbeelden.
  • Een run mag standaard 1 uur duren (instelbaar van 1 minuut tot 24 uur).
  • Er loopt nooit meer dan één run tegelijk.
  • De status laat het schema en de uitkomst van de laatste run zien.

Een eigen PostgreSQL-database, met back-ups en point-in-time herstel. Zie Postgres.

Een snelle key-value store voor caches, sessies en wachtrijen, compatibel met Redis. Zie Valkey.

Een complete Supabase-stack in je project. Er kan één Supabase-stack per project zijn. Zie Supabase op HostStuff.

Een web service, worker of cronjob kan ook een kant-en-klaar image draaien. Dat image moet uit de registry van HostStuff komen (in Amsterdam). Een image van elders, bijvoorbeeld van Docker Hub, haal je binnen met een build: een repository met alleen een Dockerfile met FROM <image>.

Variabele Waarde
HOSTSTUFF_PROJECT de ref van het project
HOSTSTUFF_SERVICE de naam van de service
PORT de poort (alleen web en statisch)

Services in hetzelfde project bereiken elkaar intern; andere projecten niet.