Docker

コンテナが1つでも Compose ファイルを使う理由(Dockerfile との役割の違い)

Docker で開発環境を作るとき、コンテナが1つだけなら Dockerfile と docker run だけでも動かせます。それでも、手元の開発環境なら コンテナが1つでも Compose ファイル(compose.yaml)を使う のがおすすめです。理由は単純で、長い docker run のオプションをファイルに残しておけるから です。

※ 昔の docker-compose(v1)コマンドは終わっていて、今は docker compose(v2)、ファイル名は compose.yaml が標準です(docker-compose.yml も読み込めます)。

Dockerfile と Compose ファイルの役割の違い

DockerfileCompose ファイル
書くことコンテナの中身(イメージの作り方)コンテナの動かし方(手元の PC とのつなぎ方)
例ベースのイメージ(Java 21 など)、COPY、起動するコマンドポート(ports)、フォルダの同期(volumes)、再起動(restart)
対応するコマンドdocker builddocker 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 ファイルにしておくと、あとで書き直さずに済みます。

スポンサーリンク
タイトルとURLをコピーしました