{"id":42738,"date":"2025-10-30T17:35:09","date_gmt":"2025-10-30T17:35:09","guid":{"rendered":"\/fr\/tutoriels\/?p=42738"},"modified":"2025-10-30T17:35:11","modified_gmt":"2025-10-30T17:35:11","slug":"docker-compose-cest-quoi","status":"publish","type":"post","link":"\/fr\/tutoriels\/docker-compose-cest-quoi\/","title":{"rendered":"Docker Compose : c\u2019est quoi et comment l\u2019utiliser ?"},"content":{"rendered":"

Docker Compose est un outil conçu pour définir et exécuter des projets multi-conteneurs. Les développeurs l’utilisent pour simplifier la gestion des services interconnectés, tels que la combinaison d’une application frontale et d’un serveur de base de données, ce qui leur permet d’administrer facilement l’ensemble de la pile d’applications.<\/p>

À l’aide d’un seul fichier YAML, Docker Compose permet aux développeurs de spécifier l’infrastructure nécessaire à la création d’une application, y compris l’image à utiliser, la configuration du réseau interne et le volume persistant à monter. Vous pouvez ensuite créer tous les conteneurs en fonction de la configuration en exécutant la commande docker compose up<\/strong>.<\/p>

Tout au long du cycle de vie du projet, vous pouvez gérer les conteneurs à l’aide d’autres commandes Compose. Par exemple, docker compose down <\/strong>supprime tous les services, tandis que docker compose ps <\/strong>répertorie les conteneurs actuellement en cours d’exécution spécifiés dans le fichier YAML.<\/p>

Pour utiliser Docker Compose, vous devez avoir installé Docker Engine et Docker CLI. Ensuite, configurez-le en téléchargeant l’extension à l’aide du gestionnaire de paquets de votre système ou de Homebrew. Si vous utilisez Docker Desktop, cet outil d’orchestration est préinstallé.<\/p>

Approfondissez vos connaissances pour en savoir plus sur Docker Compose et sur la manière de l’utiliser pour gérer des applications multi-conteneurs.<\/p>

Qu’est-ce que Docker Compose ?<\/strong><\/h2>

Docker Compose est un outil qui permet aux développeurs de définir et d’exécuter facilement des applications Docker multi-conteneurs. Son objectif principal est de simplifier, centraliser et unifier la gestion de plusieurs services.<\/p>

Docker Compose s’appuie sur un seul fichier YAML dans lequel vous définissez tout ce qui concerne les conteneurs de votre application : quelle image chaque service doit utiliser, comment ils communiquent et où ils stockent les données persistantes. Cette configuration vous permet de créer et de gérer ces conteneurs.<\/p>

Comment fonctionne Docker Compose ?<\/strong><\/h2>

Docker Compose fonctionne en définissant trois composants essentiels des applications multi-conteneurs dans le fichier YAML : les services<\/strong>, les réseaux <\/strong>et les volumes<\/strong>.<\/p>

Lorsque vous déployez une application à partir du fichier YAML, Docker Compose extrait ou construit l’image pour créer ce service<\/strong>, également appelé conteneur.<\/p>

Docker Compose crée ensuite un réseau interne pour permettre aux services de communiquer entre eux et initialise des volumes pour stocker les données persistantes que les conteneurs peuvent partager. Il configure également les variables d’environnement pour chaque service afin de transmettre les données sans les coder en dur dans son image.<\/p>

Toutes les configurations, y compris l’image à utiliser, la configuration du réseau, l’emplacement de montage des volumes persistants et les variables d’environnement à inclure, sont définies dans le fichier YAML. Cela signifie que vous pouvez créer et gérer tous les conteneurs de votre application à partir de ce fichier.<\/p>

Exemple de fichier YAML Docker Compose<\/strong><\/h3>

Voici un exemple de fichier YAML Docker Compose réel définissant un projet comprenant deux services interconnectés : une application web simple et une instance de cache Redis.<\/p>

Pour vous aider à comprendre la configuration, consultez les commentaires pour voir ce que fait chaque ligne.<\/p>

services:\n\n  web: # Service pour l'application web\n\n    build: . # Crée l'image à partir du fichier Dockerfile dans le répertoire actuel\n\n    ports:\n\n      - \"8000:5000\" # Mappe le port hôte 8000 au port conteneur 5000\n\n    depends_on:\n\n      - redis # S'assure que 'redis' démarre avant 'web' \n\n    volumes:\n\n      - .\/:\/app # Monte le répertoire actuel dans le conteneur à \/app (montage lié)\n\n    environment:\n\n      REDIS_HOST: ${REDIS_HOST:-redis} # Définit REDIS_HOST à partir de l'environnement ou par défaut à 'redis'\n\n  redis: # Service pour le cache Redis\n\n    image: redis:6 # Utilise l'image Redis officielle (version 6)\n\n    expose:\n\n      - \"6379\" # Expose le port 6379 aux autres services au sein du réseau Docker\n\n    volumes:\n\n      - redis_data:\/data # Conserve les données Redis dans un volume nommé \n\nvolumes:\n\n  redis_data: {} # Déclare le volume nommé pour la persistance des données Redis<\/pre>
Notez que le contenu exact du fichier YAML varie en fonction de votre application, de vos services et de votre configuration.<\/p>
Comment installer Docker Compose<\/strong><\/h2>
Les étapes d’installation de Docker Compose varient en fonction du type d’application Docker et de votre système d’exploitation.<\/p>
Si vous utilisez Docker Desktop<\/strong>, Compose est déjà préconfiguré. Pour Docker CLI, vous pouvez configurer l’extension Compose à partir du référentiel officiel ou en le téléchargeant manuellement. Nous vous expliquons comment procéder à partir du référentiel officiel, car cela simplifiera les mises à jour futures.<\/p>
Avant de continuer, assurez-vous d’avoir configuré Docker Engine et Docker CLI. Si ce n’est pas le cas, consultez notre guide d’installation de Docker sur Ubuntu<\/strong><\/a> pour en savoir plus sur les étapes à suivre.<\/p>
Une fois Engine et CLI configurés, installez Compose en fonction de votre système d’exploitation. Sous Linux, vous pouvez le faire à l’aide du gestionnaire de paquets de votre système. Voici, par exemple, les commandes à utiliser pour les distributions basées sur Debian :<\/p>
sudo apt update<\/pre>
sudo apt install docker-compose-plugin<\/pre>
Si vous utilisez des systèmes d’exploitation non Debian, remplacez simplement apt <\/strong>par le gestionnaire de paquets correspondant. Par exemple, utilisez dnf <\/strong>si vous utilisez des distributions basées sur RHEL.<\/p>
Pour les utilisateurs de macOS, installez Docker Compose via Homebrew à l’aide de cette commande :<\/p>
brew install docker-compose<\/pre>
Sous Linux et macOS, vous pouvez vérifier si Docker Compose est correctement installé en exécutant la commande suivante :<\/p>
docker compose version<\/pre>
Si Docker Compose est correctement configuré, vous verrez son numéro de version s’afficher sur votre terminal.<\/p>
\"Numéro<\/figure>
Comment utiliser Docker Compose<\/strong><\/h2>
Docker Compose vous permet de définir la configuration de votre application, d’exécuter la pile et de gérer son cycle de vie à l’aide d’un seul outil.<\/p>
Pour mieux illustrer l’utilisation de Docker Compose dans des scénarios réels, supposons que nous voulons exécuter WordPress sur Ubuntu à l’aide de Docker<\/strong><\/a>. Voici à quoi ressemble le flux de travail.<\/p>
    \n
  1. Utilisez un éditeur de texte tel que nano<\/strong><\/a> pour créer un fichier de configuration YAML ou YML. Vous pouvez utiliser n’importe quel nom, mais il est conseillé d’utiliser le nom par défaut docker-compose.yml <\/strong>ou compose.yaml <\/strong>pour faciliter la gestion.<\/li>\n\n\n\n
  2. Dans le fichier YAML, spécifiez les images WordPress et MySQL, ainsi que leurs paramètres, tels que la configuration réseau, le volume persistant et les dépendances.<\/li>\n\n\n\n
  3. Utilisez Docker Compose pour créer et exécuter tous les services WordPress et MySQL à l’aide des paramètres et des dépendances spécifiés dans le fichier YAML :<\/li>\n<\/ol>
    docker compose up<\/pre>
      \n
    1. Tout au long de votre projet, vous devrez arrêter et supprimer tous vos conteneurs pour les mises à jour ou la maintenance. Pour ce faire, exécutez la commande suivante :<\/li>\n<\/ol>
      docker compose down<\/pre>
      Vous pouvez modifier le comportement de la commande docker compose <\/strong>à l’aide d’indicateurs. Par exemple, si vous souhaitez créer une application à partir d’une configuration qui n’utilise pas le nom par défaut, ajoutez l’indicateur -f <\/strong>ou –file <\/strong>pour spécifier le fichier que Docker Engine lira :<\/p>
      docker compose -f votre-fichier-compose.yaml up <\/pre>
      Par défaut, Docker Compose créera les conteneurs dans votre répertoire de travail actuel. Pour déployer l’application dans un autre dossier, ajoutez –project-directory <\/strong>et spécifiez le chemin de déploiement :<\/p>
      docker compose --project-directory \/chemin\/de\/déploiement complet up<\/pre>
      \n\n\n        
      \n            
      \n                \n                    \n                <\/svg>\n                
      \n                     Exécution des conteneurs en arrière-plan 📦                 <\/p>\n            <\/div>\n            
       Docker Compose exécute automatiquement l'application déployée sur votre session de terminal principale. Si vous souhaitez créer et exécuter votre projet en arrière-plan, ajoutez l'option -d<\/strong> ou –detach<\/strong>. <\/p>\n                    <\/div>\n        \n\n\n\n<\/p>
      Vous pouvez également combiner plusieurs indicateurs en les séparant par une barre oblique inversée. Par exemple, utilisez la commande suivante si vous souhaitez déployer une application à partir d’un fichier YAML avec un nom spécifique vers un autre répertoire :<\/p>
      docker compose \\\n  -f \/path\/to\/my-docker-compose.yaml \\\n  --project-directory \/path\/to \\\n  up<\/pre>
      Lorsque vous supprimez des conteneurs, les données restent intactes car elles sont attachées à des volumes persistants. Si vous souhaitez également supprimer les volumes, utilisez l’indicateur –volumes <\/strong>comme suit :<\/p>
      docker compose down --volumes<\/pre>
      Commandes courantes de Docker Compose<\/strong><\/h3>
      Outre up <\/strong>et down, <\/strong>il existe d’autres commandes Docker Compose utilisées pour gérer l’ensemble de la pile d’applications. Voici quelques-unes des plus utilisées :<\/p>