docker run コマンドを Docker Compose に変換する方法
このページの内容 5 セクション
要点:docker run の各オプションには、compose. に対応するキーがあります。-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 db | container_name: db | ほかのサービスはサービスのキーをホスト名として使います |
-p 5432:5432 | ports: | 引用符で囲みます:"5432:5432" |
-e KEY=value | environment: | . ファイルなら env_file: |
-v pgdata:/ | volumes: | 名前付きボリュームはトップレベルでも宣言します |
-v . | volumes: | バインドマウント。Compose ファイルからの相対パス |
--restart unless-stopped | restart: unless-stopped | |
--network mynet | networks: | ネットワークもトップレベルで宣言します |
--health-cmd、--health-interval | healthcheck: | test、interval、timeout、retries |
-d | (なし) | docker compose up -d を使います |
--rm、-it | (なし) | 一度きりの実行向けの対話オプション |
プロジェクトのセットアップ手順でよく見かける 2 つのコマンドです。名前付きボリュームとヘルスチェックを使う PostgreSQL と、永続化を有効にした Redis です。
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 つのファイルになります:
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. の隣の . ファイルに入れ、. を . に追加し、次のように参照します:
environment:
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=appCompose は ${…} の値を置き換えるとき、プロジェクトディレクトリの . を自動で読み込みます。ほかの人が何を設定すればよいかわかるよう、プレースホルダーの値を入れた . をコミットしましょう。DevSnip Pro の .env Checker & Generator は両者を比較し、. を生成してくれます。
docker compose config
docker compose up -d
docker compose psdocker compose config はファイルを検証し、変数を置き換えて完全に解決した内容を表示するので、何かを起動する前に誤りがわかります。Compose のネットワーク内では、サービス同士はサービス名でつながります。アプリのコンテナは localhost:5432 ではなく postgres:/ に接続します。自分のマシンからは、公開したポートに引き続き localhost でアクセスできます。
- README から
docker runコマンドをコピーします。複数のコマンドを続けて並べれば、まとめて変換できます。 - DevSnip Pro: docker run → Compose を実行するか、DevSnip Pro のツールサイドバーで Ctrl/Cmd+K を押して「compose」を検索します。
- コマンドを貼り付けるか、アクティブなエディターから読み込みます。入力に合わせて
compose.が更新され、サービスの数や、直接書かれたシークレットなどの警告が表示されます。yaml - プロジェクトに
compose.として保存し、yaml docker compose configを実行します。
このツールは、ポート、環境変数、ボリューム、ネットワーク、再起動ポリシー、ヘルスチェック、リソース制限、GPU に対応しています。既存のコマンドではなく新しいサービスを作る場合は、同じセクションの Docker Compose Generator & Validator と Dockerfile Generator & Linter が、あなたのスタックから作成します。