Nesta página

Visao Geral dos Deployments

Toda vez que voce envia uma atualizacao para o Guara Cloud, um deployment e criado. O deployment representa o processo completo de transformar seu codigo em uma aplicacao rodando na nuvem.

Como funciona

O processo de deployment segue etapas simples e automatizadas:

  1. Codigo enviado — voce faz push no GitHub ou clica em “Deploy” no dashboard
  2. Build da imagem — o Guara Cloud cria uma imagem de container a partir do seu codigo
  3. Deploy da aplicacao — a nova versao e colocada no ar
  4. Verificacao de saude — o Guara Cloud confirma que a aplicacao esta respondendo corretamente

O pipeline completo normalmente leva de 2 a 5 minutos, dependendo da complexidade do build.

Ciclo de vida dos status

Cada deployment passa por uma sequência de status que indica o progresso:

StatusDescrição
PendenteO deployment foi criado e está aguardando o início do build
BuildingO build da imagem de container está em andamento
DeployingA nova versão está sendo colocada no ar
SaudávelA aplicação está rodando e respondendo corretamente
FalhaOcorreu um erro durante o build ou o deploy
RollbackA versão foi substituída por um rollback para uma versão anterior
SubstituídoUm deploy mais novo começou antes deste terminar, então este não foi publicado
CanceladoVocê cancelou o deploy

Cancelar um deploy

Enquanto um deploy está em Building ou Deploying, você pode cancelá-lo pelo botão Cancelar no histórico de implantações do serviço:

  • Durante o build: o build é interrompido e a versão não é publicada. A versão que já está no ar não é afetada.
  • Durante o deploy: o rollout é interrompido e o serviço volta para a versão anterior. Se for o primeiro deploy do serviço, ele fica parado até o próximo deploy.

Historico de deployments

O Guara Cloud mantem um historico completo de todos os deployments do seu servico. No dashboard, acesse a aba Implantações do seu serviço para visualizar:

  • Status de cada deployment (Saudável, Falha, etc.)
  • Data e hora em que o deployment foi criado
  • Commit que disparou o deployment (SHA e mensagem)
  • Tipo de trigger (push automatico, manual ou rollback)
  • Duracao total do deployment

Detalhes do deployment

Ao clicar em um deployment especifico, voce acessa uma tela com informacoes detalhadas:

  • Tag da imagem — identificador unico da imagem de container gerada
  • SHA do commit — o commit exato do codigo utilizado
  • Duracao — tempo total do build e deploy
  • Status atual — status detalhado com timestamps de cada etapa
  • Logs de build — saida completa do processo de build

Tipos de deployment

O Guara Cloud suporta diferentes formas de iniciar um deployment:

TipoDescricao
Push automaticoDisparado automaticamente quando voce faz push na branch configurada
ManualIniciado pelo usuario diretamente no dashboard
RollbackRestaura uma versao anterior que estava funcionando
Mudanca de configuracaoDisparado ao alterar variaveis de ambiente ou recursos do servico