Comment convertir des commandes docker run en Docker Compose
Sur cette page 5 sections
Réponse courte : chaque option de docker run a une clé correspondante dans compose. : -p devient ports, -e devient environment, -v devient volumes, --restart devient restart, et l’image et les éventuels arguments qui suivent deviennent image et command. Convertissez option par option, déclarez les volumes nommés en bas, puis vérifiez le fichier avec docker compose config. L’outil docker run → Compose de DevSnip Pro fait la conversion dans VS Code, pour une commande ou plusieurs à la fois.
Les README montrent généralement comment démarrer un service avec une longue commande docker run. Ça va pour une fois. Quand un projet a besoin d’une base de données et d’un cache tous les jours, un fichier Compose est plus facile à lire, à commiter et à partager : docker compose up -d démarre tout, et docker compose down arrête tout.
| `docker run` | `compose.yaml` | Remarques |
|---|---|---|
IMAGE (dernier argument avant la commande) | image: | |
| arguments après l’image | command: | |
--name db | container_name: db | C’est la clé du service que les autres services utilisent comme nom d’hôte |
-p 5432:5432 | ports: | Mettez-le entre guillemets : "5432:5432" |
-e KEY=value | environment: | Ou env_file: pour un fichier . |
-v pgdata:/ | volumes: | Les volumes nommés sont aussi déclarés au niveau racine |
-v . | volumes: | Montage lié ; relatif au fichier Compose |
--restart unless-stopped | restart: unless-stopped | |
--network mynet | networks: | Déclarez aussi le réseau au niveau racine |
--health-cmd, --health-interval | healthcheck: | test, interval, timeout, retries |
-d | (aucune) | Utilisez docker compose up -d |
--rm, -it | (aucune) | Options interactives pour des exécutions ponctuelles |
Voici deux commandes que vous pourriez trouver dans les notes d’installation d’un projet : PostgreSQL avec un volume nommé et un health check, et Redis avec la persistance activée.
docker run -d --name db -p 5432:5432 \
-e POSTGRES_PASSWORD=secret -e POSTGRES_DB=app \
-v pgdata:/var/lib/postgresql/data \
--restart unless-stopped \
--health-cmd "pg_isready -U postgres" --health-interval 10s \
postgres:16-alpine
docker run -d --name cache -p 6379:6379 redis:7-alpine redis-server --appendonly yesConverties, elles deviennent un seul fichier avec deux services :
services:
db:
image: postgres:16-alpine
container_name: db
ports:
- "5432:5432"
environment:
- POSTGRES_PASSWORD=secret
- POSTGRES_DB=app
volumes:
- pgdata:/var/lib/postgresql/data
restart: unless-stopped
healthcheck:
test:
- CMD-SHELL
- pg_isready -U postgres
interval: 10s
cache:
image: redis:7-alpine
container_name: cache
ports:
- "6379:6379"
command:
- redis-server
- --appendonly
- yes
volumes:
pgdata:Trois détails sont faciles à rater à la main :
- Les correspondances de ports sont entre guillemets. YAML peut lire certaines valeurs
xx:yysans guillemets comme des nombres en base 60. Mettre chaque correspondance de port entre guillemets évite le problème. - Les volumes nommés nécessitent une entrée
volumes:au niveau racine. Sans elle, Compose refuse de démarrer. Un montage lié (un chemin comme.) n’en a pas besoin./ data - Un health check écrit sous la forme
--health-cmd "…"s’exécute dans un shell, il devient doncCMD-SHELLdans Compose.
L’exemple garde POSTGRES_PASSWORD=secret en clair, ce qui convient pour une base locale jetable mais pas pour un fichier que vous commitez. Placez les valeurs dans un fichier . à côté de compose., ajoutez . au . et référencez-les :
environment:
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=appCompose lit automatiquement le . du répertoire du projet lorsqu’il substitue les valeurs ${…}. Commitez un . avec des valeurs fictives pour que les autres sachent quoi définir. Le .env Checker & Generator de DevSnip Pro compare les deux et génère le . pour vous.
docker compose config
docker compose up -d
docker compose psdocker compose config valide le fichier et l’affiche entièrement résolu, variables substituées, pour que les erreurs apparaissent avant que quoi que ce soit ne démarre. Dans le réseau Compose, les services se joignent par nom de service : un conteneur applicatif se connecte à postgres:/, pas à localhost:5432. Depuis votre propre machine, les ports publiés fonctionnent toujours sur localhost.
- Copiez les commandes
docker rundu README. Vous pouvez en convertir plusieurs à la fois, l’une après l’autre. - Lancez DevSnip Pro: docker run → Compose, ou recherchez « compose » dans la barre latérale des outils DevSnip Pro avec Ctrl/Cmd+K.
- Collez les commandes, ou prenez-les dans l’éditeur actif. Le
compose.se met à jour pendant la saisie, avec le nombre de services et des avertissements, par exemple sur les secrets en clair.yaml - Enregistrez-le sous
compose.dans votre projet, puis lancezyaml docker compose config.
L’outil gère les ports, les variables d’environnement, les volumes, les réseaux, les politiques de redémarrage, les health checks, les limites de ressources et les GPU. Pour un nouveau service plutôt qu’une commande existante, le Docker Compose Generator & Validator et le Dockerfile Generator & Linter de la même section partent plutôt de votre stack.