Docker Compose

# Vérifier s'il y est installé
docker --version
docker compose version

# pour l'installer

# Ubuntu/Debian
sudo apt update
sudo apt install docker-compose-plugin

# Vérification
docker compose version

# ==============================================================================
# EXEMPLE : ARCHITECTURE MULTI-CONTENEURS AVEC DOCKER COMPOSE
# ==============================================================================
version: "3.8"
services:

  # ----------------------------------------------------------------------------
  # 1. LE SERVICE DE BASE DE DONNÉES (Couche persistance - MySQL)
  # ----------------------------------------------------------------------------
  db:
    # Toujours cibler une version spécifique (ici une version LTS) en 
    # développement et production. Éviter ':latest' qui peut briser le projet du jour au lendemain.
    image: mysql:8.4
    
    # Nommer le conteneur évite que Docker génère un nom aléatoire.
    # Utile pour vos commandes CLI : 'docker logs cegep-mysql-db' ou 'docker exec -it ...'
    container_name: cegep-mysql-db  
    
    # Résilience. 'always' force le conteneur à redémarrer s'il plante ou si 
    # l'ordinateur/serveur redémarre.
    restart: always                  
    
    environment:
      # Sécurité et flexibilité. La syntaxe ${VAR:-defaut} tente de lire une 
      # variable dans un fichier '.env' local. Si elle n'existe pas, elle prend la valeur après le ':-'.
      # C'est la bonne pratique pour ne JAMAIS pousser de vrais mots de passe sur GitHub.
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-changeme_root}
      MYSQL_DATABASE: ${MYSQL_DB_NAME:-app_database}
      MYSQL_USER: ${MYSQL_USER:-app_user}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-changeme_user}
      
    volumes:
      # Persistance des données. Un conteneur est éphémère (si on le supprime, on perd tout).
      # On mappe un "Volume nommé" (géré par Docker) vers le dossier interne de MySQL.
      - db_data:/var/lib/mysql
      
      # CONCEPT (Astuce de prof) : Si vous décommentez la ligne sous ce commentaire, tout les scripts 
      # .sql placés dans votre dossier local './scripts_init' seront exécutés AUTOMATIQUEMENT 
      # au tout premier démarrage de la base de données. Très utile pour injecter un schéma et générer une bd !
      # - ./scripts_init:/docker-entrypoint-initdb.d
      
    networks:
      # Sécurité par isolation. La base de données est placée UNIQUEMENT dans 
      # le réseau arrière-plan (backend). Elle est invisible depuis l'extérieur ou depuis le serveur Web.
      - backend-network              
      
    healthcheck:
      # Validation d'état (Crucial !). Par défaut, Docker considère qu'un conteneur 
      # est prêt dès que son processus démarre. Mais MySQL prend souvent 10-15 secondes pour s'initialiser.
      # Ce test exécute un 'ping' interne pour confirmer que MySQL est RÉELLEMENT prêt à répondre.
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$MYSQL_ROOT_PASSWORD"]
      interval: 10s   # Temps entre chaque vérification
      timeout: 5s     # Temps max accordé à la commande pour répondre
      retries: 5      # Nombre d'échecs consécutifs avant de déclarer le conteneur "unhealthy"

  # ----------------------------------------------------------------------------
  # 2. L'APPLICATION NODE.JS (Couche Logique / API Backend)
  # ----------------------------------------------------------------------------
  app:
    # Les images '-alpine' sont basées sur une distribution Linux ultra-légère (~5 Mo).
    # Cela permet de télécharger et déployer les conteneurs beaucoup plus rapidement au laboratoire.
    image: node:20-alpine            
    container_name: cegep-node-app
    restart: unless-stopped          # Redémarre sauf si l'utilisateur l'a arrêté manuellement (ex: docker compose down)
    
    # Définit le dossier de travail PAR DÉFAUT à l'intérieur du conteneur.
    working_dir: /usr/src/app
    
    volumes:
      # Bind Mount (Montage lié) pour le développement. 
      # On lie le dossier './backend' de votre ordinateur au dossier '/usr/src/app' du conteneur.
      # Ainsi, dès qu'un étudiant modifie son code dans VS Code, le conteneur voit le changement 
      # instantanément (permet le Live Reload / Hot Reload avec nodemon).
      - ./backend:/usr/src/app
      
    environment:
      NODE_ENV: development
      # Le DNS Interne de Docker. Pour se connecter à la base de données, on n'utilise PAS 
      # une adresse IP (ex: 172.18.0.2) car elle change tout le temps. On utilise simplement le NOM 
      # du service Docker, soit 'db'. Docker résout le nom automatiquement !
      DB_HOST: db                    
      DB_USER: ${MYSQL_USER:-app_user}
      DB_PASS: ${MYSQL_PASSWORD:-changeme_user}
      DB_NAME: ${MYSQL_DB_NAME:-app_database}
      
    ports:
      # Mappage de ports (HÔTE:CONTENEUR). Le port 3000 de votre machine physique 
      # est redirigé vers le port 3000 interne du conteneur. Utile pour tester l'API directement 
      # avec Postman ou l'extension Thunder Client.
      - "3000:3000"                  
      
    # Remplace l'instruction CMD du Dockerfile d'origine. Ici, on lance le script de 
    # développement défini dans le fichier package.json de l'étudiant.
    command: npm run dev             
    
    networks:
      # Le pont (Bridge). Ce conteneur a les pieds dans DEUX réseaux.
      # Il peut parler à la base de données (via backend-network) ET recevoir les requêtes de Nginx 
      # (via frontend-network). C'est le seul intermédiaire.
      - backend-network              
      - frontend-network             
      
    depends_on:
      - db


  # ----------------------------------------------------------------------------
  # 3. LE SERVEUR WEB / REVERSE PROXY (Couche Présentation - Nginx)
  # ----------------------------------------------------------------------------
  web:
    image: nginx:alpine
    container_name: cegep-nginx-web
    restart: always
    
    ports:
      # Exposition publique. On mappe le port standard HTTP (80) de la machine hôte. 
      # C'est la seule porte d'entrée officielle pour l'utilisateur final (ex: http://localhost).
      - "80:80"                      
      
    volumes:
      # Injection de configuration et sécurité. On remplace la configuration par défaut 
      # de Nginx par la nôtre. L'ajout du drapeau ':ro' (Read-Only) est une bonne pratique de sécurité : 
      # le conteneur peut lire le fichier, mais ne pourra jamais le modifier ou le corrompre.
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf:ro  
      
      # CONCEPT OPTIONNEL : Si les étudiants ont un projet Frontend (React, Vue, HTML statique), 
      # Nginx peut servir les fichiers compilés directement sans passer par Node.js, ce qui est beaucoup plus performant.
      # - ./frontend/dist:/usr/share/nginx/html:ro
      
    networks:
      # Sécurité (Principe du moindre privilège). Nginx reçoit les requêtes du Web, il est 
      # le plus vulnérable. En l'isolant dans le 'frontend-network', s'il se fait pirater, l'attaquant 
      # n'a aucun chemin réseau pour atteindre directement la base de données.
      - frontend-network             
      
    depends_on:
      # Nginx a besoin que l'application Node tourne pour pouvoir lui relayer les requêtes API.
      - app
      # Avec Compose v3+ -> depends_on: condition: service_healthy

# ==============================================================================
# DÉCLARATION DES INFRASTRUCTURES PARTAGÉES (Réseaux et Volumes)
# ==============================================================================

networks:
  # Par défaut, Docker utilise le pilote (driver) 'bridge' (un commutateur/switch virtuel) 
  # pour créer des sous-réseaux isolés sur la machine hôte.
  frontend-network:
    driver: bridge
  backend-network:
    driver: bridge

volumes:
  # Les volumes nommés sont persistants et gérés par le moteur Docker. Même si l'étudiant 
  # fait un 'docker compose down', les données de la base de données restent en sécurité sur son volume.
  db_data:
    # Assigner un nom explicite permet à l'étudiant de repérer immédiatement son volume 
    # lorsqu'il exécute la commande 'docker volume ls'.
    name: cegep_mysql_data

docker compose ps

NAME              IMAGE           COMMAND                  SERVICE   STATUS              PORTS
cegep-mysql-db    mysql:8.4       "docker-entrypoint.s…"   db        running (healthy)   3306/tcp, 33060/tcp
cegep-node-app    node:20-alpine  "docker-entrypoint.s…"   app       running             0.0.0.0:3000->3000/tcp
cegep-nginx-web   nginx:alpine    "/docker-entrypoint.…"   web       running             0.0.0.0:80->80/tcp

# reste qu'à tester avec le navigateur http://localhost

docker compose up
docker compose up -d
docker compose up --build

docker compose down
docker compose down --volumes

docker compose ps

docker compose restart
docker compose restart backend

docker compose stop
docker compose start

docker compose logs
docker compose logs -f backend

docker compose exec backend bash
docker compose exec db psql -U postgres

docker compose run --rm backend ls /app

docker compose build
docker compose build backend

docker compose pull

docker compose config