Kom i gang

Et projekts tjenester: webtjenester, baggrundsprocesser og planlagte job.

Tilføj baggrundsprocesser, planlagte job, flere webtjenester, databaser og Valkey til et projekt – fra dets egen kode, et andet repositorium eller et færdigt image – tilgængelige via navn og på én regning.

5 MIN. LÆSNING

Et projekt er mere end én proces. Ved siden af hovedapplikationen kan du køre en køproces, et natligt job, et separat API, en database – hver som en tjeneste med egne ressourcer, alt på én regning.

Tjenester findes under applikationens Oversigt → Tjenester → Tilføj en tjeneste. Et projekt kan have op til 10 tjenester. Hovedtjenesten skal være startet først, og projektets abonnement skal være aktivt (prøveperioden tæller med).

Typer af tjenester

TypeHvad det er
Webtjenesteendnu en side eller et API – med offentlig adresse eller kun intern
Baggrundsproceskører hele tiden: køer, Horizon, Celery, consumers
Planlagt jobstarter efter en plan (cron-format, UTC), udfører sit arbejde og stopper
PostgreSQL, MySQL, Valkeyadministrerede databaser – se Databaser
NATS, RabbitMQmessage brokers til hændelser og køer, kun interne – se Hændelser og køer

Offentlig adresse eller kun intern

Når du tilføjer en webtjeneste, vælger du, hvordan den kan nås – intet er valgt på forhånd:

  • Offentlig adresse – åben fra internettet på https://<name>.rivervo.app; den kan have dine egne domæner.
  • Kun intern – ingen adresse på internettet og ingen domæner; kun applikationens andre tjenester kan nå den. Velegnet til et API bag din side, en admin-backend eller en søgemaskine.

Baggrundsprocesser, planlagte job og databaser er aldrig offentlige, så der er intet valg for dem. Du kan ændre det senere under tjenestens Indstillinger → Offentlig adresse – se Kommunikation mellem tjenester.

Hvor koden kommer fra

Dette projekts kode

Den samme kode startet på en anden måde: en køproces, en scheduler, en WebSocket-server (for eksempel Laravel Reverb), en mappe i et monorepo, et separat API.

  • Kommando er påkrævet – hvad tjenesten kører, f.eks. php artisan queue:work eller node worker.js.
  • En webtjeneste skal lytte på porten i $PORT.
  • Et planlagt job skal også have en Plan i cron-format (UTC), f.eks. */5 * * * *.
  • Hver ny version af hovedtjenesten deployes også til disse tjenester, så de altid kører den samme kode.

Et andet repositorium

En webtjeneste eller en baggrundsproces fra et andet repositorium på din forbundne Git-konto, med sin egen branch og om nødvendigt Projektmappe og Build- og startkommandoer (lad et felt stå tomt for at bruge det, vi finder). Den får sine egne deploys og versioner og deployer hver push til sin branch. Branch-forhåndsvisninger laves endnu ikke for tjenester.

Et færdigt image

En webtjeneste eller en baggrundsproces fra et færdigt image (Docker-image) på Docker Hub, GitHub Container Registry eller et andet registry – for eksempel nginx:1.27 eller ghcr.io/org/app:tag.

  • Port – den port, imaget lytter på; vi sender den også i $PORT.
  • Kommando – valgfri; tom starter imaget, som det er bygget til.
  • Privat registry – et brugernavn og en adgangskode eller et adgangstoken. De gemmes krypteret, bruges kun til at hente imaget og vises aldrig igen.
  • Med automatiske deploys slået til tjekker vi én gang om dagen, om tagget peger på en nyere version, og deployer den. Hent imaget igen på fanen Deploys gør det med det samme.

Kafka (skabelon)

Kafka under Tilføj en tjeneste er en forudindstilling med ét klik: den opretter en tjeneste fra det officielle Apache Kafka-image (3.9) – en enkelt broker i KRaft-tilstand uden ZooKeeper. Den passer til udvikling og moderat belastning.

  • Kun intern – ingen offentlig adresse og ingen adgang udefra; kun applikationens tjenester kan nå den.
  • Applikationens andre kodetjenester får KAFKA_BROKERS=<service name>:9092 og RIVERVO_<NAME>_URL=<service name>:9092.
  • Topics oprettes automatisk, første gang de bruges.
  • Den starter med 1 GB hukommelse · 1 CPU-kerne · 10 GB disk. Som enhver tjeneste fra et færdigt image kan du ændre dens ressourcer og variabler.
  • Dens data gemmes i tjenestens datamappe på dens disk.

Det har den ikke:

  • Én broker – ingen replikering; hvert topic har replikeringsfaktor 1.
  • Ingen administrerede Kafka-backups. Den daglige backup kopierer datamappen som filer, mens Kafka kører. Det er ikke en konsistent Kafka-backup: efter en gendannelse kan de seneste beskeder mangle, eller Kafka kan skulle gendanne sine logs, når den starter.
  • Intet vedligeholdelsesvindue, ingen adgang udefra og ingen Kafka-brugerflade.
  • Opgradering af Kafka står du selv for: skift imaget under tjenestens Indstillinger.

Til køer og hændelser med backups og forbindelsesvariabler sat op for dig, se Hændelser og køer – NATS og RabbitMQ.

Tjenester når hinanden via navn

Et projekts tjenester taler sammen over et privat netværk via navn: en tjeneste ved navn api kan nås fra de andre som api, en database ved navn db som db og hovedtjenesten som web. Trafik mellem et projekts tjenester tælles ikke som trafik.

Hver webtjeneste viser sin Interne adresse – for eksempel http://api:8080 – og de andre tjenester får den i en variabel, RIVERVO_API_URL. Hvordan det virker, kun interne tjenester, flere instanser og timeouts: Kommunikation mellem tjenester.

Hver tjeneste får projektets variabler – inklusive databaseforbindelsen – plus sine egne variabler, som går forud for projektets. Se Miljøvariabler.

Ressourcer og pris

Hver tjeneste har sin egen Hukommelse, CPU og Disk, prissat som enhver applikation: 50,95 kr. pr. GB hukommelse og 33,96 kr. pr. CPU-kerne om måneden, med 10 GB disk inkluderet pr. GB hukommelse, derefter 1,27 kr. pr. GB. En tjeneste kan have op til 8 GB hukommelse.

Når du tilføjer en tjeneste, lægges dens pris til projektets regning – for den aktuelle måned kun for den resterende del. Mens projektet er i sin gratis prøveperiode, er nye tjenester gratis, indtil prøveperioden slutter.

Oversigt viser Projekt i alt – hvad alle projektets tjenester koster tilsammen om måneden.

Processer i selve applikationen

Du har ikke altid brug for en separat tjeneste. Hovedapplikationens fane Processer har:

  • Baggrundsprocesser – op til 5 langvarige processer ved siden af siden, f.eks. en køproces. De deler applikationens ressourcer og genstarter ved hver deploy.
  • Planlagte kommandoer – op til 10 kommandoer efter en plan (cron-format, UTC). Deres output står i loggen under Plan.
  • Konsol – kør en enkeltstående kommando inde i den kørende applikation med dens variabler og database. En kommando kan køre i op til 15 minutter; interaktive kommandoer (tinker, en shell) understøttes ikke her.

En separat tjeneste er det bedre valg, når en proces skal have egne ressourcer, så en tung kø aldrig gør siden langsom.

Ændr en tjeneste

Åbn tjenesten fra listen Tjenester. Dens Indstillinger indeholder kommando, plan, image eller branch og ressourcer; ændringer gemmes, og tjenesten genstarter med dem. Hver tjeneste har også sine egne Logs og Overvågning.

Sidder du stadig fast?

Chat med os — AI svarer med det samme, og en tekniker kommer på, når der er brug for det, uanset tidspunktet.

Kontakt support