Começar

Serviços de um projeto: serviços web, workers e tarefas agendadas.

Acrescente workers em segundo plano, tarefas agendadas, outros serviços web, bases 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 só fatura.

6 MIN DE LEITURA

Um projeto é mais do que um processo. Ao lado da aplicação principal pode correr um worker de filas, uma tarefa noturna, uma API separada, uma base de dados — cada um como serviço com os seus próprios recursos, tudo numa só fatura.

Os serviços aparecem na aplicação em Visão geral → Serviços → Adicionar um serviço. Um projeto pode ter até 10 serviços. O serviço principal tem de ser lançado primeiro e a subscrição do projeto tem de estar ativa (o período de teste conta).

Tipos de serviços

TipoO que é
Serviço weboutro site ou API — com endereço público ou apenas interno
Worker em segundo planocorre sempre: filas, Horizon, Celery, consumidores
Tarefa agendadaarranca segundo um agendamento (formato cron, UTC), faz o seu trabalho e para
PostgreSQL, MySQL, Valkeybases de dados geridas — consulte Bases de dados
NATS, RabbitMQmessage brokers para eventos e filas, apenas internos — consulte Eventos e filas

Endereço público ou apenas interno

Ao adicionar um serviço web, escolha como pode ser acedido — nada vem selecionado à partida:

  • Endereço público — acessível a partir da internet em https://<name>.rivervo.app; pode ter os seus próprios domínios.
  • Apenas interno — sem endereço na internet e sem domínios; só os outros serviços da aplicação chegam até ele. Indicado para uma API por trás do seu site, um backend de administração ou um motor de pesquisa.

Os workers em segundo plano, as tarefas agendadas e as bases de dados nunca são públicos, por isso não há escolha para eles. Pode alterar a opção mais tarde em Definições → Endereço público do serviço — consulte Comunicação entre serviços.

De onde vem o código

O código deste projeto

O mesmo código arrancado de outra forma: um worker de filas, um agendador, um servidor WebSocket (por exemplo, o Laravel Reverb), uma pasta de um monorepo, uma API separada.

  • O Comando é obrigatório — o que o serviço executa, por exemplo php artisan queue:work ou node worker.js.
  • Um serviço web tem de escutar na porta indicada em $PORT.
  • Uma tarefa agendada precisa também de um Agendamento em formato cron (UTC), por exemplo */5 * * * *.
  • Cada nova versão do serviço principal é publicada também nestes serviços, por isso correm sempre 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 ligada, com o seu próprio branch e, se necessário, Pasta do projeto e Comandos de compilação e arranque (deixe um campo vazio para usar o que detetamos). Tem as suas próprias publicações e versões e publica cada push para o seu branch. Ainda não são feitas pré-visualizações de branches 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 registo — 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 arranca tal como foi construída.
  • Registo privado — um nome de utilizador e uma palavra-passe ou token de acesso. São guardados encriptados, usados apenas para descarregar a imagem e nunca mais mostrados.
  • Com as publicações automáticas ativas, verificamos uma vez por dia se a tag aponta para uma versão mais recente e publicamo-la. Descarregar a imagem de novo, no separador Publicações, fá-lo de imediato.

Kafka (modelo)

O Kafka em Adicionar um serviço é uma predefinição de um clique: 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.

  • Apenas interno — sem endereço público e sem acesso a partir do exterior; 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>:9092 e RIVERVO_<NAME>_URL=<service name>:9092.
  • Os tópicos são criados automaticamente na primeira vez que são usados.
  • Começa com 1 GB de memória · 1 núcleo de CPU · 10 GB de disco. Como em qualquer serviço a partir de uma imagem pronta, pode alterar os recursos e as variáveis.
  • Os dados ficam na pasta de dados do serviço, no respetivo disco.

O que não tem:

  • Um só broker — sem replicação; cada tópico tem um fator de replicação de 1.
  • Sem backups geridos do Kafka. O backup diário copia a pasta de dados como ficheiros enquanto o Kafka está a correr. Não é um backup consistente do Kafka: depois de um restauro podem faltar mensagens recentes, ou o Kafka pode ter de recuperar os seus logs ao arrancar.
  • Sem janela de manutenção, sem acesso a partir do exterior e sem interface do Kafka.
  • A atualização do Kafka fica a seu cargo: altere a imagem em Definições do serviço.

Para filas e eventos com backups e variáveis de ligação já configuradas, consulte Eventos e filas — NATS e RabbitMQ.

Comunicar pelo nome

Os serviços de um projeto comunicam numa rede privada pelo nome: um serviço chamado api é acessível pelos outros como api, uma base de dados chamada 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 recebem-no numa variável, RIVERVO_API_URL. Como funciona, serviços apenas internos, várias instâncias e tempos limite: Comunicação entre serviços.

Cada serviço recebe as variáveis do projeto — incluindo a ligação à base de dados — e ainda as suas próprias variáveis, que prevalecem sobre as do projeto. Consulte Variáveis de ambiente.

Recursos e preço

Cada serviço tem a sua própria Memória, CPU e Disco, com o mesmo preço de qualquer aplicação: € 6,72 por GB de memória e € 4,48 por núcleo de CPU por mês, com 10 GB de disco incluídos por cada GB de memória e, a partir daí, € 0,17 por GB. Um serviço pode ter até 8 GB de memória.

Quando adiciona um serviço, o preço dele é somado à fatura do projeto — no mês em curso, apenas a parte que falta. Enquanto o projeto está no período de teste gratuito, os novos serviços são gratuitos até o teste terminar.

A Visão geral mostra o Total do projeto — quanto custam, juntos, todos os serviços do projeto por mês.

Workers dentro da própria aplicação

Nem sempre precisa de um serviço separado. O separador 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 filas. Partilham os recursos da aplicação e reiniciam a cada publicação.
  • Comandos agendados — até 10 comandos segundo um agendamento (formato cron, UTC). O resultado aparece no log em Agendamento.
  • Consola — execute um comando pontual dentro da aplicação em execução, com as variáveis e a base de dados dela. Um comando pode correr até 15 minutos; os comandos interativos (tinker, uma shell) não são suportados aqui.

Um serviço separado é a melhor opção quando um worker precisa dos seus próprios recursos, para que uma fila pesada nunca torne o site mais lento.

Alterar um serviço

Abra o serviço na lista Serviços. As Definições dele guardam o comando, o agendamento, a imagem ou o branch, e os recursos; as alterações são guardadas e o serviço reinicia com elas. Cada serviço tem também os seus próprios Logs e Monitorização.

Ainda com dúvidas?

Fale connosco por chat — a AI responde de imediato e um engenheiro entra quando for preciso, a qualquer hora.

Contactar o suporte