Docker: Prática Integrada da Fase 2

# Dockerfile de produção multi-estágio
FROM python:3.12-slim AS builder
# ... construir venv otimizado

FROM python:3.12-slim
# ... copiar venv, não-root, healthcheck

todo-app/
├── app.py              # Aplicação Flask
├── requirements.txt    # Dependências Python
├── templates/          # Templates HTML
│   └── index.html
├── Dockerfile          # Build de produção multi-estágio
├── .dockerignore       # Excluir arquivos desnecessários
├── nginx.conf          # Configuração de proxy reverso Nginx
└── docker-run.sh       # Script de implantação com um clique

# ============================================
# Dockerfile multi-estágio para App Flask de Tarefas
# Estágio 1: Construir ambiente virtual
# Estágio 2: Runtime de produção
# ============================================

# ---------- Estágio 1: Builder ----------
FROM python:3.12-slim AS builder

WORKDIR /build

# Cache: instalar dependências primeiro
COPY requirements.txt .
RUN python -m venv /opt/venv && \
    /opt/venv/bin/pip install --no-cache-dir -r requirements.txt

# ---------- Estágio 2: Produção ----------
FROM python:3.12-slim

# Instalar curl para healthcheck
RUN apt-get update && \
    apt-get install -y --no-install-recommends curl && \
    rm -rf /var/lib/apt/lists/*

# Criar usuário não-root
RUN groupadd -r appgroup && \
    useradd -r -g appgroup -u 1000 -m -d /home/appuser appuser

WORKDIR /app

# Copiar ambiente virtual do builder
COPY --from=builder /opt/venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"

# Copiar código da aplicação
COPY --chown=appuser:appgroup . .

# Criar diretório de logs
RUN mkdir -p /app/logs && chown appuser:appgroup /app/logs

# Alternar para usuário não-root
USER appuser

# Variáveis de ambiente (padrões, sobrescrever em tempo de execução)
ENV FLASK_ENV=production \
    LOG_LEVEL=info \
    APP_PORT=5000

EXPOSE 5000

# Verificação de saúde
HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
  CMD curl -f http://localhost:5000/health || exit 1

# Iniciar a aplicação
CMD ["python", "app.py"]

# .dockerignore
__pycache__
*.pyc
*.pyo
.git
.env
venv
.venv
*.md
Dockerfile
docker-compose*.yml

# Executar com variáveis de ambiente personalizadas
docker run -d \
  --name todo-app \
  -e FLASK_ENV=production \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -e LOG_LEVEL=warning \
  -p 5000:5000 \
  todo-app:1.0

# Criar arquivo .env
cat > .env << 'EOF'
FLASK_ENV=production
DATABASE_URL=postgresql://appuser:apppass@todo-db:5432/tododb
LOG_LEVEL=warning
APP_PORT=5000
EOF

# Executar com --env-file
docker run -d \
  --name todo-app \
  --env-file .env \
  -p 5000:5000 \
  todo-app:1.0

# Montar um volume nomeado para logs da aplicação
docker run -d \
  --name todo-app \
  -v app-logs:/app/logs \
  -e LOG_LEVEL=info \
  todo-app:1.0

# Construir com múltiplas tags
docker build -t todo-app:v1.0.0 -t todo-app:latest .

# Enviar todas as tags
docker push localhost:5000/todo-app:v1.0.0
docker push localhost:5000/todo-app:latest

# ============================================
# Script de implantação com um clique
# ============================================

# 1. Criar rede e volumes
docker network create todo-net
docker volume create pg-data
docker volume create app-logs

# 2. Iniciar PostgreSQL
docker run -d \
  --name todo-db \
  --network todo-net \
  -e POSTGRES_USER=appuser \
  -e POSTGRES_PASSWORD=apppass \
  -e POSTGRES_DB=tododb \
  -v pg-data:/var/lib/postgresql/data \
  --restart=unless-stopped \
  postgres:15-alpine

# 3. Aguardar inicialização do PostgreSQL
sleep 15

# 4. Construir e iniciar aplicação Flask
docker build -t todo-app:1.0 ./todo-app
docker run -d \
  --name todo-app \
  --network todo-net \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -v app-logs:/app/logs \
  --restart=unless-stopped \
  todo-app:1.0

# 5. Iniciar proxy reverso Nginx
docker run -d \
  --name todo-nginx \
  --network todo-net \
  -p 80:80 \
  -v $(pwd)/todo-app/nginx.conf:/etc/nginx/conf.d/default.conf \
  --restart=unless-stopped \
  nginx:1.25-alpine

# 6. Verificar
docker ps
curl http://localhost/health

# Analisar a imagem multi-estágio
dive todo-app:1.0

# Esperado: pontuação de eficiência > 90%, sem espaço desperdiçado

# ============================================
# Passo a passo completo: Containerizar uma app Flask
# Abrange: Dockerfile, build, implantação multi-contêiner
# ============================================

# 1. Construir a imagem otimizada
docker build -t todo-app:v1.0.0 -t todo-app:latest ./todo-app

# 2. Verificar a imagem
docker images todo-app
docker history todo-app:v1.0.0

# 3. Criar infraestrutura
docker network create todo-net
docker volume create pg-data
docker volume create app-logs

# 4. Iniciar PostgreSQL com armazenamento persistente
docker run -d \
  --name todo-db \
  --network todo-net \
  -e POSTGRES_USER=appuser \
  -e POSTGRES_PASSWORD=apppass \
  -e POSTGRES_DB=tododb \
  -v pg-data:/var/lib/postgresql/data \
  --restart=unless-stopped \
  postgres:15-alpine

# 5. Iniciar aplicação Flask
docker run -d \
  --name todo-app \
  --network todo-net \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -v app-logs:/app/logs \
  --restart=unless-stopped \
  todo-app:v1.0.0

# 6. Iniciar proxy reverso Nginx
docker run -d \
  --name todo-nginx \
  --network todo-net \
  -p 8080:80 \
  -v $(pwd)/todo-app/nginx.conf:/etc/nginx/conf.d/default.conf \
  --restart=unless-stopped \
  nginx:1.25-alpine

# 7. Verificar stack completa
echo "=== Contêineres ===" && docker ps
echo "=== Verificação de Saúde ===" && docker inspect todo-app --format='{{.State.Health.Status}}'
echo "=== Resposta da App ===" && curl -s http://localhost:8080/health

# 8. Enviar para registry privado (opcional)
docker tag todo-app:v1.0.0 localhost:5000/todo-app:v1.0.0
docker push localhost:5000/todo-app:v1.0.0

# 9. Limpar (opcional)
# docker stop todo-nginx todo-app todo-db
# docker rm todo-nginx todo-app todo-db