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.
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:
| Framework | Comando de release recomendado |
|---|---|
| Laravel | php artisan migrate --force |
| Django | python 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.