annuaire tech France
Auto-hébergement & outils web

Organiser son Docker Compose : l’architecture d’abord

Pensez votre stack avant d'écrire du YAML. Découvrez comment gérer les dépendances, l'ordre de démarrage et les volumes en production.

7 octobre 2026, 9 min de lecture

Organiser son Docker Compose : l’architecture d’abord

Quand vous écrivez votre premier Docker Compose, le fichier tient sur une page. Quand vous en avez plusieurs en production, gérer les dépendances, les réseaux, les volumes et l’ordre de démarrage devient un cauchemar si vous n’aviez pas une structure claire dès le départ. Organiser son Docker Compose, ce n’est pas d’abord une question de syntaxe YAML : c’est une question d’architecture.

Organiser c’est d’abord penser l’architecture

Un Docker Compose mal pensé ressemble à un monolithe dispersé. Vous avez plusieurs conteneurs qui communiquent entre eux, mais personne ne sait vraiment qui dépend de qui, dans quel ordre ils doivent démarrer, ou pourquoi l’arrêt dans le mauvais sens provoque des pertes de données. Ces problèmes ne viennent pas d’une mauvaise syntaxe : ils viennent d’une absence de réflexion sur la topologie.

Avant d’ouvrir l’éditeur, dessinez votre stack. Posez quelques questions essentielles : Quels sont mes services ? Par exemple, une API Node, une base de données PostgreSQL, un cache Redis, et un worker asynchrone. Lequel dépend de lequel ? L’API a besoin que PostgreSQL soit prêt et que Redis soit accessible. Le worker aussi a besoin de PostgreSQL. En cas d’arrêt, dans quel ordre dois-je tout fermer ? Généralement : l’inverse de l’ouverture. Les services qui écoutent d’abord, les dépendances ensuite.

Cette discipline vous évite plusieurs catégories de bugs courants. D’abord, les services qui démarrent dans le mauvais ordre : l’API démarre avant PostgreSQL, lance une migration et crash. Ensuite, l’État caché : vous pensiez qu’une variable d’environnement était propagée à tous les conteneurs, mais seul le réseautage par défaut la portait. Enfin, la perte de données : vous arrêtez le compose avec Ctrl+C, les volumes se suppriment, et les données du conteneur précédent partent à la poubelle.

Structurer par responsabilité — chaque service, une fonction unique

Chaque conteneur de votre compose file doit faire une seule chose bien. Pas plusieurs. L’API Node ne doit pas aussi exécuter les jobs Redis. PostgreSQL ne doit pas non plus héberger le cache. Cette séparation apporte plusieurs bénéfices immédiats.

D’abord le debugging. Quand l’API plante, vous éteignez l’API. Vous ne touchez pas à PostgreSQL. Vous regardez les logs de l’API uniquement. Si tout était dans un conteneur, démêler quel sous-système a cassé devient un cauchemar.

Ensuite, la réutilisabilité. L’image PostgreSQL officielle peut être utilisée par d’autres projets différents. Vous ne la modifiez jamais. Vous la tirez, vous l’exécutez avec des volumes et des variables d’environnement. Si vous aviez construit votre propre image avec PostgreSQL + votre app + des dépendances système, cette image devient unique à un seul projet. Impossible à réutiliser.

Enfin, les updates. Vous voulez upgrader PostgreSQL à une version plus récente ? Vous changez une ligne dans votre compose : l’image docker se modifie. Vous redémarrez. Fait. Si PostgreSQL était compilé dans le conteneur app, chaque upgrade de la base obligerait une reconstruction de l’image app, un redéploiement complet, une vérification de compatibilité avec votre code. Le coût monte vite.

La tentation classique : « Pourquoi ne pas mettre la base dans le conteneur app pour simplifier ? » Mauvaise idée. Cela crée un couplage fort. L’app ne peut pas redémarrer sans perdre les données. PostgreSQL ne peut pas être partagé avec un autre service. Les logs de la base se mélangent avec les logs de l’app. Vous croyez gagner de la simplicité au départ ; vous la perdez au premier scaling.

Gérer les dépendances — `depends_on` et healthcheck

Docker Compose offre `depends_on` pour exprimer l’ordre de démarrage. Vous listez dans le service app : « dépend de PostgreSQL ». Docker Compose démarre d’abord PostgreSQL, puis l’app. Simple. Sauf que « démarrage » ne veut pas dire « prêt à recevoir des connexions ».

PostgreSQL peut être lancé — le conteneur est up — mais pas encore sorti du mode d’initialisation. L’app essaie de se connecter, reçoit une erreur, et crash. C’est le problème classique de `depends_on` seul. Il contrôle l’ordre de lancement, pas l’ordre de disponibilité.

La solution : combiner `depends_on` avec `condition: service_healthy`. Vous dites à Docker Compose : « Démarre PostgreSQL, puis attends que son healthcheck passe avant de lancer l’app. » Le healthcheck est une commande simple, souvent une requête SQL qui retourne true si la base est réellement prête.

Voici la structure YAML. Vous avez un service PostgreSQL avec un healthcheck. Le healthcheck s’exécute régulièrement. Il passe quand la base répond. En parallèle, votre service app déclare une dépendance non pas avec `depends_on: [postgres]`, mais avec `depends_on: { postgres: { condition: service_healthy } }`. Docker Compose attend maintenant que le healthcheck de PostgreSQL passe vraiment avant de lever l’app. Zéro erreur de connexion trop tôt, zéro crash au démarrage.

Isoler avec les réseaux et les volumes

Par défaut, tous les conteneurs d’un compose file partagent le même bridge réseau — le réseau par défaut de Docker Compose. Tous peuvent parler à tous. C’est pratique pour les petites démos, dangereux à plus grande échelle. Vous voulez une base qui ne parle qu’à l’app, pas au cache. Vous voulez un worker qui parle à la queue mais pas à l’API directement. Les réseaux custom vous y aident.

Quand vous définissez un réseau custom dans votre compose file et que chaque service s’y connecte explicitement, vous compartimentez la communication. Un conteneur dans un réseau ne peut pas voir un conteneur dans un autre réseau. C’est une couche de sécurité. C’est aussi une aide au debugging : vous savez exactement qui parle à qui.

Pour les données, il y a plusieurs approches. Les volumes nommés et les bind mounts. Un volume nommé existe indépendamment du conteneur. Vous arrêtez votre compose avec `docker compose down` ? Le volume nommé persiste. Vous relancez le compose plus tard : le volume est toujours là, les données intactes. Un bind mount, c’est un répertoire de votre machine hôte exposé dans le conteneur. Pratique pour le développement — vous éditez un fichier sur votre ordi, le conteneur le voit tout de suite. Mais à l’arrêt du compose, il n’y a pas de garantie de persistance. C’est éphémère.

En pratique : utilisez des volumes nommés pour les données persistantes (PostgreSQL, MongoDB). Utilisez des bind mounts pour les sources en développement local, jamais pour l’état de production.

Réduire la répétition — YAML anchors et merge keys

Si vous avez plusieurs services, vous allez recopier la même configuration régulièrement. `restart: always` dans chaque service. Une politique de logging identique partout. Des variables d’environnement communes. YAML anchors vous sauvent de ce copier-coller.

Un anchor, c’est une étiquette que vous posez sur un bloc YAML (`&mon_restart`). Une merge key, c’est une référence à cet anchor (`*mon_restart`). Au parsing, YAML remplace la référence par le bloc complet. Vous écrivez une fois `restart: always`, vous l’insérez partout où c’est récurrent. Vous devez changer cette politique ? Une modification légère, elle s’applique partout.

La structure est simple. En début de fichier, vous définissez un anchor pour une configuration récurrente. Par exemple, les options de restart et de logging que vos services doivent avoir. Puis chaque service inclut cet anchor via une merge key. Avant, c’était de nombreuses lignes identiques, difficiles à maintenir. Après, c’est une définition unique partagée systématiquement.

Cas particuliers — plusieurs fichiers et override

Un seul fichier compose fonctionne jusqu’à une certaine taille. Quand vous gérez plusieurs environnements — développement, test, staging, production — chacun avec ses variantes, garder tout dans un seul fichier devient infernal. Docker Compose gère plusieurs fichiers et fusionne leurs configurations.

Le pattern classique : un fichier base (`compose.yaml`) qui définit les services. Un fichier override pour chaque environnement (`compose.dev.yaml`, `compose.prod.yaml`). À la ligne de commande, vous dites à Docker : « Prends compose.yaml, ensuite applique compose.dev.yaml par-dessus. » Les services se fusionnent. Les configurations du fichier dev surchargent les variables du fichier base. Pas de duplication, pas de risque de divergence.

Un prestataire à trouver ?

Dites quelle famille d’entreprise vous cherchez et dans quelle commune : la demande est enregistrée, jamais envoyée automatiquement à une entreprise.

L’ordre d’application compte. Docker Compose fusionne les fichiers dans l’ordre que vous les listez. Un fichier plus tard surcharge un fichier plus tôt. Vous pouvez donc avoir un fichier minimal pour tous les environnements, puis des fichiers légers d’override pour chacun.

Un autre cas utile : le sidecar pattern. Un conteneur « sidecar » s’exécute aux côtés d’un service principal pour l’aider. Par exemple, un collecteur de logs qui va voir les logs du service principal et les expédie ailleurs. Ou un agent de monitoring qui scrape les métriques du service. Vous définissez ce sidecar dans le même compose, avec un volume partagé avec le service principal. Quand le service démarre, le sidecar démarre aussi. Quand le service s’arrête, le sidecar s’arrête aussi. C’est transparent, scalable, et séparé du code de l’app elle-même.

Points clés à retenir

Avant de valider votre compose file, posez-vous quelques questions fondamentales. Chaque service a-t-il un seul rôle ? L’app ne doit pas être aussi la base. Les dépendances sont-elles explicites et vérifiées avec healthcheck ? Un `depends_on` seul ne suffit pas si le service prend du temps à démarrer. Les réseaux sont-ils segmentés ? Vous n’avez pas besoin que tout parle à tout. Les volumes sont-ils nommés pour la persistence, bind-montés pour le dev ? C’est la différence entre perte de données et survie correcte. Avez-vous mutualisé les configs avec des anchors YAML ? Réduire la répétition fait gagner de la maintenabilité. Avez-vous une stratégie pour plusieurs environnements ? Un seul fichier pour tous n’est pas scalable à long terme. Ces points clés constituent une architecture Docker Compose réfléchie, durable et maintenable sur le long terme.

docker compose explique organiser ses services en chiffresVolume mensuel de recherches7 364recherches/moisCoût par clic estimé1,70€

Pour aller plus loin sur le site, vous pouvez aussi lire notre article sur l’optimisation d’une infrastructure cloud et la supervision des performances avec AWS CloudWatch.

FAQ : vos questions

Que retenir de « Organiser c’est d’abord penser l’architecture » ?
Un Docker Compose mal pensé ressemble à un monolithe dispersé. Vous avez plusieurs conteneurs qui communiquent entre eux, mais personne ne sait vraiment qui dépend de qui, dans quel ordre ils doivent démarrer, ou pourquoi l’arrêt dans le mauvais sens provoque des pertes de données.
Que retenir de « Structurer par responsabilité — chaque service, une fonction unique » ?
Chaque conteneur de votre compose file doit faire une seule chose bien. Pas plusieurs.
Que retenir de « Gérer les dépendances — `depends_on` et healthcheck » ?
Docker Compose offre `depends_on` pour exprimer l’ordre de démarrage. Vous listez dans le service app : « dépend de PostgreSQL ».
Que retenir de « Isoler avec les réseaux et les volumes » ?
Par défaut, tous les conteneurs d’un compose file partagent le même bridge réseau — le réseau par défaut de Docker Compose.
Comment trouver une entreprise du numérique près de chez moi ?
L’annuaire recense 11 076 agences web, ESN, sociétés d’infogérance, hébergeurs et éditeurs de logiciels dans 96 départements : cherchez par commune, département ou code postal depuis la barre de recherche.
Cet article note-t-il les entreprises de l’annuaire ?
Non. Les articles sont éditoriaux et ne notent personne. L’annuaire reprend seulement des données publiques du répertoire SIRENE.

À lire ensuite

Auto-hébergement & outils web

7 outils SEO gratuits pour WordPress PME

7 outils SEO gratuits pour WordPress PME : analyse de contenu, sitemaps et schémas structurés. Optimisez votre référencement naturel sans budget.

7 oct. 2026, 9 min de lecture