Deploy via Imagem Docker
Alem de conectar um repositorio GitHub, voce pode deployar diretamente a partir de uma imagem Docker pre-construida. Isso e util quando voce ja possui um pipeline de CI/CD externo ou quer deployar imagens de terceiros.
Como funciona
Ao escolher a opcao Imagem Docker na criacao do servico, voce informa a referencia da imagem (nome e tag). O Guara Cloud puxa a imagem do registry e inicia o servico diretamente, sem etapa de build.
Especificando a imagem
Informe a referencia completa da imagem, incluindo a tag:
meu-usuario/minha-app:latest
meu-usuario/minha-app:v1.2.3
ghcr.io/minha-org/meu-servico:mainRegistries suportados
O Guara Cloud suporta imagens de qualquer registry publico:
- Docker Hub —
usuario/imagem:tag - GitHub Container Registry —
ghcr.io/org/imagem:tag - Qualquer registry publico — basta usar a URL completa da imagem
Configuracao
Ao deployar uma imagem Docker, voce precisa configurar:
- Porta — a porta que sua aplicacao expoe dentro do container
- Variaveis de ambiente — configuracoes necessarias para a aplicacao funcionar
Essas configuracoes podem ser alteradas a qualquer momento nas configuracoes do servico.
Quando usar imagem Docker vs GitHub
| Cenario | Recomendacao |
|---|---|
| Codigo fonte em repositorio GitHub | Deploy via GitHub |
| Pipeline de CI/CD externo que gera imagens | Imagem Docker |
| Imagem de terceiros (ex: banco de dados, proxy) | Imagem Docker |
| Prototipacao rapida a partir do codigo | Deploy via GitHub |
| Imagem ja otimizada e testada | Imagem Docker |
Atualizando a imagem
Para deployar uma nova versao da sua imagem, acesse as configuracoes do servico, atualize a referencia da imagem (por exemplo, de v1.2.3 para v1.3.0) e inicie um novo deploy. O Guara Cloud ira puxar a nova versao e substituir o container atual.