- Documentação
- Deploys
- Deploys Automaticos
Deploys Automaticos
O Guara Cloud pode iniciar um deploy automaticamente toda vez que voce faz push na branch configurada do seu repositorio GitHub. Isso significa que seu codigo vai para producao sem nenhuma acao manual.
Como funciona
O fluxo de deploy automatico segue estas etapas:
- Voce faz push na branch configurada (por exemplo,
main) - O GitHub notifica o Guara Cloud via webhook
- O Guara Cloud valida o push e verifica se ha mudancas relevantes
- Um novo build e iniciado automaticamente
- Quando o build finaliza, a nova versao e deployada
Todo o processo acontece em segundo plano. Voce pode acompanhar o progresso na aba Deployments do servico.
Configurando a branch de deploy
Ao conectar um repositorio GitHub ao seu servico, voce escolhe a branch que dispara deploys automaticos. Apenas pushes nessa branch iniciam um novo deployment.
Para alterar a branch de deploy:
- Acesse a pagina do servico no dashboard
- Va ate a secao Fonte
- Altere a branch de deploy para a branch desejada
- Salve as configuracoes
Filtragem por caminho (monorepos)
Se voce usa um monorepo, o Guara Cloud oferece filtragem por caminho. Com essa funcionalidade, o deploy so e disparado quando arquivos dentro do diretorio configurado do servico sao alterados.
Por exemplo, se o diretorio raiz do servico e /apps/api:
| Arquivo alterado | Dispara deploy? | Motivo |
|---|---|---|
apps/api/src/main.ts | Sim | Dentro de apps/api |
apps/api/package.json | Sim | Dentro de apps/api |
apps/web/src/page.tsx | Nao | Diretorio diferente |
README.md | Nao | Arquivo na raiz do repo |
Para configurar o diretorio raiz, acesse as configuracoes do servico e defina o campo Diretorio Raiz.
Desabilitando deploys automaticos
Voce pode desativar deploys automaticos sem desconectar o repositorio:
- Acesse a pagina do servico no dashboard
- Na secao Fonte, desabilite a opcao Deploy automatico
- Confirme a alteracao
Com o deploy automatico desabilitado, pushes no GitHub nao iniciam novos deployments. Voce ainda pode iniciar deploys manualmente a qualquer momento.
Deployments cancelados
Se voce fizer um novo push enquanto um build ainda esta em andamento, o build anterior e cancelado automaticamente e um novo build e iniciado com o codigo mais recente. O deployment cancelado recebe o status Cancelado no historico.
Isso evita deploys de versoes intermediarias e garante que apenas o codigo mais recente seja deployado.