- Documentação
- Deploys
- Visao Geral dos Deployments
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:
- Codigo enviado — voce faz push no GitHub ou clica em “Deploy” no dashboard
- Build da imagem — o Guara Cloud cria uma imagem de container a partir do seu codigo
- Deploy da aplicacao — a nova versao e colocada no ar
- 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:
| Status | Descrição |
|---|---|
| Pendente | O deployment foi criado e está aguardando o início do build |
| Building | O build da imagem de container está em andamento |
| Deploying | A nova versão está sendo colocada no ar |
| Saudável | A aplicação está rodando e respondendo corretamente |
| Falha | Ocorreu um erro durante o build ou o deploy |
| Rollback | A versão foi substituída por um rollback para uma versão anterior |
| Substituído | Um deploy mais novo começou antes deste terminar, então este não foi publicado |
| Cancelado | Você 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:
| Tipo | Descricao |
|---|---|
| Push automatico | Disparado automaticamente quando voce faz push na branch configurada |
| Manual | Iniciado pelo usuario diretamente no dashboard |
| Rollback | Restaura uma versao anterior que estava funcionando |
| Mudanca de configuracao | Disparado ao alterar variaveis de ambiente ou recursos do servico |