Kom i gang

Tjenester i et prosjekt: webtjenester, bakgrunnsprosesser og planlagte jobber.

Legg til bakgrunnsprosesser, planlagte jobber, flere webtjenester, databaser og Valkey i et prosjekt – fra egen kode, et annet repositorium eller et ferdig image – tilgjengelige via navn og på én faktura.

5 MIN LESING

Et prosjekt er mer enn én prosess. Ved siden av hovedapplikasjonen kan du kjøre en købehandler, en nattlig jobb, et separat API, en database – hver som en tjeneste med egne ressurser, alt på én faktura.

Tjenestene vises under applikasjonens Oversikt → Tjenester → Legg til en tjeneste. Et prosjekt kan ha opptil 10 tjenester. Hovedtjenesten må startes først, og prosjektets abonnement må være aktivt (prøveperioden teller).

Typer tjenester

TypeHva det er
Webtjenesteen annen nettside eller et API – med offentlig adresse eller bare intern
Bakgrunnsprosesskjører hele tiden: køer, Horizon, Celery, konsumenter
Planlagt jobbstarter etter en plan (cron-format, UTC), gjør jobben sin og stopper
PostgreSQL, MySQL, Valkeyadministrerte databaser – se Databaser
NATS, RabbitMQmeldingsmeglere for hendelser og køer, bare interne – se Hendelser og køer

Offentlig adresse eller bare intern

Når du legger til en webtjeneste, velger du hvordan den kan nås – ingenting er forhåndsvalgt:

  • Offentlig adresse – åpen fra internett på https://<name>.rivervo.app, og den kan ha dine egne domener.
  • Bare intern – ingen adresse på internett og ingen domener; bare de andre tjenestene i applikasjonen når den. Passer for et API bak nettsiden din, en administrasjonsbackend eller en søkemotor.

Bakgrunnsprosesser, planlagte jobber og databaser er aldri offentlige, så for dem er det ikke noe valg. Du kan endre dette senere under tjenestens Innstillinger → Offentlig adresse – se Kommunikasjon mellom tjenester.

Hvor koden kommer fra

Koden i dette prosjektet

Den samme koden, startet på en annen måte: en købehandler, en planlegger, en WebSocket-server (for eksempel Laravel Reverb), en mappe i et monorepo, et separat API.

  • Kommando er påkrevd – det tjenesten kjører, for eksempel php artisan queue:work eller node worker.js.
  • En webtjeneste må lytte på porten i $PORT.
  • En planlagt jobb trenger også en Plan i cron-format (UTC), for eksempel */5 * * * *.
  • Hver nye versjon av hovedtjenesten rulles også ut til disse tjenestene, så de kjører alltid den samme koden.

Et annet repositorium

En webtjeneste eller en bakgrunnsprosess fra et annet repositorium i den tilkoblede Git-kontoen din, med egen gren og ved behov Prosjektmappe og Bygge- og startkommandoer (la et felt stå tomt for å bruke det vi oppdager). Den får egne utrullinger og versjoner og ruller ut hver push til grenen sin. Forhåndsvisninger av grener lages ikke for tjenester ennå.

Et ferdig image

En webtjeneste eller en bakgrunnsprosess fra et ferdig image (Docker-image) på Docker Hub, GitHub Container Registry eller et hvilket som helst annet register – for eksempel nginx:1.27 eller ghcr.io/org/app:tag.

  • Port – porten imaget lytter på. Vi sender den også i $PORT.
  • Kommando – valgfritt; tomt felt starter imaget slik det er bygget.
  • Privat register – et brukernavn og et passord eller tilgangstoken. De lagres kryptert, brukes bare til å laste ned imaget og vises aldri igjen.
  • Med automatiske utrullinger slått på sjekker vi én gang i døgnet om taggen peker på en nyere versjon, og ruller den ut. Last ned imaget på nytt på fanen Utrullinger gjør det med en gang.

Kafka (mal)

Kafka under Legg til en tjeneste er en forhåndsinnstilling med ett klikk: den oppretter en tjeneste fra det offisielle Apache Kafka-imaget (3.9) – én enkelt megler i KRaft-modus, uten ZooKeeper. Den passer for utvikling og moderat last.

  • Bare intern – ingen offentlig adresse og ingen tilgang utenfra; bare applikasjonens tjenester når den.
  • Applikasjonens andre kodetjenester får KAFKA_BROKERS=<service name>:9092 og RIVERVO_<NAME>_URL=<service name>:9092.
  • Emner opprettes automatisk første gang de brukes.
  • Den starter med 1 GB minne · 1 CPU-kjerne · 10 GB disk. Som for alle tjenester fra et ferdig image kan du endre ressursene og variablene.
  • Dataene lagres i tjenestens datamappe på disken.

Dette har den ikke:

  • Én megler – ingen replikering; hvert emne har replikeringsfaktor 1.
  • Ingen administrerte Kafka-sikkerhetskopier. Den daglige sikkerhetskopien kopierer datamappen som filer mens Kafka kjører. Det er ikke en konsistent Kafka-sikkerhetskopi: etter en gjenoppretting kan nylige meldinger mangle, eller Kafka kan måtte gjenopprette loggene sine ved oppstart.
  • Ingen vedlikeholdstid, ingen tilgang utenfra og ikke noe Kafka-grensesnitt.
  • Oppgradering av Kafka må du gjøre selv: bytt image under tjenestens Innstillinger.

For køer og hendelser med sikkerhetskopier og tilkoblingsvariabler som settes opp for deg, se Hendelser og køer – NATS og RabbitMQ.

Kontakt via navn

Tjenestene i et prosjekt snakker sammen over et privat nettverk via navn: en tjeneste som heter api, nås fra de andre som api, en database som heter db, som db, og hovedtjenesten som web. Trafikk mellom tjenestene i et prosjekt telles ikke som trafikk.

Hver webtjeneste viser sin Interne adresse – for eksempel http://api:8080 – og de andre tjenestene får den i en variabel, RIVERVO_API_URL. Hvordan det fungerer, tjenester som bare er interne, flere instanser og tidsavbrudd: Kommunikasjon mellom tjenester.

Hver tjeneste får prosjektets variabler – inkludert databasetilkoblingen – pluss sine egne variabler, som går foran prosjektets. Se Miljøvariabler.

Ressurser og pris

Hver tjeneste har eget Minne, egen CPU og egen Disk, priset som enhver applikasjon: 72,16 kr per GB minne og 48,11 kr per CPU-kjerne i måneden, med 10 GB disk inkludert per GB minne, deretter 1,80 kr per GB. En tjeneste kan ha opptil 8 GB minne.

Når du legger til en tjeneste, legges prisen til prosjektets faktura – for inneværende måned bare den gjenværende delen. Mens prosjektet er i den gratis prøveperioden, er nye tjenester gratis til prøveperioden er over.

Oversikt viser Totalt for prosjektet – hva alle tjenestene i prosjektet koster til sammen i måneden.

Bakgrunnsprosesser i selve applikasjonen

Du trenger ikke alltid en egen tjeneste. Fanen Prosesser i hovedapplikasjonen har:

  • Bakgrunnsprosesser – opptil 5 langvarige prosesser ved siden av nettsiden, for eksempel en købehandler. De deler applikasjonens ressurser og starter på nytt ved hver utrulling.
  • Planlagte kommandoer – opptil 10 kommandoer etter en plan (cron-format, UTC). Utdataene ligger i loggen under Plan.
  • Konsoll – kjør en engangskommando i den kjørende applikasjonen, med dens variabler og database. En kommando kan kjøre i opptil 15 minutter. Interaktive kommandoer (tinker, et skall) støttes ikke her.

En egen tjeneste er det beste valget når en bakgrunnsprosess trenger egne ressurser, slik at en tung kø aldri gjør nettsiden treg.

Endre en tjeneste

Åpne tjenesten fra listen Tjenester. Under Innstillinger finner du kommandoen, planen, imaget eller grenen og ressursene. Endringene lagres, og tjenesten starter på nytt med dem. Hver tjeneste har også egne Logger og egen Overvåking.

Står du fast?

Chat med oss – AI svarer med en gang, og en tekniker kommer inn når det trengs, når som helst på døgnet.

Kontakt kundestøtte