Installation de Docker Compose

Prérequis et intégration avec Docker Desktop

Avant de pouvoir utiliser Docker Compose pour orchestrer vos applications multi-conteneurs, vous devez vous assurer qu'il est correctement installé sur votre système. La bonne nouvelle est que si vous utilisez Docker Desktop sur Windows ou macOS, Docker Compose est très probablement déjà inclus et prêt à l'emploi.

Docker Desktop intègre Compose comme un plugin CLI Docker, ce qui signifie que vous interagissez avec lui via la commande `docker compose` (notez l'absence de tiret). Cette intégration simplifie grandement l'expérience utilisateur sur ces plateformes, car aucune étape d'installation supplémentaire n'est généralement requise après l'installation de Docker Desktop.

Pour les utilisateurs de Linux qui ont installé Docker Engine séparément (sans Docker Desktop), une installation manuelle de Compose peut être nécessaire. Ce chapitre détaille les méthodes d'installation pour toutes les plateformes, en mettant l'accent sur la méthode recommandée pour Linux.

Installation sur Windows et macOS (via Docker Desktop)

Comme mentionné, pour la grande majorité des utilisateurs sous Windows et macOS, l'installation de Docker Compose se fait automatiquement lors de l'installation de Docker Desktop. Docker Desktop est le moyen le plus simple et recommandé pour utiliser Docker sur ces systèmes d'exploitation.

Une fois Docker Desktop installé et en cours d'exécution, vous pouvez vérifier la présence et la version de Docker Compose en ouvrant votre terminal (Command Prompt ou PowerShell sous Windows, Terminal sous macOS) et en tapant la commande suivante :

docker compose version

Si Compose est correctement intégré, cette commande devrait afficher sa version (par exemple, `Docker Compose version v2.17.2`). Si vous obtenez une erreur indiquant que la commande `compose` n'est pas reconnue, vérifiez que Docker Desktop est bien démarré et que son chemin d'installation est correctement ajouté à la variable d'environnement PATH de votre système. Dans de rares cas, une réinstallation ou une mise à jour de Docker Desktop peut être nécessaire.

Aucune autre étape n'est généralement requise sur Windows et macOS. Vous pouvez directement commencer à utiliser la commande `docker compose` pour gérer vos applications multi-conteneurs.

Installation sur Linux (Méthode recommandée : Binaire autonome)

Sur Linux, si vous n'utilisez pas Docker Desktop, la méthode recommandée pour installer Docker Compose est de télécharger le binaire autonome directement depuis les releases officielles sur GitHub. Cela garantit que vous disposez de la version la plus récente et stable.

Le processus typique implique les étapes suivantes :

1. Télécharger le binaire : Utilisez `curl` pour télécharger la version stable appropriée pour votre architecture depuis la page des releases de Docker Compose (remplacez `` par le numéro de version souhaité, par exemple `v2.20.3`).

# Exemple pour Linux x86_64 (remplacer )
LATEST_COMPOSE_VERSION="v2.24.6" # Vérifier la dernière version sur GitHub
DESTINATION="/usr/local/bin/docker-compose" # Ou ~/.docker/cli-plugins/docker-compose

sudo curl -L "https://github.com/docker/compose/releases/download/${LATEST_COMPOSE_VERSION}/docker-compose-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" -o $DESTINATION

Note: L'emplacement `~/.docker/cli-plugins/docker-compose` permet d'utiliser la commande `docker compose` (sans tiret). Si vous le placez dans `/usr/local/bin/docker-compose`, vous utiliserez la commande `docker-compose` (avec tiret, legacy v1 ou v2 standalone). L'intégration comme plugin (`docker compose`) est la voie moderne.

2. Appliquer les permissions d'exécution : Rendez le binaire téléchargé exécutable.

sudo chmod +x $DESTINATION

3. (Optionnel) Créer un lien symbolique (si installé dans un autre chemin) : Si vous n'avez pas installé directement dans un dossier du PATH ou comme plugin, vous pourriez avoir besoin de créer un lien symbolique.

Cette méthode vous donne un contrôle total sur la version installée et est indépendante des gestionnaires de paquets de votre distribution, qui peuvent parfois proposer des versions obsolètes.

Installation sur Linux (Autres méthodes - Moins recommandées)

Bien que le téléchargement direct du binaire soit préféré, d'autres méthodes existent sur Linux :

1. Gestionnaire de paquets : Certaines distributions Linux proposent Docker Compose dans leurs dépôts officiels (`apt` pour Debian/Ubuntu, `yum`/`dnf` pour CentOS/Fedora). Par exemple :

# Sur Debian/Ubuntu
sudo apt update
sudo apt install docker-compose-plugin # Pour l'intégration 'docker compose'

# Ou (pour l'ancien standalone 'docker-compose')
# sudo apt install docker-compose

L'inconvénient majeur est que les versions disponibles via les gestionnaires de paquets peuvent souvent avoir plusieurs mois, voire années, de retard sur les dernières releases officielles, vous privant des nouvelles fonctionnalités et des corrections de bugs.

2. Installation via `pip` (Python) : Historiquement, Docker Compose était un outil Python et pouvait être installé via `pip`. Cette méthode est de moins en moins recommandée pour l'installation système, car elle peut potentiellement entrer en conflit avec d'autres paquets Python ou les dépendances système. De plus, elle installe généralement l'ancienne commande `docker-compose` (v1 ou v2 standalone).

# Non recommandé pour une installation système
pip install docker-compose

Privilégiez toujours le téléchargement du binaire autonome ou l'installation via Docker Desktop ou le plugin via gestionnaire de paquet pour une expérience plus stable et à jour.

Vérification de l'installation et utilisation de la commande

Quelle que soit la méthode d'installation choisie, la dernière étape consiste à vérifier que Docker Compose fonctionne correctement. Ouvrez un terminal et exécutez :

# Méthode recommandée (plugin intégré ou installé dans ~/.docker/cli-plugins)
docker compose version

# Méthode alternative (binaire standalone legacy v1 ou v2)
docker-compose --version

La commande devrait afficher la version de Docker Compose installée sans erreur.

Il est important de noter la distinction entre `docker compose` (sans tiret) et `docker-compose` (avec tiret). `docker compose` fait référence à la version 2 (et suivantes) de Compose, réécrite en Go et intégrée comme plugin Docker. C'est la version moderne et recommandée. `docker-compose` fait référence soit à l'ancienne version 1 (écrite en Python, maintenant obsolète), soit au binaire autonome de la v2.

Bien que le binaire autonome v2 puisse être appelé via `docker-compose`, la tendance et la recommandation sont d'utiliser la syntaxe intégrée `docker compose`. Assurez-vous d'utiliser cette dernière forme dans vos scripts et habitudes pour rester aligné avec l'évolution de l'outil. Si les deux commandes fonctionnent, privilégiez `docker compose`.