Une application web ne se résume pas à son code. Il lui faut souvent une base de données, un serveur web, un outil de cache ou encore un service de traitement des tâches. Installer chaque élément à la main peut vite transformer une mise en ligne en chasse au trésor : une version manque ici, un réglage diffère là, et l’ordinateur du développeur ne ressemble plus du tout au serveur de production.
Docker Compose aide à remettre de l’ordre dans cette petite ménagerie. Il permet de décrire les services nécessaires à une application dans un seul fichier, puis de les démarrer et de les gérer ensemble. Voyons comment cet outil facilite le déploiement d’applications web, sans exiger un doctorat en conteneurs.
Docker Compose, c’est quoi au juste ?
Docker sert à exécuter des logiciels dans des conteneurs : des environnements isolés qui embarquent ce dont un service a besoin pour fonctionner. Imaginez une boîte bien préparée, avec le logiciel, ses dépendances et ses réglages. On peut la déplacer d’un ordinateur à un serveur en limitant les mauvaises surprises du type « chez moi, ça marchait ».
Docker Compose complète cette approche. Au lieu de lancer chaque conteneur séparément avec une longue série de commandes, on décrit l’ensemble de l’application dans un fichier, généralement nommé compose.yaml. Ce fichier indique quels services démarrer, quelles images utiliser, quels ports exposer et comment conserver les données.
Une application WordPress, par exemple, peut nécessiter au minimum deux services : WordPress et une base de données. Compose permet de déclarer ces deux éléments ensemble. Une seule commande peut alors lancer l’environnement complet, en veillant à ce que les services puissent communiquer.
Pourquoi l’utiliser pour un site web ?
Le premier avantage, c’est la reproductibilité. Les développeurs d’une équipe peuvent utiliser la même configuration sur leur ordinateur. Le site de test et celui du serveur reposent alors sur des services définis de manière cohérente. Cela ne garantit pas qu’aucun problème ne surviendra, mais réduit les écarts souvent responsables des surprises techniques.
Compose simplifie aussi le démarrage. Besoin d’ajouter une base de données, un outil de cache ou un service de recherche ? Il suffit généralement de décrire ce nouveau service dans le fichier de configuration, plutôt que d’installer et de régler chaque composant séparément.
-
Un environnement plus lisible : la configuration des services est rassemblée dans un fichier versionnable.
-
Des commandes simples : démarrer, arrêter ou consulter les journaux d’un projet devient plus direct.
-
Une meilleure collaboration : l’équipe partage les mêmes instructions pour lancer l’application.
-
Un déploiement plus prévisible : les services sont déclarés au lieu de dépendre d’étapes manuelles difficiles à mémoriser.
Attention toutefois : Compose n’est pas une baguette magique qui rend automatiquement un site rapide, sécurisé et prêt pour des millions de visiteurs. Il organise les services et leur lancement. La supervision, les sauvegardes, la sécurité et la stratégie de mise en production restent indispensables.
Créer un premier fichier de configuration
Prenons l’exemple d’un site WordPress accompagné d’une base de données. Le fichier ci-dessous présente le principe. Les clés de configuration sont écrites dans la syntaxe attendue par Compose ; les valeurs doivent être adaptées au projet.
services: site: image: wordpress:latest ports: - "8080:80" environment: WORDPRESS_DB_HOST: base:3306 WORDPRESS_DB_NAME: site WORDPRESS_DB_USER: utilisateur WORDPRESS_DB_PASSWORD: mot-de-passe-a-remplacer depends_on: - base volumes: - fichiers_site:/var/www/html base: image: mariadb:11 environment: MARIADB_DATABASE: site MARIADB_USER: utilisateur MARIADB_PASSWORD: mot-de-passe-a-remplacer MARIADB_ROOT_PASSWORD: autre-mot-de-passe-a-remplacer volumes: - fichiers_base:/var/lib/mysqlvolumes: fichiers_site: fichiers_base:La section services décrit les composants à exécuter. Ici, site correspond à WordPress et base à la base de données. Compose crée un réseau interne pour les services : WordPress peut donc joindre la base en utilisant son nom de service, ici base.
La règle ports relie le port 8080 de l’ordinateur au port 80 du conteneur. Une fois les services démarrés, le site devient accessible à l’adresse locale correspondante. Les volumes, eux, conservent les fichiers et les données en dehors du cycle de vie des conteneurs. Si un conteneur est recréé, le contenu stocké dans un volume ne disparaît pas avec lui.
La configuration sert à comprendre le mécanisme, pas à être copiée aveuglément en production. L’étiquette latest peut changer avec le temps, et les mots de passe inscrits directement dans un fichier ne conviennent pas à un environnement public. Nous y reviendrons.
Démarrer et gérer les services
Dans le dossier qui contient compose.yaml, la commande docker compose up -d démarre les services en arrière-plan. Docker télécharge les images nécessaires si elles ne sont pas déjà présentes, crée les conteneurs et met en place le réseau défini par le projet.
Pour vérifier ce qui tourne, utilisez docker compose ps. Si un service se comporte de façon inattendue, docker compose logs affiche ses journaux. Pour suivre les nouveaux messages en direct, ajoutez l’option de suivi. C’est souvent là que le problème se révèle : connexion refusée, variable manquante ou base de données encore en cours de démarrage.
Quand une modification de configuration est nécessaire, docker compose up -d peut recréer les services concernés. Pour arrêter l’application sans supprimer les volumes, utilisez docker compose down. Les conteneurs et le réseau sont alors retirés, mais les données persistantes restent disponibles.
La commande docker compose down -v supprime également les volumes associés. Elle peut être utile pour repartir de zéro lors d’un essai, mais elle efface aussi les données stockées. En clair : ne la lancez pas sur un site important sans avoir vérifié vos sauvegardes. Le bouton « tout effacer » est rarement celui qu’on veut découvrir par accident.
Organiser la configuration sans exposer ses secrets
Une bonne configuration distingue les réglages publics des informations sensibles. Les mots de passe, clés d’accès et jetons ne devraient pas être publiés dans un dépôt de code accessible à tous. Même dans une équipe privée, il vaut mieux éviter de les inscrire en clair dans le fichier partagé.
Compose peut récupérer des valeurs depuis des variables d’environnement, souvent placées dans un fichier local comme .env. Ce fichier ne doit pas être envoyé dans le dépôt si ses valeurs sont confidentielles. On peut fournir à la place un fichier modèle, par exemple .env.example, avec des noms de variables et des valeurs fictives pour aider chaque membre de l’équipe à préparer son environnement.
Pour un serveur de production, les secrets doivent être gérés selon les outils et les pratiques de l’hébergeur. Il faut également limiter les accès, appliquer les mises à jour et éviter d’exposer inutilement la base de données sur Internet. Un port non publié reste accessible aux autres services du réseau Compose, ce qui suffit généralement à l’application.
Des habitudes utiles pour un déploiement fiable
La simplicité de Compose peut donner envie de tout lancer immédiatement sur le serveur. Avant cela, quelques vérifications évitent bien des déconvenues.
-
Choisir des versions explicites : fixer une version d’image aide à éviter qu’une mise à jour imprévue modifie le comportement du site.
-
Prévoir des sauvegardes : un volume conserve les données, mais ne constitue pas une sauvegarde. Il faut copier les données vers un emplacement indépendant et vérifier qu’elles peuvent être restaurées.
-
Contrôler les journaux : consulter régulièrement les messages des services permet de repérer des erreurs avant qu’elles ne deviennent visibles pour les visiteurs.
-
Limiter les ports exposés : seuls les services qui doivent être accessibles depuis l’extérieur devraient publier un port.
-
Tester les mises à jour : valider une nouvelle version sur un environnement de test avant de l’appliquer au site en production.
Il est aussi utile de séparer les réglages de développement de ceux de production. En local, on peut avoir besoin d’outils supplémentaires ou de réglages pratiques. Sur le serveur, on privilégie une configuration plus stricte, des secrets protégés et des versions maîtrisées. Compose accepte des fichiers complémentaires pour adapter le comportement selon le contexte.
Compose et WordPress : un duo pratique, mais à préparer
Pour un site WordPress, Docker Compose facilite la mise en place d’un environnement complet : moteur du site, base de données et, selon les besoins, outil de cache ou service de courrier. Cela permet notamment de reproduire un problème sur une copie de test sans modifier directement le site public.
Il faut toutefois penser aux fichiers téléversés, aux extensions et aux thèmes. Leur emplacement doit être conservé correctement si l’on souhaite retrouver les mêmes contenus après la recréation d’un conteneur. Les volumes apportent une solution, à condition de savoir précisément quelles données ils contiennent et comment les sauvegarder.
Autre point important : un conteneur n’est pas nécessairement une sauvegarde complète de WordPress. Le site dépend à la fois de ses fichiers et de sa base de données. Pour pouvoir le restaurer, il faut protéger les deux, conserver une copie hors du serveur et documenter la procédure. Une sauvegarde que personne n’a jamais testée ressemble davantage à un pari qu’à un plan de secours.
Quand Compose est-il le bon choix ?
Compose convient particulièrement aux applications composées de plusieurs services, aux environnements de développement partagés et aux projets qui ont besoin d’un déploiement simple à reproduire. Il est également utile pour créer rapidement un environnement de démonstration ou de préproduction.
Pour une application très sollicitée répartie sur de nombreux serveurs, avec mise à l’échelle automatique et gestion avancée des pannes, une plateforme d’orchestration plus complète peut être nécessaire. Mais il n’est pas toujours judicieux de sortir l’artillerie lourde pour héberger un site vitrine. Le bon outil est celui qui répond aux besoins réels du projet, sans ajouter une couche de complexité juste pour faire impression en réunion.
En résumé, Docker Compose transforme une série de manipulations dispersées en configuration claire et partageable. Avec des volumes adaptés, des secrets protégés, des versions maîtrisées et des sauvegardes vérifiées, il devient un allié précieux pour déployer et gérer une application web. Commencez petit, testez chaque changement, et laissez les conteneurs faire leur travail : garder les services bien rangés, sans transformer votre serveur en tiroir à câbles numériques.
