TP12.1 - Dockerisation Complète

Objectifs du TP

Dans ce TP, vous allez:

✅ Créer un Dockerfile multi-stage optimisé
✅ Configurer Docker Compose avec PostgreSQL
✅ Gérer les profils et configurations
✅ Tester l'application en conteneur

Durée estimée: 1h30

Contexte

Vous dockerisez une application de gestion de tâches (Todo App) avec une base de données PostgreSQL.

Partie 1: Structure du Projet

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

Partie 2: L'Application

Todo Entity

@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);
    }
}

Partie 3: Fichiers de Configuration

application.properties

spring.application.name=todo-app

# Profil par défaut
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 pour développement 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

# Production - utilise les variables d'environnement
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

# Sécurité
server.error.include-stacktrace=never
management.endpoints.web.exposure.include=health,info,prometheus

Partie 4: Dockerfile

Dockerfile

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

WORKDIR /app

# Copier pom.xml et télécharger les dépendances (cache)
COPY pom.xml .
RUN mvn dependency:go-offline -B

# Copier le code source
COPY src ./src

# Compiler l'application
RUN mvn clean package -DskipTests

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

WORKDIR /app

# Créer un utilisateur non-root
RUN addgroup -S appgroup && adduser -S appuser -G appgroup

# Créer le répertoire des logs
RUN mkdir -p /app/logs && chown -R appuser:appgroup /app

# Passer à l'utilisateur non-root
USER appuser:appgroup

# Copier le JAR depuis le builder
COPY --from=builder /app/target/*.jar app.jar

# Exposer le port
EXPOSE 8080

# Variables d'environnement par défaut
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

# Lancer l'application
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

Partie 5: Docker Compose

docker-compose.yml (Développement)

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

  # Optionnel: PgAdmin pour gérer la DB
  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"

Partie 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 (ne jamais les inclure!)
.env
*.pem

Partie 7: Tests

Build et Run

# 1. Construire l'image
docker-compose build

# 2. Démarrer les services
docker-compose up -d

# 3. Vérifier les logs
docker-compose logs -f app

# 4. Vérifier la santé
curl http://localhost:8080/actuator/health

Tester l'API

# Créer un todo
curl -X POST http://localhost:8080/api/todos \
  -H "Content-Type: application/json" \
  -d '{"title": "Apprendre Docker", "description": "Conteneuriser Spring Boot"}'

# Lister les todos
curl http://localhost:8080/api/todos

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

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

Accéder à PgAdmin

Ouvrir http://localhost:5050
Login: admin@example.com / admin
Add Server:
- Host: db
- Port: 5432
- Username: todouser
- Password: todopass

Partie 8: Commandes Utiles

# Voir les conteneurs
docker-compose ps

# Voir les logs
docker-compose logs -f

# Arrêter tout
docker-compose down

# Arrêter et supprimer les volumes
docker-compose down -v

# Reconstruire sans cache
docker-compose build --no-cache

# Exécuter un shell dans le conteneur
docker exec -it todo-app sh

# Voir la taille des images
docker images | grep todo

Vérification Finale

Checklist

docker-compose up démarre sans erreur
L'app répond sur http://localhost:8080
/actuator/health retourne UP
La DB PostgreSQL est connectée
Les todos sont persistés (restart OK)
L'image fait moins de 300 MB

Vérifier la Taille de l'Image

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

🎯 Prochaine Étape

➡️ TP12.2: Pipeline CI/CD et Déploiement

⬅️ Retour au Module 12

Objectifs du TP​

Contexte​

Partie 1: Structure du Projet​

Partie 2: L'Application​

Todo Entity​

TodoController​

Partie 3: Fichiers de Configuration​

application.properties​

application-dev.properties​

application-docker.properties​

application-prod.properties​

Partie 4: Dockerfile​

Dockerfile​

Partie 5: Docker Compose​

docker-compose.yml (Développement)​

docker-compose.prod.yml​

Partie 6: .dockerignore​

Partie 7: Tests​

Build et Run​

Tester l'API​

Accéder à PgAdmin​

Partie 8: Commandes Utiles​

Vérification Finale​

Checklist​

Vérifier la Taille de l'Image​

🎯 Prochaine Étape​

Objectifs du TP

Contexte

Partie 1: Structure du Projet

Partie 2: L'Application

Todo Entity

TodoController

Partie 3: Fichiers de Configuration

application.properties

application-dev.properties

application-docker.properties

application-prod.properties

Partie 4: Dockerfile

Dockerfile

Partie 5: Docker Compose

docker-compose.yml (Développement)

docker-compose.prod.yml

Partie 6: .dockerignore

Partie 7: Tests

Build et Run

Tester l'API

Accéder à PgAdmin

Partie 8: Commandes Utiles

Vérification Finale

Checklist

Vérifier la Taille de l'Image

🎯 Prochaine Étape