Composeなら1コマンド — 複数コンテナをまとめる

Docker Compose。設定書類とつながるWebサーバーとデータベースの箱。

※本記事はアフィリエイト広告(PR)を含みます。

docker runの長い1行を毎回打つのは続きません。Composeで複数のコンテナをまとめ、1コマンドで立ち上げます。

前回: コンテナは軽い仮想マシンではない — Dockerの導入 作業場所は VM の中です。前回入れた Docker をそのまま使います。

前回、コンテナを動かすのにこう打ちました。

bash
$ docker run -d -p 8080:80 --name web -v ~/site:/usr/share/nginx/html:ro nginx

毎回これを打つのは無理です。 そして問題はもう一つあります。

実際のアプリは、コンテナ1つでは終わりません。

Webサーバーがあって、その後ろにアプリがあって、さらにデータベースがある。3つを別々に docker run して、繋ぎ方も自分で指定する——現実的ではありません。

これをファイル1枚にするのが Docker Compose です。

対象レベル: 中級 / 区分: 必修

目次

この記事でわかること

  • docker run の長いオプションが、そのままファイルの項目になること
  • コンテナ同士がサービス名で繋がる仕組み(IPアドレスを書かなくていい)
  • depends_on は「起動順」を決めるだけで、「準備完了」は待たないという落とし穴
  • down と down -v の違い(後者はデータを消す)

この記事でやること

  1. compose.yaml を書く(nginx + MySQL)
  2. docker compose up -d で両方まとめて起動する
  3. コンテナ同士が名前で繋がることを確かめる
  4. データベースにテーブルを作り、作り直しても残ることを確認する
  5. パスワードをファイルに直書きしない形に直す

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
Docker Compose複数のコンテナの起動条件をファイル1枚に書いて、まとめて上げ下げする道具。docker compose で呼ぶ
YAML字下げで階層を表す設定ファイルの書き方。compose.yaml がこの形式で、タブ文字は使えない
サービスcompose.yaml に書くコンテナ1種類ぶんの単位。付けた名前が、そのままコンテナ同士の呼び名になる
名前付きボリュームDockerが自分で管理する保存領域。コンテナを作り直してもデータが残る。データベースの中身はここに置く
healthcheckコンテナが「もう使える状態か」を定期的に確かめる設定。起動しただけの状態と区別するために使う

docker run と対応させて読む

新しい概念ではありません。 前回打ったオプションが、そのまま項目になります。

docker run のオプションcompose.yaml の項目
nginx(イメージ名)image: nginx
-p 8080:80ports: ["8080:80"]
-v ~/site:/usr/share/nginx/html:rovolumes: [...]
-e KEY=valueenvironment:
--name webサービス名がそのまま名前になる
-dup -d のほうに付ける

「打っていたものを、書くようにしただけ」です。

書く

bash
$ mkdir -p ~/stack/site
$ cd ~/stack
$ echo '<h1>Compose から起動しています</h1>' > site/index.html
$ nano compose.yaml
services:
  web:
    image: nginx
    ports:
      - "8080:80"
    volumes:
      - ./site:/usr/share/nginx/html:ro
    depends_on:
      - db

  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: dev_password_change_me
      MYSQL_DATABASE: appdb
    volumes:
      - db-data:/var/lib/mysql

volumes:
  db-data:

version: "3" の行は要りません。 古い記事にはほぼ必ず書いてありますが、現在は不要で、書くと警告が出ます。古い情報をそのまま信じない、の実例です。

YAML はインデント(字下げ)で構造を表します。 半角スペース2つで揃えてください。タブ文字は使えません。

1行ずつ

項目意味
services:動かすコンテナの一覧。web と db がサービス名
ports: "8080:80"ホストの8080 → コンテナの80
./site:...:roカレントからの相対パスでホスト側を指定。ro は読み取り専用
environment:コンテナに渡す環境変数
db-data:/var/lib/mysql名前付きボリューム。MySQLのデータの実体
volumes:(一番下)使うボリュームの宣言。ここに書かないとエラーになる

./site と db-data の違いが重要です。

書き方どこに置かれるか向いているもの
./site(バインドマウント)自分で見える場所(~/stack/site)自分で編集するファイル
db-data(名前付きボリューム)Dockerが管理する場所データベースの中身

データベースの実体を自分で覗く必要はありません。 むしろ触ると壊すので、Dockerに任せます。

起動する

その前に —— 前回のコンテナを片づける

前回の web コンテナが 8080番を掴んだままだと、ここで必ず止まります。

bash
$ docker ps
bash
$ docker rm -f web web2   # 残っていれば消す(無ければ「No such container」でよい)

確認します。

bash
$ docker ps
CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES

見出しの行だけになっていれば準備完了です。

片づけずに進むと、こうなります。

Error response from daemon: driver failed programming external connectivity on endpoint stack-web-1: Bind for 0.0.0.0:8080 failed: port is already allocated

port is already allocated は「そのポートは誰かが既に持っている」という意味です。犯人は docker ps で分かります。Compose の設定を疑う前に、まずこれを見てください。

bash
$ docker compose up -d
[+] Running 4/4
 ✔ Network stack_default    Created
 ✔ Volume "stack_db-data"   Created
 ✔ Container stack-db-1     Started
 ✔ Container stack-web-1    Started

4つ作られています。 コンテナ2つに加えて、ネットワークとボリュームが自動で作られているのが要点です。

docker-compose(ハイフン)ではなく docker compose(スペース) です。 前回入れた docker-compose-plugin がこの形です。ハイフン版は古いもので、入っていないと command not found になります。

状態を見る

bash
$ docker compose ps
NAME            IMAGE       STATUS         PORTS
stack-db-1      mysql:8     Up 20 seconds  3306/tcp, 33060/tcp
stack-web-1     nginx       Up 20 seconds  0.0.0.0:8080->80/tcp

db に 0.0.0.0-> が付いていません。 ports: を書かなかったので、VMの外からは繋がりません。 データベースは外に出さないのが正解なので、これで合っています。

bash
$ curl -s http://localhost:8080/
<h1>Compose から起動しています</h1>

ホストのブラウザからも確認する

VMの中の curl で終わらせないでください。 ループバック宛なので、外から届くかは何も分かりません。

ホストの Windows のブラウザで開きます。

http://192.168.226.50:8080/

IPは自分のVMの値に読み替えてください。 「Compose から起動しています」が出れば、第6段階のゴールに到達しています。

8080番は ufw に開けていないのに見えます。 前回の「Docker は ufw を素通りする」を思い出してください。 db に ports: を書かなかったのは、まさにこれが理由です。 書いていたら、MySQL がこのVMの外に向かって開いていました。ufw の status には何も出ません。

[スクリーンショット: 01_compose起動.png] docker compose ps で2つとも Up になっている画面と、ホストのブラウザで 8080番が開けている画面を並べて撮ってください。

コンテナ同士は「名前」で繋がる

ここが Compose の一番おいしいところです。

bash
$ docker compose exec web getent hosts db
172.18.0.2      db

db という名前が、IPアドレスに解決されました。

Compose は起動時に専用のネットワークを作り、サービス名で引けるようにします。 だから、

  • IPアドレスを調べなくていい(起動のたびに変わる)
  • アプリの設定に db とだけ書けばいい
// この先アプリを書くときの接続先
host: "db",     // ← IPではなくサービス名
port: 3306

前回 nginx のリバースプロキシで 127.0.0.1:3000 と書きました。 Compose ではapp:3000 のようにサービス名で書けます。 DNSの回でやった「名前をアドレスに変換する」が、コンテナの中でも起きているということです。

外からは見えません。 ホスト側で getent hosts db を打っても引けません。このネットワークの中だけの名前です。

データベースを触ってみる

MySQLの初期化には20秒ほどかかります。 ログで確認します。

bash
$ docker compose logs db | tail -n 3
[Note] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections.

ready for connections が出てから接続します。

bash
$ docker compose exec db sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -e "show databases;"'
+--------------------+
| Database           |
+--------------------+
| appdb              |
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+

compose.yaml に書いた appdb が、勝手に作られています。

なぜ sh -c '...' で囲むのか。 $MYSQL_ROOT_PASSWORD をコンテナの中で展開させたいからです。囲まないと、VM側のシェルが先に展開してしまい、空文字になります。 環境変数がどちら側のものか、は毎回混乱の元です。中で使うなら sh -c で囲む、と覚えてください。

テーブルを作る

bash
$ docker compose exec db sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" appdb -e "
  CREATE TABLE memo (id INT AUTO_INCREMENT PRIMARY KEY, body TEXT);
  INSERT INTO memo (body) VALUES (\"消えないか確かめる\");
  SELECT * FROM memo;"'
+----+------------------------+
| id | body                   |
+----+------------------------+
|  1 | 消えないか確かめる      |
+----+------------------------+

消える/消えないの実験

前回、コンテナを作り直すと中身が消えることを確認しました。 今回はボリュームを付けています。確かめます。

bash
$ docker compose down
$ docker compose up -d
$ sleep 15
$ docker compose exec db sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" appdb -e "SELECT * FROM memo;"'
+----+------------------------+
| id | body                   |
+----+------------------------+
|  1 | 消えないか確かめる      |
+----+------------------------+

残っています。 コンテナは作り直されましたが、データはボリュームにあるからです。

消したいとき

bash
$ docker compose down -v
コマンド何が消えるか
downコンテナとネットワーク。データは残る
down -vボリュームごと消える=データが消える
stop止めるだけ。コンテナは残る(start で再開)

-v は取り返しがつきません。 「なんかおかしいから作り直そう」で down -v を打つと、データベースの中身が全部消えます。 -v を打つ前に一呼吸、と決めておいてください。

[スクリーンショット: 02_データ永続化.png] down → up のあとでもレコードが残っている画面を撮ってください。

depends_on は待ってくれない

ここが、最初に必ず踏む落とし穴です。

compose.yaml にこう書きました。

    depends_on:
      - db

これは「db を先に起動する」という意味しかありません。

depends_on は「コンテナが起動したか」しか見ません。 MySQLが接続を受け付けられる状態になったかは、見ていません。

MySQLの初期化には十数秒〜数十秒かかります。その間、アプリ側が接続しにいくと、

Error: connect ECONNREFUSED 172.18.0.2:3306

「dbが先に起動しているはずなのに繋がらない」が起きます。

直し方

healthcheck を書いて、「準備完了」を条件にします。

下は compose.yaml の全文です。追記ではなく、丸ごと置き換えてください。 部分だけ貼り足すと web や db が二重に定義され、key "web" already defined や undefined volume db-data で必ず失敗します。

services:
  web:
    image: nginx
    ports:
      - "8080:80"
    volumes:
      - ./site:/usr/share/nginx/html:ro
    depends_on:
      db:
        condition: service_healthy

  db:
    image: mysql:8
    environment:
      MYSQL_ROOT_PASSWORD: dev_password_change_me
      MYSQL_DATABASE: appdb
    volumes:
      - db-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "127.0.0.1"]
      interval: 5s
      timeout: 3s
      retries: 20

volumes:
  db-data:

最初に書いたものとの違いは2か所だけです。db に healthcheck: が増え、web の depends_on: がリスト(- db)から条件付きの書き方に変わりました。

書き換えたら、まず検査します。

bash
$ docker compose config > /dev/null && echo OK

OK が出れば YAML として正しいという意味です。nginx の回の nginx -t と同じで、起動する前に構文を確かめる手順です。

condition: service_healthy にすると、healthcheck が通るまで待ちます。

bash
$ docker compose up -d
$ docker compose ps
NAME          IMAGE     STATUS
stack-db-1    mysql:8   Up 25 seconds (healthy)
stack-web-1   nginx     Up 3 seconds

(healthy) が付き、web の起動が後ろにずれています。

それでもアプリ側に再接続の仕組みを入れるべきです。 起動時だけでなく、運用中にDBが一時的に落ちることもあるからです。healthcheck は「起動時の事故」を減らすもので、万能ではありません。

パスワードを直書きしない

ここまで compose.yaml にパスワードをそのまま書いていました。 これは共有した瞬間に漏れます。

.env に分けます。

bash
$ nano ~/stack/.env
MYSQL_ROOT_PASSWORD=dev_password_change_me

compose.yaml 側は、

    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: appdb

docker compose は、同じディレクトリの .env を自動で読みます。

bash
$ docker compose config | grep MYSQL_ROOT_PASSWORD
      MYSQL_ROOT_PASSWORD: dev_password_change_me

config は「変数を展開した最終形」を見せるコマンドです。${MYSQL_ROOT_PASSWORD} のままではなく、中身に置き換わっていれば成功です。

ここを目で確かめてください。 .env の名前を間違えていても、Compose はエラーを出しません。空文字で通します。

      MYSQL_ROOT_PASSWORD: ""

こうなっていたら失敗です。 .env のファイル名(~/stack/.env)と変数名のつづりを見直してください。空のまま起動すると、MySQL が「パスワードが指定されていない」と言って落ちます。

反映するには作り直しが要ります。

bash
$ docker compose up -d
bash
$ echo ".env" >> ~/stack/.gitignore

.env は絶対にGitに入れない。 このサイトを作っているリポジトリでも、WordPressの認証情報は .env に置いて .gitignore しています。同じ考え方です。 compose.yaml は共有するもの、.env は共有しないもの、と分けてください。

片づける

bash
$ cd ~/stack
$ docker compose down -v
$ docker system df

ボリュームまで消して、使用量を確認します。 mysql:8 のイメージは数百MBあるので、使わないなら消しておきます。

bash
$ docker image rm mysql:8

まとめ

  • Compose は docker run のオプションをファイルに書いただけ。 新しい概念ではない
  • version: の行はもう要らない。 古い記事に必ず書いてあるが、書くと警告が出る
  • YAMLは半角スペース2つで字下げする。タブは使えない
  • コンテナ同士はサービス名で繋がる(db、app)。IPアドレスを書かない
  • ports: を書かなければ、外からは繋がらない。 データベースは外に出さない
  • ./site(バインド)は自分が編集するもの、db-data(名前付き)はDockerに任せるもの
  • down はデータが残る。down -v は消える。 -v を打つ前に一呼吸
  • depends_on は起動順を決めるだけで、準備完了は待たない。 healthcheck + condition: service_healthy で待たせる
  • それでもアプリ側に再接続を実装する。 運用中にDBが落ちることもある
  • 環境変数をコンテナの中で展開したいときは sh -c '...' で囲む
  • パスワードは .env に分けて .gitignore。 compose.yaml は共有するもの、.env は共有しないもの
  • docker compose config で、展開後の最終形を起動前に確認できる

ここまでで、「1台の中で複数のコンテナを協調させる」ところまで来ました。次の段階は、それを複数台のサーバーに広げる話(Kubernetes)ですが、その前に中で動かすアプリが要ります。

カリキュラムの順路では、先に 第3段階(プログラミング)と第5段階(バックエンド) を通ります。 ここで作った db に繋ぐアプリを、そこで書きます。


この記事の構成は手元の VM で完結しますが、同じ compose.yaml をインターネット側のサーバーで動かしてみると、ports: と .env の意味がもう一段はっきりします。検証用に 1 台持つなら、シンVPSのように 50 種類以上の OS・アプリイメージから選んで作れる VPS を借りて、壊しながら試す方法があります。2026年11月時点では 2GB(2コア・50GB)が 1 ヶ月 1,040 円〜36 ヶ月 950 円(税込)で、無料のお試し期間は無く、最低利用期間は 3 ヶ月です。

参考リンク


次に読む

この記事は 【第6段階】インフラとコンテナ の 4 / 25 本目です。

記事
← 前の記事コンテナは軽い仮想マシンではない — Dockerの導入
→ 次の記事1コマンドで環境が丸ごと立つ — Dockerの到達作品

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps/Docker›Containers
  • Docker Compose
  • ボリュームと永続化
  • コンテナ間ネットワーク

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次