ツール
Docker Compose
複数のコンテナをまとめて定義・起動できる Docker 公式のオーケストレーションツール。compose.yaml に宣言し docker compose コマンドで操作する。サービス間連携・depends_on・env_file の読み込み順など compose.yaml 固有の問題を扱い、単一コンテナのビルドやイメージ操作は Docker 側が担当する。
問題一覧(7)
docker-compose コマンドが見つからない(command not found)
docker-compose: command not found は、Compose V1 が廃止され docker compose に統合されたために出る。呼び出しをハイフン無しのサブコマンド形式へ書き換えれば直る。
更新: 2026-10-18、タグ: compose、command-not-found、cli
docker compose で env_file が読み込まれない
docker compose は .env(プロジェクトディレクトリ)と env_file:(サービス内環境変数)を別物として扱う。値が反映されない時はどちらに書いたかと、Compose 仕様の優先順位を確認する。
更新: 2026-09-14、タグ: env-file、compose、environment
docker compose でサービス名が名前解決されず接続できない
docker compose でサービス名が名前解決されないときは、同じネットワークへの所属と依存先の起動完了待ちを揃えれば直る。別 compose ファイル同士や network_mode: host で起きやすい。
更新: 2026-09-23、タグ: compose、network、dns
docker compose up が「port is already allocated」で起動できない
port is already allocated は、compose.yaml で公開するホストポートを別プロセスが使っていると出る。占有プロセスや残ったコンテナを止めるか、ports を別のホストポートに変えれば直る。
更新: 2026-10-05、タグ: compose、port、network
docker compose の depends_on で起動順が待たれない
depends_on の短い書き方はコンテナが起動するまでしか待たず、DB などが受付可能になるのは待たない。condition: service_healthy と healthcheck を組み合わせて準備完了まで待たせる。
更新: 2026-11-13、タグ: compose、depends_on、healthcheck
docker compose up で Dockerfile の変更が反映されない
docker compose up は既定ではビルド済みイメージをそのまま使い、Dockerfile やソースを変更しても再ビルドしない。--build を付けて起動するのが基本。それでも反映されない場合はレイヤーキャッシュとボリュームの覆い被せを疑う。
更新: 2026-09-14、タグ: compose、build、cache
docker compose のボリュームマウントで node_modules が消える
docker compose で ./:/app を bind mount すると、イメージ内の node_modules が隠れて消える。/app/node_modules に named volume を重ねてマウントすれば直る。
更新: 2026-09-23、タグ: compose、volume、bind-mount