docker compose

Fini les commandes à rallonge

Un site avec sa base, c'est déjà deux docker run de trois lignes chacun, un réseau, un volume… et il faut s'en souvenir. docker compose décrit tout ça dans un fichier docker-compose.yml, que l'on garde avec le projet :

services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro
    restart: unless-stopped

  base:
    image: postgres:18-alpine
    environment:
      POSTGRES_PASSWORD: ${MOT_DE_PASSE_BASE}
    volumes:
      - donnees:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  donnees:

Le format est le YAML : des paires clé: valeur, des listes avec - , et surtout une indentation de 2 espaces qui indique ce qui est rangé dans quoi. Jamais de tabulation.

• chaque service devient un conteneur, avec les mêmes réglages que docker run ;
• compose crée automatiquement un réseau pour le projet : web joint la base à l'adresse base ;
• les volumes nommés se déclarent en bas, sous volumes: ;
• ${MOT_DE_PASSE_BASE} est lu dans un fichier .env à côté : le secret ne se retrouve pas dans le fichier compose (ni sur GitHub).

Les commandes

Elles se lancent dans le dossier qui contient docker-compose.yml :

cd ~/monsite
docker compose up -d      # crée et démarre tout (en arrière-plan)
docker compose ps         # l'état des services
docker compose logs web   # le journal d'un service (-f pour suivre)
docker compose restart    # redémarre
docker compose down       # arrête et supprime les conteneurs et le réseau (les volumes restent)

Mettre à jour

Pour profiter d'un correctif de sécurité (une nouvelle version de PHP ou de nginx), on retélécharge les images puis on recrée les conteneurs. Les volumes gardent les données :

docker compose pull       # télécharge les nouvelles versions des images
docker compose up -d      # recrée seulement les conteneurs dont l'image a changé
docker image prune -f     # supprime les anciennes images devenues inutiles

Attention : docker compose down -v supprime aussi les volumes, donc la base de données. À n'utiliser que si tu veux vraiment tout effacer.