Docker Run → Compose

主な用途

• 移行：都度実行のdocker runを再現可能なcomposeに変換。
• ドキュメント化：READMEのrunコマンドをチーム用のcompose形式に変換。
• マルチサービス：各サービスブロックを個別に生成して1つのcomposeに統合。
• CI/CD：docker runのシェルスクリプトを宣言型composeファイルに置き換え。

例：PostgreSQL コンテナ

入力：

docker run -d \
  --name postgres \
  -e POSTGRES_DB=myapp \
  -e POSTGRES_USER=admin \
  -e POSTGRES_PASSWORD=secret \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  --restart unless-stopped \
  postgres:16-alpine

出力：

services:
  postgres:
    image: "postgres:16-alpine"
    ports:
      - "5432:5432"
    volumes:
      - "pgdata:/var/lib/postgresql/data"
    environment:
      - "POSTGRES_DB=myapp"
      - "POSTGRES_USER=admin"
      - "POSTGRES_PASSWORD=secret"
    restart: unless-stopped

volumes:
  pgdata:

pgdata は名前付きボリュームなので、トップレベルの volumes: に宣言します。この部分がないと Compose はファイルを受け付けず、docker compose config は service "postgres" refers to undefined volume pgdata と報告します。-d は docker compose up -d でデタッチするため省きます。--name はサービス名になります。正確なコンテナ名に依存するスクリプトがあれば container_name: を手で追加してください。

例：ポート、リソース制限、既存ネットワーク

docker run --rm -it --network app-net -p 127.0.0.1:8080:80/tcp \
  --restart on-failure:3 --memory 512m --cpus 1.5 --cap-add NET_ADMIN \
  ghcr.io/acme/web:1.2 npm start

services:
  acme_web:
    image: "ghcr.io/acme/web:1.2"
    ports:
      - "127.0.0.1:8080:80/tcp"
    networks:
      - app-net
    restart: "on-failure:3"
    cap_add:
      - NET_ADMIN
    stdin_open: true
    tty: true
    deploy:
      resources:
        limits:
          memory: 512m
          cpus: "1.5"
    command: ["npm", "start"]

networks:
  app-net:
    external: true

--name がないとき、サービス名はイメージから決まります（ghcr.io/acme/web:1.2 → acme_web）。-it は短いオプション -i と -t をまとめたもので、それぞれ stdin_open と tty になります。--rm は省きます。--network は外部ネットワークになるので、事前に作成しておく必要があります（docker network create app-net）。--network host、none、bridge、container:名前 は network_mode: になります。

例：Compose のキーがないオプション

docker run -d --name web --env-file .env --entrypoint /bin/sh -u 1000:1000 -w /app --gpus all nginx:1.27 -c "nginx -g 'daemon off;'"

# Not converted: --gpus all
services:
  web:
    image: "nginx:1.27"
    entrypoint: ["/bin/sh"]
    env_file:
      - .env
    user: "1000:1000"
    working_dir: /app
    command: ["-c", "nginx -g 'daemon off;'"]

docker run の --entrypoint は実行ファイルを 1 つだけ取るので、要素 1 つのリストになります。イメージの後ろの引数は command です。--gpus には 1 対 1 の Compose キーがない（GPU は deploy.resources.reservations.devices に書く）ため、値は読み取ってイメージ名を正しく保ち、1 行目のコメントとステータス欄に表示します。

上の出力はすべて docker compose config（Docker Compose 5.1）を通ります。ツールのテストで各例にこの確認を実行しています。

フラグの対応表

オプションは --flag value、--flag=value、-p 80:80、-p80:80 のほか、まとめ書き（-dit、-dp 80:80）も Docker CLI と同じく使えます。

手で追加するオプション

次のオプションは読み取りますが変換しません。Compose のキーの形が異なるためです（services リファレンス）：

制限

• 1 回の変換で扱うのは docker run コマンド 1 つです。複数のコンテナは個別に変換し、サービスブロックを 1 つの services: の下にまとめてください。
• docker run と docker container run を認識します。podman run は認識しません。
• $(...)、$VAR、&& などのシェル構文は文字のまま残ります。変数は変換前に展開するか、結果で Compose の変数展開を使ってください。
• ./data のような相対バインドパスは、Compose では compose ファイルのディレクトリ、docker run ではカレントディレクトリが基準です。