Começar

Deploys, pré-visualizações e reversões.

Como os pushes chegam à produção, pré-visualizações de ramos, voltar a uma versão anterior, o comando de release para migrações, definições de build, hooks de deploy, modo de manutenção e palavras-passe das pré-visualizações.

5 MIN DE LEITURA

Quando uma aplicação já está publicada, raramente precisa do painel para lançar alterações: faça push para o ramo e a nova versão fica disponível sozinha. Este artigo trata de tudo o que está à volta disso — o separador Deploys, as Pré-visualizações, o separador Processos e alguns interruptores em Definições.

Deploys automáticos a cada push

Cada push para o ramo da aplicação faz o build do commit mais recente e publica-o. A nova versão arranca ao lado da que está a funcionar e só recebe visitantes quando responder; se não arrancar, a versão anterior continua a funcionar e avisamos por email (e por Telegram, se o tiver ligado).

Um push feito enquanto outro build ainda aguarda na fila junta-se a esse build, por isso uma série de pushes seguidos não cria uma fila longa.

Pode desativar isto em Definições → Deploy a cada push. Com a opção desativada, faz o deploy a partir do painel, da API ou de um hook de deploy.

Fazer deploy a partir do painel

O separador Deploys lista todos os deploys: o que os iniciou (um push, o painel, uma reversão, um hook de deploy), o commit, quanto tempo demoraram e o estado. Clique num deploy para ver o registo completo do build.

Novo deploy oferece duas opções:

  • Fazer o build do commit mais recente — vai buscar o código mais recente do ramo e faz o build.
  • Voltar a publicar a versão atual — aplica as variáveis alteradas, sem novo build. Use-a depois de editar as Variáveis.

O menu junto a Abrir tem as mesmas duas ações e ainda Reiniciar.

Reverter

Pode voltar a qualquer uma das últimas 5 versões bem-sucedidas. No separador Deploys, clique em Reverter na versão pretendida e confirme. A versão anterior arranca ao lado da atual e assume o lugar dela quando responder — não há novo build.

Uma reversão não desfaz as alterações na base de dados. Se uma versão alterou a estrutura da base de dados, restaure também a base de dados — consulte Bases de dados.

Pré-visualizações de ramos

Um push para qualquer outro ramo recebe a sua própria pré-visualização — um endereço separado onde pode verificar as alterações antes de chegarem à produção. Abra-as no separador Pré-visualizações.

  • Até 3 pré-visualizações em simultâneo, incluídas no preço.
  • Uma pré-visualização sem novos pushes durante 7 dias é removida. Volta a ser criada no push seguinte para esse ramo.
  • As pré-visualizações recebem apenas as variáveis destinadas a elas — consulte Variáveis de ambiente.
  • As pré-visualizações são criadas para o serviço principal de um projeto, não para os outros serviços.

Uma palavra-passe para as pré-visualizações

No separador Pré-visualizações, Palavra-passe das pré-visualizações → Pedir palavra-passe. Introduza um nome de utilizador e uma palavra-passe (pelo menos 8 caracteres). A partir daí, só quem tiver a palavra-passe pode abrir as pré-visualizações; a aplicação continua aberta a todos.

O comando de release (migrações)

Separador Processos → Comando de release. Corre uma vez em cada deploy, antes de a nova versão receber visitantes — normalmente as migrações da base de dados. Se falhar, o deploy para e a versão atual continua a funcionar, por isso uma migração com erros nunca chega aos seus visitantes.

Sugerimos um comando para as frameworks que o têm:

FrameworkComando de release recomendado
Laravelphp artisan migrate --force
Djangopython manage.py migrate --noinput
Prisma (Node.js)npx prisma migrate deploy

Usar o comando recomendado mantém-no; também pode introduzir o seu ou escolher Nenhum. As alterações aplicam-se a partir do deploy seguinte.

Definições de build

Definições → Definições de build permite alterar o que detetámos:

  • Comando de instalação — por exemplo, npm ci
  • Comando de build — por exemplo, npm run build
  • Comando de arranque — o comando que inicia a aplicação. Tem de escutar na porta indicada em $PORT.
  • Pasta de saída — nos sites estáticos, a pasta com os ficheiros gerados.
  • Pasta do projeto — para um repositório com vários projetos.

Deixe um campo vazio para usar o que detetámos. O deploy seguinte é feito com as novas definições; Fazer build agora inicia-o de imediato.

Em Definições fica também o Ramo que é publicado.

Hooks de deploy

Definições → Hooks de deploy → Criar um hook. Um hook de deploy é um endereço privado: quando outro serviço lhe envia um pedido POST, é feito o build e o deploy do commit mais recente do seu ramo. Um uso típico é um CMS que reconstrói o site depois de publicar.

curl -X POST "<the hook address from the panel>"
  • O endereço é mostrado uma única vez — copie-o quando criar o hook. Quem o tiver pode iniciar um deploy, por isso mantenha-o privado.
  • Até 10 deploys por hora por hook. Uma chamada que chegue enquanto um build ainda aguarda junta-se a ele.
  • Revogar desativa o endereço de imediato; os serviços que o chamam passam a precisar de um novo.

Modo de manutenção

Definições → Modo de manutenção → Mostrar a página de manutenção. Os visitantes veem uma página curta com a sua mensagem em vez da aplicação; deixe a mensagem vazia para mostrar «Estamos a fazer algumas melhorias. Volte daqui a pouco.»

A aplicação continua a funcionar, por isso pode verificar tudo antes de a voltar a abrir. Uma ligação privada para si mostra a aplicação normalmente no dispositivo que a abrir, durante 12 horas. Nova ligação cria uma nova; a antiga deixa de funcionar.

Desligue o interruptor para voltar a abrir a aplicação aos visitantes.

Notificações sobre deploys

Enviamos-lhe um email (e uma mensagem de Telegram, se o tiver ligado) quando um deploy não termina. Para enviar também eventos à sua equipa — uma nova versão publicada, um deploy que não terminou, um serviço que parou ou voltou, utilização elevada de memória ou de processador, uma cópia de segurança ou o disco de uma base de dados —, adicione Slack, Discord ou o seu próprio webhook em Definições → Notificações para a equipa. As mensagens de webhook são JSON assinado com um segredo mostrado uma única vez, no cabeçalho X-Rivervo-Signature.

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