Começar

Deploys, prévias e rollbacks.

Como os pushes entram no ar, prévias de branches, a volta para uma versão anterior, o comando de release para migrations, configurações de build, deploy hooks, modo de manutenção e senhas para as prévias.

5 MIN DE LEITURA

Depois que um aplicativo está no ar, você raramente precisa do painel para publicar mudanças: faça push para o branch e a nova versão entra no ar sozinha. Este artigo explica tudo o que envolve isso — a aba Deploys, as Prévias, a aba Processos e algumas opções em Configurações.

Deploys automáticos a cada push

Cada push para o branch do aplicativo gera o build do último commit e faz o deploy dele. A nova versão sobe ao lado da que está rodando e só recebe visitantes depois que começa a responder; se ela não subir, a versão anterior continua rodando e avisamos você por e-mail (e pelo Telegram, se você o conectou).

Um push feito enquanto outro build ainda espera na fila entra nesse mesmo build, então uma sequência de pushes não cria uma fila longa.

Você pode desativar isso em Configurações → Deploy a cada push. Com a opção desativada, você faz o deploy pelo painel, pela API ou por um deploy hook.

Deploy pelo painel

A aba Deploys lista todos os deploys: o que os iniciou (um push, o painel, um rollback, um deploy hook), o commit, quanto tempo levaram e o status. Clique em um deploy para ver o log de build completo.

Fazer deploy de novo oferece duas opções:

  • Fazer build do último commit — pega o código mais recente do branch e faz o build.
  • Fazer deploy da versão atual de novo — aplica as variáveis alteradas, sem um novo build. Use depois de editar as Variáveis.

O menu ao lado de Abrir tem as mesmas duas ações e mais Reiniciar.

Rollback

Você pode voltar para qualquer uma das últimas 5 versões bem-sucedidas. Na aba Deploys, clique em Voltar para esta versão na versão desejada e confirme. A versão anterior sobe ao lado da atual e assume assim que responde — não há um novo build.

Um rollback não desfaz mudanças no banco de dados. Se uma versão alterou a estrutura do banco, restaure o banco também — veja Bancos de dados.

Prévias para branches

Um push para qualquer outro branch ganha sua própria prévia — um endereço separado onde você confere as mudanças antes de elas entrarem no ar. Abra as prévias na aba Prévias.

  • Até 3 prévias ao mesmo tempo, incluídas no seu preço.
  • Uma prévia sem novos pushes por 7 dias é removida. Ela é criada de novo no próximo push para esse branch.
  • As prévias recebem só as variáveis destinadas a elas — veja Variáveis de ambiente.
  • As prévias são criadas para o serviço principal de um projeto, não para os outros serviços.

Uma senha para as prévias

Na aba Prévias, Senha para as prévias → Pedir uma senha. Informe um nome de usuário e uma senha (pelo menos 8 caracteres). A partir daí, só quem tem a senha consegue abrir as prévias; o aplicativo em si continua aberto para todos.

O comando de release (migrations)

A aba Processos → Comando de release. Ele roda uma vez a cada deploy, antes de a nova versão receber visitantes — normalmente as migrations do banco de dados. Se ele falhar, o deploy para e a versão atual continua rodando, então uma migration com erro nunca chega aos seus visitantes.

Sugerimos um comando para os frameworks que têm um:

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 a sugestão; você também pode digitar o seu ou escolher Nenhum. As mudanças valem a partir do próximo deploy.

Configurações de build

Configurações → Configurações de build permite alterar o que detectamos:

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

Deixe um campo vazio para usar o que detectamos. O próximo deploy é feito com as novas configurações; Fazer build agora inicia na hora.

Em Configurações também fica o Branch usado no deploy.

Deploy hooks

Configurações → Deploy hooks → Criar um hook. Um deploy hook é um endereço privado: quando outro serviço envia uma requisição POST para ele, o último commit do seu branch passa por build e deploy. Um uso comum é um CMS que gera o site de novo depois que você publica algo.

curl -X POST "<the hook address from the panel>"
  • O endereço aparece uma única vez — copie-o ao criar o hook. Qualquer pessoa que o tenha pode iniciar um deploy, então mantenha-o em sigilo.
  • Até 10 deploys por hora por hook. Uma chamada que chega enquanto um build ainda está esperando entra nele.
  • Revogar desativa o endereço na hora; os serviços que o chamam vão precisar de um novo.

Modo de manutenção

Configurações → Modo de manutenção → Mostrar a página de manutenção. Os visitantes veem uma página curta com a sua mensagem no lugar do aplicativo; deixe a mensagem vazia para mostrar «Estamos fazendo algumas melhorias. Volte daqui a pouco.»

O aplicativo em si continua rodando, então você pode conferir tudo antes de abri-lo de novo. Um link privado para você mostra o aplicativo normalmente no dispositivo que o abrir, por 12 horas. Novo link cria outro; o link antigo deixa de funcionar.

Desative a opção para abrir o aplicativo aos visitantes de novo.

Notificações sobre deploys

Enviamos um e-mail para você (e uma mensagem no Telegram, se você o conectou) quando um deploy não termina. Para enviar eventos também para a sua equipe — uma nova versão entrou no ar, um deploy não terminou, um serviço parou ou voltou, uso alto de memória ou de processador, um backup ou o disco de um banco de dados —, adicione Slack, Discord ou seu próprio webhook em Configurações → Notificações para a sua equipe. 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 com a gente no chat — a AI responde na hora e um engenheiro entra quando é preciso, a qualquer hora do dia.

Falar com o suporte