TP12.1 - Dockerização Completa

Objetivos do TP

Neste TP, você irá:

✅ Criar um Dockerfile multi-stage otimizado
✅ Configurar Docker Compose com PostgreSQL
✅ Gerenciar perfis e configurações
✅ Testar o aplicativo em contêiner

Duração estimada: 1h30

Contexto

Você irá dockerizar um aplicativo de gerenciamento de tarefas (Todo App) com um banco de dados PostgreSQL.

Parte 1: Estrutura do Projeto

todo-app/
├── src/
│   └── main/
│       ├── java/com/example/todo/
│       │   ├── TodoApplication.java
│       │   ├── entity/Todo.java
│       │   ├── repository/TodoRepository.java
│       │   ├── service/TodoService.java
│       │   └── controller/TodoController.java
│       └── resources/
│           ├── application.properties
│           ├── application-dev.properties
│           ├── application-docker.properties
│           └── application-prod.properties
├── pom.xml
├── Dockerfile
├── docker-compose.yml
├── docker-compose.prod.yml
└── .dockerignore

Parte 2: O Aplicativo

Entidade Todo

@Entity
@Table(name = "todos")
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Todo {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @NotBlank
    private String title;
    
    private String description;
    
    private boolean completed = false;
    
    @Column(name = "created_at")
    private LocalDateTime createdAt = LocalDateTime.now();
}

TodoController

@RestController
@RequestMapping("/api/todos")
@RequiredArgsConstructor
public class TodoController {

    private final TodoService todoService;

    @GetMapping
    public List<Todo> getAll() {
        return todoService.findAll();
    }

    @GetMapping("/{id}")
    public Todo getById(@PathVariable Long id) {
        return todoService.findById(id);
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public Todo create(@Valid @RequestBody Todo todo) {
        return todoService.create(todo);
    }

    @PutMapping("/{id}")
    public Todo update(@PathVariable Long id, @Valid @RequestBody Todo todo) {
        return todoService.update(id, todo);
    }

    @PatchMapping("/{id}/toggle")
    public Todo toggle(@PathVariable Long id) {
        return todoService.toggleComplete(id);
    }

    @DeleteMapping("/{id}")
    @ResponseStatus(HttpStatus.NO_CONTENT)
    public void delete(@PathVariable Long id) {
        todoService.delete(id);
    }
}

Parte 3: Arquivos de Configuração

application.properties

spring.application.name=todo-app

# Perfil padrão
spring.profiles.active=${SPRING_PROFILES_ACTIVE:dev}

# Actuator
management.endpoints.web.exposure.include=health,info
management.endpoint.health.show-details=always

application-dev.properties

# H2 para desenvolvimento local
spring.datasource.url=jdbc:h2:mem:tododb
spring.datasource.driver-class-name=org.h2.Driver
spring.h2.console.enabled=true

spring.jpa.hibernate.ddl-auto=create-drop
spring.jpa.show-sql=true

logging.level.com.example=DEBUG

application-docker.properties

# PostgreSQL via Docker Compose
spring.datasource.url=jdbc:postgresql://db:5432/tododb
spring.datasource.username=todouser
spring.datasource.password=todopass
spring.datasource.driver-class-name=org.postgresql.Driver

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=false
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

logging.level.com.example=INFO

application-prod.properties

# Produção - utiliza variáveis de ambiente
spring.datasource.url=${DATABASE_URL}
spring.datasource.username=${DB_USERNAME}
spring.datasource.password=${DB_PASSWORD}

spring.jpa.hibernate.ddl-auto=validate
spring.jpa.show-sql=false

logging.level.root=WARN
logging.level.com.example=INFO

# Segurança
server.error.include-stacktrace=never
management.endpoints.web.exposure.include=health,info,prometheus

Parte 4: Dockerfile

Dockerfile

# ===== STAGE 1: Build =====
FROM maven:3.9-eclipse-temurin-17 AS builder

WORKDIR /app

# Copiar pom.xml e baixar dependências (cache)
COPY pom.xml .
RUN mvn dependency:go-offline -B

# Copiar o código fonte
COPY src ./src

# Compilar o aplicativo
RUN mvn clean package -DskipTests

# ===== STAGE 2: Runtime =====
FROM eclipse-temurin:17-jre-alpine

WORKDIR /app

# Criar um usuário não-root
RUN addgroup -S appgroup && adduser -S appuser -G appgroup

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

# Trocar para o usuário não-root
USER appuser:appgroup

# Copiar o JAR do builder
COPY --from=builder /app/target/*.jar app.jar

# Expor a porta
EXPOSE 8080

# Variáveis de ambiente padrão
ENV JAVA_OPTS="-Xms256m -Xmx512m"
ENV SPRING_PROFILES_ACTIVE="docker"

# Health check
HEALTHCHECK --interval=30s --timeout=3s --start-period=60s --retries=3 \
  CMD wget --quiet --tries=1 --spider http://localhost:8080/actuator/health || exit 1

# Iniciar o aplicativo
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

Parte 5: Docker Compose

docker-compose.yml (Desenvolvimento)

version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: todo-app
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=docker
    depends_on:
      db:
        condition: service_healthy
    networks:
      - todo-network
    restart: unless-stopped

  db:
    image: postgres:15-alpine
    container_name: todo-db
    environment:
      POSTGRES_DB: tododb
      POSTGRES_USER: todouser
      POSTGRES_PASSWORD: todopass
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U todouser -d tododb"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - todo-network

  # Opcional: PgAdmin para gerenciar o banco
  pgadmin:
    image: dpage/pgadmin4:latest
    container_name: todo-pgadmin
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@example.com
      PGADMIN_DEFAULT_PASSWORD: admin
    ports:
      - "5050:80"
    depends_on:
      - db
    networks:
      - todo-network

volumes:
  postgres_data:

networks:
  todo-network:
    driver: bridge

docker-compose.prod.yml

version: '3.8'

services:
  app:
    image: ${DOCKER_IMAGE:-todo-app:latest}
    container_name: todo-app-prod
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DATABASE_URL=${DATABASE_URL}
      - DB_USERNAME=${DB_USERNAME}
      - DB_PASSWORD=${DB_PASSWORD}
      - JAVA_OPTS=-Xms512m -Xmx1024m
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 1G
        reservations:
          cpus: '0.5'
          memory: 512M
    restart: always
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

Parte 6: .dockerignore

# Build output
target/
!target/*.jar

# IDE
.idea/
*.iml
.vscode/
*.swp

# Git
.git/
.gitignore

# Docker files
Dockerfile*
docker-compose*.yml
.dockerignore

# Logs
*.log
logs/

# Tests
src/test/

# Documentation
*.md
docs/

# Secrets (nunca inclua!)
.env
*.pem

Parte 7: Testes

Build e Execução

# 1. Construir a imagem
docker-compose build

# 2. Iniciar os serviços
docker-compose up -d

# 3. Verificar os logs
docker-compose logs -f app

# 4. Verificar o health
curl http://localhost:8080/actuator/health

Testar a API

# Criar um todo
curl -X POST http://localhost:8080/api/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "Aprender Docker", "description": "Containerizar Spring Boot"}'

# Listar os todos
curl http://localhost:8080/api/todos

# Alternar complete
curl -X PATCH http://localhost:8080/api/todos/1/toggle

# Remover
curl -X DELETE http://localhost:8080/api/todos/1

Acessar o PgAdmin

Abrir http://localhost:5050
Login: admin@example.com / admin
Adicionar Servidor:
- Host: db
- Port: 5432
- Username: todouser
- Password: todopass

Parte 8: Comandos Úteis

# Ver os contêineres
docker-compose ps

# Ver os logs
docker-compose logs -f

# Parar tudo
docker-compose down

# Parar e remover volumes
docker-compose down -v

# Reconstruir sem cache
docker-compose build --no-cache

# Executar um shell no contêiner
docker exec -it todo-app sh

# Ver o tamanho das imagens
docker images | grep todo

Verificação Final

Checklist

docker-compose up inicia sem erro
O app responde em http://localhost:8080
/actuator/health retorna UP
O banco PostgreSQL está conectado
Os todos são persistidos (restart OK)
A imagem tem menos de 300 MB

Verificar o Tamanho da Imagem

docker images todo-app
# REPOSITORY   TAG       SIZE
# todo-app     latest    ~180MB

🎯 Próximo Passo

➡️ TP12.2: Pipeline CI/CD e Deploy

⬅️ Voltar ao Módulo 12

Objetivos do TP​

Contexto​

Parte 1: Estrutura do Projeto​

Parte 2: O Aplicativo​

Entidade Todo​

TodoController​

Parte 3: Arquivos de Configuração​

application.properties​

application-dev.properties​

application-docker.properties​

application-prod.properties​

Parte 4: Dockerfile​

Dockerfile​

Parte 5: Docker Compose​

docker-compose.yml (Desenvolvimento)​

docker-compose.prod.yml​

Parte 6: .dockerignore​

Parte 7: Testes​

Build e Execução​

Testar a API​

Acessar o PgAdmin​

Parte 8: Comandos Úteis​

Verificação Final​

Checklist​

Verificar o Tamanho da Imagem​

🎯 Próximo Passo​

Objetivos do TP

Contexto

Parte 1: Estrutura do Projeto

Parte 2: O Aplicativo

Entidade Todo

TodoController

Parte 3: Arquivos de Configuração

application.properties

application-dev.properties

application-docker.properties

application-prod.properties

Parte 4: Dockerfile

Dockerfile

Parte 5: Docker Compose

docker-compose.yml (Desenvolvimento)

docker-compose.prod.yml

Parte 6: .dockerignore

Parte 7: Testes

Build e Execução

Testar a API

Acessar o PgAdmin

Parte 8: Comandos Úteis

Verificação Final

Checklist

Verificar o Tamanho da Imagem

🎯 Próximo Passo