Serviços de um projeto: serviços web, workers e tarefas agendadas.
Adicione workers em segundo plano, tarefas agendadas, outros serviços web, bancos de dados e Valkey a um projeto — a partir do próprio código, de outro repositório ou de uma imagem pronta —, acessíveis pelo nome e numa única fatura.
Um projeto é mais do que um processo. Ao lado da aplicação principal, você pode rodar um worker de fila, uma tarefa noturna, uma API separada, um banco de dados — cada um como um serviço com recursos próprios, tudo numa única fatura.
Os serviços ficam na aplicação, em Visão geral → Serviços → Adicionar serviço. Um projeto pode ter até 10 serviços. O serviço principal precisa ser lançado primeiro, e a assinatura do projeto precisa estar ativa (o teste grátis conta).
Tipos de serviço
| Tipo | O que é |
|---|---|
| Serviço web | outro site ou API — com endereço público ou somente interno |
| Worker em segundo plano | roda o tempo todo: filas, Horizon, Celery, consumidores |
| Tarefa agendada | inicia num horário (formato cron, UTC), faz o trabalho e para |
| PostgreSQL, MySQL, Valkey | bancos de dados gerenciados — veja Bancos de dados |
| NATS, RabbitMQ | brokers de mensagens para eventos e filas, somente internos — veja Eventos e filas |
Endereço público ou somente interno
Ao adicionar um serviço web, escolha como ele pode ser acessado — nada vem marcado de antemão:
- Endereço público — aberto na internet em
https://<name>.rivervo.app; pode ter domínios próprios. - Somente interno — sem endereço na internet e sem domínios; só os outros serviços da aplicação chegam até ele. Ideal para uma API por trás do seu site, um backend de administração ou um mecanismo de busca.
Workers em segundo plano, tarefas agendadas e bancos de dados nunca são públicos, então não há escolha para eles. Você pode mudar depois em Configurações do serviço → Endereço público — veja Comunicação entre serviços.
De onde vem o código
O código deste projeto
O mesmo código, iniciado de outro jeito: um worker de fila, um agendador, um servidor WebSocket (por exemplo, o Laravel Reverb), uma pasta de um monorepo, uma API separada.
- Comando é obrigatório — o que o serviço executa, por exemplo
php artisan queue:workounode worker.js. - Um serviço web precisa escutar na porta de
$PORT. - Uma tarefa agendada também precisa de um Agendamento no formato cron (UTC), por exemplo
*/5 * * * *. - Cada nova versão do serviço principal também vai para esses serviços no deploy, então eles sempre rodam o mesmo código.
Outro repositório
Um serviço web ou um worker em segundo plano a partir de outro repositório da sua conta Git conectada, com a própria branch e, se precisar, Pasta do projeto e Comandos de build e de início (deixe um campo vazio para usar o que detectarmos). Ele tem deploys e versões próprios e faz deploy de cada push na sua branch. Prévias de branches ainda não são criadas para serviços.
Uma imagem pronta
Um serviço web ou um worker em segundo plano a partir de uma imagem pronta (imagem Docker) no Docker Hub, no GitHub Container Registry ou em qualquer outro registry — por exemplo nginx:1.27 ou ghcr.io/org/app:tag.
- Porta — a porta em que a imagem escuta; também a passamos em
$PORT. - Comando — opcional; vazio, a imagem inicia do jeito que foi construída.
- Registry privado — um nome de usuário e uma senha ou token de acesso. Eles ficam guardados criptografados, são usados só para baixar a imagem e nunca mais são exibidos.
- Com os deploys automáticos ativados, verificamos uma vez por dia se a tag aponta para uma versão mais nova e fazemos o deploy dela. Baixar a imagem de novo, na aba Deploys, faz isso na hora.
Kafka (modelo)
O Kafka em Adicionar serviço é um modelo de um clique: ele cria um serviço a partir da imagem oficial do Apache Kafka (3.9) — um único broker em modo KRaft, sem ZooKeeper. Serve para desenvolvimento e cargas moderadas.
- Somente interno — sem endereço público e sem acesso de fora; só os serviços da aplicação chegam até ele.
- Os outros serviços de código da aplicação recebem
KAFKA_BROKERS=<service name>:9092eRIVERVO_<NAME>_URL=<service name>:9092. - Os tópicos são criados automaticamente no primeiro uso.
- Ele começa com 1 GB de memória · 1 núcleo de CPU · 10 GB de disco. Como em qualquer serviço de imagem pronta, você pode mudar os recursos e as variáveis.
- Os dados ficam na pasta de dados do serviço, no disco dele.
O que ele não tem:
- Um único broker — sem replicação; todo tópico tem fator de replicação 1.
- Sem backups gerenciados do Kafka. O backup diário copia a pasta de dados como arquivos enquanto o Kafka roda. Isso não é um backup consistente do Kafka: depois de uma restauração, mensagens recentes podem faltar, ou o Kafka pode precisar recuperar os logs ao iniciar.
- Sem janela de manutenção, sem acesso de fora e sem interface do Kafka.
- Atualizar o Kafka fica por sua conta: troque a imagem em Configurações do serviço.
Para filas e eventos com backups e variáveis de conexão já configurados para você, veja Eventos e filas — NATS e RabbitMQ.
Acesso de um serviço ao outro pelo nome
Os serviços de um projeto conversam numa rede privada pelo nome: um serviço chamado api é acessível pelos outros como api, um banco chamado db como db, e o serviço principal como web. O tráfego entre os serviços de um projeto não conta como tráfego.
Cada serviço web mostra o seu Endereço interno — por exemplo http://api:8080 — e os outros serviços o recebem numa variável, RIVERVO_API_URL. Como funciona, serviços somente internos, várias instâncias e timeouts: Comunicação entre serviços.
Cada serviço recebe as variáveis do projeto — inclusive a conexão com o banco de dados — e mais variáveis próprias, que têm prioridade sobre as do projeto. Veja Variáveis de ambiente.
Recursos e preço
Cada serviço tem a própria Memória, CPU e Disco, com o mesmo preço de qualquer aplicação: R$ 34,76 por GB de memória e R$ 23,17 por núcleo de CPU por mês, com 10 GB de disco incluídos por GB de memória, e depois R$ 0,87 por GB. Um serviço pode ter até 8 GB de memória.
Quando você adiciona um serviço, o preço dele entra na fatura do projeto — no mês atual, só a parte que falta. Enquanto o projeto está no teste grátis, os novos serviços são gratuitos até o fim do teste.
A Visão geral mostra o Total do projeto — quanto todos os serviços do projeto custam juntos por mês.
Workers dentro da própria aplicação
Nem sempre você precisa de um serviço separado. A aba Processos da aplicação principal tem:
- Workers em segundo plano — até 5 processos de longa duração ao lado do site, por exemplo um worker de fila. Eles dividem os recursos da aplicação e reiniciam a cada deploy.
- Comandos agendados — até 10 comandos num horário (formato cron, UTC). A saída deles fica no log, em Agendamento.
- Console — rode um comando avulso dentro da aplicação em execução, com as variáveis e o banco de dados dela. Um comando pode rodar por até 15 minutos; comandos interativos (tinker, um shell) não funcionam aqui.
Um serviço separado é a melhor escolha quando um worker precisa de recursos próprios, para que uma fila pesada nunca deixe o site lento.
Como alterar um serviço
Abra o serviço na lista Serviços. Em Configurações ficam o comando, o agendamento, a imagem ou a branch e os recursos; as mudanças são salvas e o serviço reinicia com elas. Cada serviço também tem os próprios Logs e Monitoramento.