Atualização automática por branch
auto-deploy publica novas versões após pushes na branch configurada. Em projetos GitHub e Forgejo, Automático por branch é uma das quatro formas exclusivas de atualização. A primeira build começa durante a criação do projeto, independentemente da forma escolhida.
Quando habilitar
Escolha Automático por branch quando:
- a branch configurada é estável
- o time usa pull requests ou revisão antes do merge
- cada push para a branch deve virar uma nova versão publicada
- a aplicação tem testes ou validação antes de chegar na branch monitorada
Evite habilitar em branches experimentais ou usadas para trabalho local.
Como funciona
- o projeto é criado a partir de um repositório Git conectado
- você escolhe branch, runtime, versão e comandos
- Automático por branch é selecionado nas configurações do projeto
- a primeira build inicia com a criação do projeto
- um push posterior na branch selecionada inicia uma nova publicação quando a atualização automática por branch está habilitada
- a Zenifra atualiza o projeto quando a publicação termina com sucesso
Nos modos Manual, Por Tag e Por Release, pushes à branch não publicam automaticamente. Você pode alterar a forma de atualização depois da criação; consulte Implantação via GitHub, Deploy a partir do Forgejo e a API de Builds GitHub.
O que validar
Depois de um push:
- confira logs de build
- confirme que a aplicação responde na URL pública
- revise logs da aplicação
- valide métricas e requisições HTTP
- confirme a versão publicada, se a aplicação expõe commit ou versão
Falhas comuns
| Sintoma | Causa provável |
|---|---|
| Push não disparou deploy | O modo não está como Automático por branch, o push foi feito em outra branch ou, no Forgejo, o hook não foi entregue |
| Build falhou | comando incorreto, dependência ausente ou lockfile inconsistente |
| App caiu depois do deploy | porta incorreta, variável ausente ou erro de inicialização |
| Versão errada no ar | push feito em branch diferente da configurada |
Próximos passos
FAQ
Posso mudar a forma de atualização depois?
Sim. Escolha Manual, Automático por branch, Por Tag ou Por Release; apenas uma forma pode ficar ativa. Em projetos GitHub, use Editar configuração no card Deploy pelo GitHub; a API de Builds GitHub descreve o endpoint. Em projetos Forgejo, use Modo de deploy na seção Repositório Git ou zenifra project source deploy-settings set.
O modo Automático por branch existe para OCI?
Não no mesmo formato. Projetos OCI são atualizados pela troca da imagem publicada.
O build roda em todo push?
No modo Automático por branch, pushes na branch selecionada disparam uma nova publicação.
Última atualização em