Kom igång

Tjänster i ett projekt: webbtjänster, bakgrundsprocesser och schemalagda jobb.

Lägg till bakgrundsprocesser, schemalagda jobb, fler webbtjänster, databaser och Valkey i ett projekt – från projektets egen kod, ett annat repo eller en färdig image – nåbara via namn och på en faktura.

5 MIN LÄSNING

Ett projekt är mer än en process. Bredvid huvudapplikationen kan du köra en köprocess, ett nattligt jobb, ett separat API, en databas – var och en som en tjänst med egna resurser, allt på en faktura.

Tjänsterna listas under applikationens Översikt → Tjänster → Lägg till en tjänst. Ett projekt kan ha upp till 10 tjänster. Huvudtjänsten måste ha startats först, och projektets abonnemang måste vara aktivt (provperioden räknas).

Typer av tjänster

TypVad det är
Webbtjänsten annan sajt eller ett API – med en publik adress eller endast intern
Bakgrundsprocesskörs hela tiden: köer, Horizon, Celery, konsumenter
Schemalagt jobbstartar enligt ett schema (cron-format, UTC), gör sitt arbete och stoppar
PostgreSQL, MySQL, Valkeyhanterade databaser – se Databaser
NATS, RabbitMQmeddelandeförmedlare för händelser och köer, endast interna – se Händelser och köer

Publik adress eller endast intern

När du lägger till en webbtjänst väljer du hur den ska nås – inget är förvalt:

  • Publik adress – öppen från internet på https://<name>.rivervo.app; den kan ha egna domäner.
  • Endast intern – ingen adress på internet och inga domäner; bara applikationens andra tjänster når den. Passar för ett API bakom din sajt, en admin-backend eller en sökmotor.

Bakgrundsprocesser, schemalagda jobb och databaser är aldrig publika, så för dem finns inget val. Du kan ändra det senare under tjänstens Inställningar → Publik adress – se Kommunikation mellan tjänster.

Var koden kommer ifrån

Projektets egen kod

Samma kod startad på ett annat sätt: en köprocess, en schemaläggare, en WebSocket-server (till exempel Laravel Reverb), en mapp i ett monorepo, ett separat API.

  • Kommando är obligatoriskt – det som tjänsten kör, t.ex. php artisan queue:work eller node worker.js.
  • En webbtjänst måste lyssna på porten i $PORT.
  • Ett schemalagt jobb behöver även ett Schema i cron-format (UTC), t.ex. */5 * * * *.
  • Varje ny version av huvudtjänsten driftsätts även till dessa tjänster, så de kör alltid samma kod.

Ett annat repo

En webbtjänst eller en bakgrundsprocess från ett annat repo i ditt anslutna Git-konto, med egen gren och vid behov Projektmapp och Bygg- och startkommandon (lämna ett fält tomt för att använda det vi identifierar). Den får egna driftsättningar och versioner och driftsätter varje push till sin gren. Förhandsvisningar av grenar skapas inte för tjänster ännu.

En färdig image

En webbtjänst eller en bakgrundsprocess från en färdig image (Docker-image) på Docker Hub, GitHub Container Registry eller något annat register – till exempel nginx:1.27 eller ghcr.io/org/app:tag.

  • Port – porten som imagen lyssnar på; vi skickar den även i $PORT.
  • Kommando – valfritt; tomt startar imagen så som den är byggd.
  • Privat register – ett användarnamn och ett lösenord eller en åtkomsttoken. De lagras krypterade, används bara för att hämta imagen och visas aldrig igen.
  • Med automatiska driftsättningar påslagna kontrollerar vi en gång om dagen om taggen pekar på en nyare version och driftsätter den. Hämta imagen igen på fliken Driftsättningar gör det direkt.

Kafka (mall)

Kafka under Lägg till en tjänst är en förinställning med ett klick: den skapar en tjänst från den officiella Apache Kafka-imagen (3.9) – en enda broker i KRaft-läge, utan ZooKeeper. Den passar för utveckling och måttlig belastning.

  • Endast intern – ingen publik adress och ingen åtkomst utifrån; bara applikationens tjänster når den.
  • Applikationens andra kodtjänster får KAFKA_BROKERS=<service name>:9092 och RIVERVO_<NAME>_URL=<service name>:9092.
  • Topics skapas automatiskt första gången de används.
  • Den startar med 1 GB minne · 1 CPU-kärna · 10 GB disk. Som för alla tjänster från en färdig image kan du ändra resurser och variabler.
  • Dess data sparas i tjänstens datamapp på dess disk.

Det här ingår inte:

  • En broker – ingen replikering; varje topic har replikeringsfaktor 1.
  • Inga hanterade Kafka-säkerhetskopior. Den dagliga backupen kopierar datamappen som filer medan Kafka körs. Det är ingen konsekvent Kafka-backup: efter en återställning kan de senaste meddelandena saknas, eller så kan Kafka behöva återställa sina loggar vid start.
  • Ingen underhållstid, ingen åtkomst utifrån och inget Kafka-gränssnitt.
  • Att uppgradera Kafka sköter du själv: byt image i tjänstens Inställningar.

För köer och händelser med säkerhetskopior och anslutningsvariabler som sätts åt dig, se Händelser och köer – NATS och RabbitMQ.

Nå varandra via namn

Tjänsterna i ett projekt pratar över ett privat nätverk via namn: en tjänst som heter api nås från de andra som api, en databas som heter db som db, och huvudtjänsten som web. Trafik mellan tjänsterna i ett projekt räknas inte som trafik.

Varje webbtjänst visar sin Interna adress – till exempel http://api:8080 – och de andra tjänsterna får den i en variabel, RIVERVO_API_URL. Hur det fungerar, endast interna tjänster, flera instanser och tidsgränser: Kommunikation mellan tjänster.

Varje tjänst får projektets variabler – inklusive databasanslutningen – plus egna variabler, som går före projektets. Se Miljövariabler.

Resurser och pris

Varje tjänst har eget Minne, egen CPU och egen Disk, prissatta som för alla applikationer: 75,92 kr per GB minne och 50,61 kr per CPU-kärna och månad, med 10 GB disk inkluderat per GB minne, därefter 1,90 kr per GB. En tjänst kan ha upp till 8 GB minne.

När du lägger till en tjänst läggs dess pris till projektets faktura – för innevarande månad bara den återstående delen. Medan projektet har sin gratis provperiod är nya tjänster gratis tills provperioden slutar.

Översikt visar Totalt för projektet – vad alla tjänster i projektet kostar tillsammans per månad.

Bakgrundsprocesser i själva applikationen

Du behöver inte alltid en separat tjänst. Huvudapplikationens flik Processer har:

  • Bakgrundsprocesser – upp till 5 långvariga processer bredvid sajten, t.ex. en köprocess. De delar applikationens resurser och startas om vid varje driftsättning.
  • Schemalagda kommandon – upp till 10 kommandon enligt ett schema (cron-format, UTC). Deras utdata finns i loggen under Schema.
  • Konsol – kör ett engångskommando i den körande applikationen, med dess variabler och databas. Ett kommando kan köras i upp till 15 minuter; interaktiva kommandon (tinker, ett skal) stöds inte här.

En separat tjänst är ett bättre val när en bakgrundsprocess behöver egna resurser, så att en tung kö aldrig gör sajten långsammare.

Ändra en tjänst

Öppna tjänsten från listan Tjänster. Dess Inställningar innehåller kommando, schema, image eller gren samt resurser; ändringarna sparas och tjänsten startas om med dem. Varje tjänst har också egna Loggar och egen Övervakning.

Fortfarande fast?

Chatta med oss — AI svarar direkt och en tekniker kopplas in vid behov, när som helst på dygnet.

Kontakta supporten