Nesta página

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:

  1. Voce faz push na branch configurada (por exemplo, main)
  2. O GitHub notifica o Guara Cloud via webhook
  3. O Guara Cloud valida o push e verifica se ha mudancas relevantes
  4. Um novo build e iniciado automaticamente
  5. 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:

  1. Acesse a pagina do servico no dashboard
  2. Va ate a secao Fonte
  3. Altere a branch de deploy para a branch desejada
  4. 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 alteradoDispara deploy?Motivo
apps/api/src/main.tsSimDentro de apps/api
apps/api/package.jsonSimDentro de apps/api
apps/web/src/page.tsxNaoDiretorio diferente
README.mdNaoArquivo 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:

  1. Acesse a pagina do servico no dashboard
  2. Na secao Fonte, desabilite a opcao Deploy automatico
  3. 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.