docker run コマンドを Docker Compose に変換する方法

著者:Sayaib Sarkar更新日:5 分で読めます

このページの内容 5 セクション

要点:docker run の各オプションには、compose.yaml に対応するキーがあります。-p は ports、-e は environment、-v は volumes、--restart は restart になり、イメージと末尾の引数は image と command になります。オプションをひとつずつ変換し、名前付きボリュームを末尾で宣言してから、docker compose config でファイルを確認しましょう。DevSnip Pro の docker run → Compose ツールなら、1 つでも複数でも、VS Code の中で変換できます。

README には、長い docker run コマンド 1 つでサービスを起動する方法がよく載っています。1 回ならそれで構いません。プロジェクトで毎日データベースとキャッシュが必要なら、Compose ファイルのほうが読みやすく、コミットや共有もしやすくなります。docker compose up -d ですべて起動し、docker compose down で止められます。

オプションとキーの対応表

`docker run``compose.yaml`備考
IMAGE(コマンドの前の最後の引数)image:
イメージの後の引数command:
--name dbcontainer_name: dbほかのサービスはサービスのキーをホスト名として使います
-p 5432:5432ports:引用符で囲みます:"5432:5432"
-e KEY=valueenvironment:.env ファイルなら env_file:
-v pgdata:/var/lib/...volumes:名前付きボリュームはトップレベルでも宣言します
-v ./data:/datavolumes:バインドマウント。Compose ファイルからの相対パス
--restart unless-stoppedrestart: unless-stopped
--network mynetnetworks:ネットワークもトップレベルで宣言します
--health-cmd、--health-intervalhealthcheck:test、interval、timeout、retries
-d(なし)docker compose up -d を使います
--rm、-it(なし)一度きりの実行向けの対話オプション

実例

プロジェクトのセットアップ手順でよく見かける 2 つのコマンドです。名前付きボリュームとヘルスチェックを使う PostgreSQL と、永続化を有効にした Redis です。

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

変換すると、2 つのサービスを持つ 1 つのファイルになります:

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:

手作業では間違えやすい点が 3 つあります:

  • ポートの対応付けは引用符で囲みます。YAML は、引用符のない xx:yy の値を 60 進数の数値として読むことがあります。すべてのポートの対応付けを引用符で囲めば、この問題を避けられます。
  • 名前付きボリュームには、トップレベルの volumes: エントリーが必要です。ないと Compose は起動を拒否します。バインドマウント(./data のようなパス)には不要です。
  • --health-cmd "…" で書いたヘルスチェックはシェルで実行されるので、Compose では CMD-SHELL になります。

シークレットをファイルの外に出す

この例では POSTGRES_PASSWORD=secret を直接書いています。使い捨てのローカルデータベースなら問題ありませんが、コミットするファイルには向きません。値を compose.yaml の隣の .env ファイルに入れ、.env を .gitignore に追加し、次のように参照します:

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

Compose は ${…} の値を置き換えるとき、プロジェクトディレクトリの .env を自動で読み込みます。ほかの人が何を設定すればよいかわかるよう、プレースホルダーの値を入れた .env.example をコミットしましょう。DevSnip Pro の .env Checker & Generator は両者を比較し、.env.example を生成してくれます。

確認してから起動する

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

docker compose config はファイルを検証し、変数を置き換えて完全に解決した内容を表示するので、何かを起動する前に誤りがわかります。Compose のネットワーク内では、サービス同士はサービス名でつながります。アプリのコンテナは localhost:5432 ではなく postgres://db:5432 に接続します。自分のマシンからは、公開したポートに引き続き localhost でアクセスできます。

VS Code で行う

  1. README から docker run コマンドをコピーします。複数のコマンドを続けて並べれば、まとめて変換できます。
  2. DevSnip Pro: docker run → Compose を実行するか、DevSnip Pro のツールサイドバーで Ctrl/Cmd+K を押して「compose」を検索します。
  3. コマンドを貼り付けるか、アクティブなエディターから読み込みます。入力に合わせて compose.yaml が更新され、サービスの数や、直接書かれたシークレットなどの警告が表示されます。
  4. プロジェクトに compose.yaml として保存し、docker compose config を実行します。

このツールは、ポート、環境変数、ボリューム、ネットワーク、再起動ポリシー、ヘルスチェック、リソース制限、GPU に対応しています。既存のコマンドではなく新しいサービスを作る場合は、同じセクションの Docker Compose Generator & Validator と Dockerfile Generator & Linter が、あなたのスタックから作成します。

自分のエディターで試してみよう

無料・アカウント不要・ローカルで動作。Windows、macOS、Linux の VS Code 1.93 以降と JetBrains IDE に対応。

code --install-extension sayaib.hue-console