Docker で開発環境を作るとき、コンテナが1つだけなら Dockerfile と docker run だけでも動かせます。それでも、手元の開発環境なら コンテナが1つでも Compose ファイル(compose.yaml)を使う のがおすすめです。理由は単純で、長い docker run のオプションをファイルに残しておけるから です。
※ 昔の docker-compose(v1)コマンドは終わっていて、今は docker compose(v2)、ファイル名は compose.yaml が標準です(docker-compose.yml も読み込めます)。
Dockerfile と Compose ファイルの役割の違い
| Dockerfile | Compose ファイル | |
|---|---|---|
| 書くこと | コンテナの中身(イメージの作り方) | コンテナの動かし方(手元の PC とのつなぎ方) |
| 例 | ベースのイメージ(Java 21 など)、COPY、起動するコマンド | ポート(ports)、フォルダの同期(volumes)、再起動(restart) |
| 対応するコマンド | docker build | docker run のオプション |
ポート・フォルダの同期・再起動の設定は、Dockerfile には書けません。docker run のオプションか、Compose ファイルに書きます。
- ports:Dockerfile に書けるのは
EXPOSE 8080(コンテナの中で 8080 番を使う、という宣言)まで。手元の PC の何番につなぐかは、動かす PC の都合なので、外側で決める - volumes:Dockerfile の
COPYは、イメージを作るときにファイルを中に入れるだけ。手元のフォルダを動いているコンテナにつなぐのは、動かすときの設定 - restart:落ちたときにどうするかは、Docker(デーモン)への指示で、イメージの中身ではない
同じことを docker run と Compose で書くと
手元の apps フォルダにある Java のソース(sample-api.java)を動かす例です。題材は「Docker Composeで動かす超軽量API検証環境の作り方」と同じです。
Dockerfile は、どちらの場合も同じです。
FROM eclipse-temurin:21-jdk WORKDIR /app CMD ["java", "sample-api.java"]
docker run の場合
起動するたびに、このコマンドを打ちます。
docker build -t my-java-app . docker run -d \ --name my-java-api \ -p 9090:8080 \ -v "$(pwd)/apps":/app \ --restart unless-stopped \ my-java-app
Compose の場合
同じ内容を compose.yaml に書いておきます。
services:
api:
build: .
container_name: my-java-api
ports:
- "9090:8080"
volumes:
- ./apps:/app
restart: unless-stopped
起動するコマンドは、いつもこれだけです。
docker compose up -d
やっていることは同じです。違いは、設定がファイルに残るかどうか だけです。
※ 開発用なら restart: always より unless-stopped が扱いやすいです(自分で止めたコンテナは、PC を起動し直しても立ち上がりません)。
Compose を使う理由
- 起動のコマンドを覚えなくてよい:
-p 9090:8080だったか8080:9090だったか、と迷わない。いつもdocker compose up -d - ファイルが説明書になる:
compose.yamlを見れば、ポートや同期するフォルダがわかる。数か月後の自分にもわかる - 起動の設定も Git で管理できる:ソースと一緒にコミットしておけば、ほかの人も同じ設定で動かせる
コンテナが増えたときも、services: の下に足していくだけです。最初から Compose ファイルにしておくと、あとで書き直さずに済みます。

