Inizia ora

Servizi di un progetto: servizi web, worker e attività pianificate.

Aggiungi a un progetto worker in background, attività pianificate, altri servizi web, database e Valkey, dal suo codice, da un altro repository o da un'immagine pronta, raggiungibili per nome e in un'unica fattura.

6 MIN DI LETTURA

Un progetto è più di un singolo processo. Accanto all'applicazione principale puoi far girare un worker per le code, un job notturno, un'API separata, un database: ognuno come servizio con risorse proprie, tutti in un'unica fattura.

I servizi sono elencati nella Panoramica dell'applicazione → Servizi → Aggiungi un servizio. Un progetto può avere fino a 10 servizi. Il servizio principale deve essere avviato per primo e l'abbonamento del progetto deve essere attivo (la prova gratuita conta).

Tipi di servizio

TipoChe cos'è
Servizio webun altro sito o un'API, con indirizzo pubblico o solo interno
Worker in backgroundgira sempre: code, Horizon, Celery, consumer
Attività pianificataparte secondo una pianificazione (formato cron, UTC), fa il suo lavoro e si ferma
PostgreSQL, MySQL, Valkeydatabase gestiti: vedi Database
NATS, RabbitMQmessage broker per eventi e code, solo interni: vedi Eventi e code

Indirizzo pubblico o solo interno

Quando aggiungi un servizio web, scegli come si può raggiungere; non c'è nulla di preselezionato:

  • Indirizzo pubblico: raggiungibile da internet su https://<name>.rivervo.app; può avere i tuoi domini.
  • Solo interno: nessun indirizzo su internet e nessun dominio; lo raggiungono solo gli altri servizi dell'applicazione. Adatto a un'API dietro il tuo sito, a un backend di amministrazione o a un motore di ricerca.

Worker in background, attività pianificate e database non sono mai pubblici, quindi per loro non c'è scelta. Puoi cambiarlo in seguito in Impostazioni del servizio → Indirizzo pubblico: vedi Comunicazione tra servizi.

Da dove arriva il codice

Il codice di questo progetto

Lo stesso codice avviato in un altro modo: un worker per le code, uno scheduler, un server WebSocket (ad esempio Laravel Reverb), una cartella di un monorepo, un'API separata.

  • Comando è obbligatorio: cosa esegue il servizio, ad esempio php artisan queue:work o node worker.js.
  • Un servizio web deve restare in ascolto sulla porta indicata in $PORT.
  • Un'attività pianificata ha bisogno anche di una Pianificazione in formato cron (UTC), ad esempio */5 * * * *.
  • Ogni nuova versione del servizio principale viene pubblicata anche su questi servizi, così eseguono sempre lo stesso codice.

Un altro repository

Un servizio web o un worker in background da un altro repository del tuo account Git collegato, con il suo branch e, se serve, Cartella del progetto e Comandi di build e avvio (lascia vuoto un campo per usare quello che rileviamo). Ha i suoi deploy e le sue versioni e pubblica ogni push sul suo branch. Le anteprime dei branch per i servizi non sono ancora disponibili.

Un'immagine pronta

Un servizio web o un worker in background da un'immagine pronta (immagine Docker) su Docker Hub, GitHub Container Registry o qualsiasi altro registry, ad esempio nginx:1.27 o ghcr.io/org/app:tag.

  • Porta: la porta su cui ascolta l'immagine; la passiamo anche in $PORT.
  • Comando: facoltativo; se è vuoto, l'immagine parte come è stata costruita.
  • Registry privato: un nome utente e una password o un token di accesso. Vengono conservati cifrati, usati solo per scaricare l'immagine e non vengono più mostrati.
  • Con i deploy automatici attivi, controlliamo una volta al giorno se il tag punta a una versione più recente e la pubblichiamo. Scarica di nuovo l'immagine nella scheda Deploy lo fa subito.

Kafka (modello)

Kafka in Aggiungi un servizio è un preset con un clic: crea un servizio dall'immagine ufficiale di Apache Kafka (3.9), un singolo broker in modalità KRaft, senza ZooKeeper. È adatto allo sviluppo e a carichi moderati.

  • Solo interno: nessun indirizzo pubblico e nessun accesso dall'esterno; lo raggiungono solo i servizi dell'applicazione.
  • Gli altri servizi con codice dell'applicazione ricevono KAFKA_BROKERS=<service name>:9092 e RIVERVO_<NAME>_URL=<service name>:9092.
  • I topic vengono creati automaticamente al primo utilizzo.
  • Parte con 1 GB di memoria · 1 core CPU · 10 GB di disco. Come per ogni servizio da immagine pronta, puoi cambiarne risorse e variabili.
  • I dati vengono conservati nella cartella dati del servizio, sul suo disco.

Cosa non ha:

  • Un solo broker: nessuna replica; ogni topic ha fattore di replica 1.
  • Nessun backup Kafka gestito. Il backup giornaliero copia la sua cartella dati come file mentre Kafka è in esecuzione. Non è un backup Kafka coerente: dopo un ripristino possono mancare i messaggi recenti, oppure Kafka potrebbe dover recuperare i suoi log all'avvio.
  • Nessuna finestra di manutenzione, nessun accesso dall'esterno e nessuna interfaccia Kafka.
  • L'aggiornamento di Kafka spetta a te: cambia l'immagine in Impostazioni del servizio.

Per code ed eventi con backup e variabili di connessione già configurati, vedi Eventi e code: NATS e RabbitMQ.

Raggiungersi per nome

I servizi di un progetto comunicano su una rete privata usando il nome: un servizio chiamato api è raggiungibile dagli altri come api, un database chiamato db come db e il servizio principale come web. Il traffico tra i servizi di un progetto non viene conteggiato come traffico.

Ogni servizio web mostra il suo Indirizzo interno, ad esempio http://api:8080, e gli altri servizi lo ricevono in una variabile, RIVERVO_API_URL. Come funziona, servizi solo interni, più istanze e timeout: Comunicazione tra servizi.

Ogni servizio riceve le variabili del progetto, compresa la connessione al database, più le sue variabili, che prevalgono su quelle del progetto. Vedi Variabili d'ambiente.

Risorse e prezzo

Ogni servizio ha la sua Memoria, CPU e Disco, con lo stesso prezzo di qualsiasi applicazione: 6,65 € per GB di memoria e 4,44 € per core CPU al mese, con 10 GB di disco inclusi per ogni GB di memoria, poi 0,17 € per GB. Un servizio può avere fino a 8 GB di memoria.

Quando aggiungi un servizio, il suo prezzo viene aggiunto alla fattura del progetto; per il mese in corso solo la parte rimanente. Mentre il progetto è in prova gratuita, i nuovi servizi sono gratuiti fino alla fine della prova.

La Panoramica mostra il Totale del progetto: quanto costano al mese tutti i servizi del progetto insieme.

Worker dentro l'applicazione stessa

Non sempre serve un servizio separato. La scheda Processi dell'applicazione principale offre:

  • Worker in background: fino a 5 processi sempre attivi accanto al sito, ad esempio un worker per le code. Condividono le risorse dell'applicazione e si riavviano a ogni deploy.
  • Comandi pianificati: fino a 10 comandi secondo una pianificazione (formato cron, UTC). Il loro output è nel log, sotto Pianificazione.
  • Console: esegui un comando una tantum dentro l'applicazione in esecuzione, con le sue variabili e il suo database. Un comando può durare fino a 15 minuti; i comandi interattivi (tinker, una shell) qui non sono supportati.

Un servizio separato è la scelta migliore quando un worker ha bisogno di risorse proprie, così una coda pesante non rallenta mai il sito.

Modificare un servizio

Apri il servizio dall'elenco Servizi. Le sue Impostazioni contengono comando, pianificazione, immagine o branch e le risorse; le modifiche vengono salvate e il servizio si riavvia con esse. Ogni servizio ha anche i suoi Log e il suo Monitoraggio.

Hai ancora dubbi?

Scrivici in chat: l'AI risponde subito e un tecnico si unisce quando serve, a qualsiasi ora.

Contatta l'assistenza