Deploy por Imagem Docker

Faça deploy de qualquer imagem Docker pública ou privada diretamente no PodCubo.

Quando Usar

Use deploy por imagem quando:

• Você já tem uma imagem buildada e publicada em um registry (Docker Hub, GitHub Container Registry, etc.)
• Quer usar uma imagem pronta de terceiros (ex: nginx, wordpress, ghost)
• Seu pipeline de CI/CD já gera a imagem e você só quer hospedá-la

Criando o App

1. Acesse sua stack e clique em New App
2. Selecione App como tipo
3. Escolha Container Image como fonte
4. Preencha o nome da imagem

Formato do Nome da Imagem

# Docker Hub (oficial)
nginx:alpine
postgres:16

# Docker Hub (usuário)
meuusuario/minha-app:latest

# GitHub Container Registry
ghcr.io/meuusuario/minha-app:v1.0

# Registry customizado
registry.exemplo.com/minha-app:latest

Porta

Defina a porta que o container expõe. Consulte a documentação da imagem pra saber qual porta usar.

Variáveis de Ambiente

Muitas imagens precisam de variáveis de ambiente pra funcionar. Você pode configurá-las na seção Environment Variables do app.

Registry Privado

Se sua imagem está em um registry privado:

1. Vá em Registries no menu principal
2. Adicione seu registry com as credenciais de acesso
3. Ao criar o app, selecione o registry privado

Atualizando a Imagem

Re-pull Manual

Quando uma nova versão da imagem é publicada com a mesma tag (ex: latest), use Save & Re-pull na tela de edição do app. O PodCubo vai:

1. Baixar a versão mais recente da imagem
2. Parar o container atual
3. Iniciar um novo container com a imagem atualizada

Mudando a Tag

Pra mudar pra uma versão específica (ex: de v1.0 pra v2.0):

1. Edite o app e altere o nome da imagem
2. Clique em Save & Re-pull

Volumes Automáticos

O PodCubo detecta automaticamente os volumes definidos na imagem Docker (via VOLUME no Dockerfile). Esses volumes são criados e montados automaticamente, garantindo que seus dados persistam entre restarts.

Você pode ver os volumes detectados na seção Info do app.