Comment convertir des commandes docker run en Docker Compose

Par Sayaib SarkarMis à jour le 4 min de lecture

Sur cette page 5 sections

Réponse courte : chaque option de docker run a une clé correspondante dans compose.yaml : -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.

La correspondance entre options et clés

`docker run``compose.yaml`Remarques
IMAGE (dernier argument avant la commande)image:
arguments après l’imagecommand:
--name dbcontainer_name: dbC’est la clé du service que les autres services utilisent comme nom d’hôte
-p 5432:5432ports:Mettez-le entre guillemets : "5432:5432"
-e KEY=valueenvironment:Ou env_file: pour un fichier .env
-v pgdata:/var/lib/...volumes:Les volumes nommés sont aussi déclarés au niveau racine
-v ./data:/datavolumes:Montage lié ; relatif au fichier Compose
--restart unless-stoppedrestart: unless-stopped
--network mynetnetworks:Déclarez aussi le réseau au niveau racine
--health-cmd, --health-intervalhealthcheck:test, interval, timeout, retries
-d(aucune)Utilisez docker compose up -d
--rm, -it(aucune)Options interactives pour des exécutions ponctuelles

Un exemple complet

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.

Terminal
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 yes

Converties, elles deviennent un seul fichier avec deux services :

YAML
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:yy sans 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 ./data) n’en a pas besoin.
  • Un health check écrit sous la forme --health-cmd "…" s’exécute dans un shell, il devient donc CMD-SHELL dans Compose.

Sortir les secrets du fichier

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 .env à côté de compose.yaml, ajoutez .env au .gitignore et référencez-les :

YAML
    environment:
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
      - POSTGRES_DB=app

Compose lit automatiquement le .env du répertoire du projet lorsqu’il substitue les valeurs ${…}. Commitez un .env.example 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 .env.example pour vous.

Vérifier, puis démarrer

Terminal
docker compose config
docker compose up -d
docker compose ps

docker 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://db:5432, pas à localhost:5432. Depuis votre propre machine, les ports publiés fonctionnent toujours sur localhost.

Le faire dans VS Code

  1. Copiez les commandes docker run du README. Vous pouvez en convertir plusieurs à la fois, l’une après l’autre.
  2. Lancez DevSnip Pro: docker run → Compose, ou recherchez « compose » dans la barre latérale des outils DevSnip Pro avec Ctrl/Cmd+K.
  3. Collez les commandes, ou prenez-les dans l’éditeur actif. Le compose.yaml se met à jour pendant la saisie, avec le nombre de services et des avertissements, par exemple sur les secrets en clair.
  4. Enregistrez-le sous compose.yaml dans votre projet, puis lancez 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.

Essayez-le dans votre propre éditeur

Gratuit, sans compte, en local. Pour VS Code 1.93+ et les IDE JetBrains sous Windows, macOS ou Linux.

code --install-extension sayaib.hue-console