Docker Composeとは？何が嬉しいのか・どんな場面で使うか完全解説

第5章までで、docker run にオプションを山ほど付けてコンテナを立ち上げる技を身につけました。が、実務ではこうなります：

docker network create app-net
docker volume create pgdata
docker run -d --name db --network app-net -v pgdata:/var/lib/postgresql/data \
  -e POSTGRES_PASSWORD=secret postgres:16
docker run -d --name redis --network app-net redis:7-alpine
docker run -d --name api --network app-net -p 3000:3000 \
  -e DATABASE_URL=postgres://postgres:secret@db:5432/postgres \
  -e REDIS_URL=redis://redis:6379 \
  myapp:v1

起動するたびに毎回この長文を叩く、メンバー全員が同じ手順を正確になぞる、バージョン変更するとすべて書き直す——現実的ではありません。

Docker Compose はこれを1つのYAMLファイルに書き、docker compose up だけで全部起動する仕組み。本章からはこの Compose を主軸に据えて、複数コンテナの世界を扱います。

目次

1. Docker Compose とは
2. なぜ嬉しいのか（docker run との対比）
3. V1（docker-compose）と V2（docker compose）
4. 向く場面・向かない場面
5. 最小の動作例
6. まとめ

1. Docker Compose とは

Docker Compose は、複数のコンテナを宣言的に定義し、一括で起動・停止・管理する公式ツールです。設定は compose.yml（または docker-compose.yml）1ファイルに集約されます。

背後でやっていることは第5章までに学んだ内容（network create・volume create・docker run）そのもの。Compose はそれらを自動化する指揮者です。

2. なぜ嬉しいのか（docker run との対比）

3. V1（docker-compose）と V2（docker compose）

Compose にはバージョンが2系統あります。現在はV2（docker compose、スペース）が公式推奨。旧V1（docker-compose、ハイフン）は2023年7月で End of Life、現在は保守もされていません。

4. 向く場面・向かない場面

✅ 向く場面

❌ 向かない場面

5. 最小の動作例

3分で試せる最小例：nginx + Redis を立ち上げるだけ。

5-1. compose.yml を作る

# compose.yml
services:
  web:
    image: nginx
    ports:
      - "8080:80"

  cache:
    image: redis:7-alpine

5-2. 起動

$ docker compose up -d
[+] Running 3/3
 ✔ Network myapp_default  Created
 ✔ Container myapp-cache-1  Started
 ✔ Container myapp-web-1    Started

3つのリソース（ネットワーク + 2つのコンテナ）が自動で作られます。ブラウザで http://localhost:8080 を開くと nginx の Welcome ページが表示されるはずです。

5-3. 一覧と停止

# 起動中のサービス一覧
$ docker compose ps
NAME              IMAGE            STATUS
myapp-cache-1     redis:7-alpine   Up 1 minute
myapp-web-1       nginx            Up 1 minute (ports 0.0.0.0:8080->80/tcp)

# 全部止めて後片付け
$ docker compose down
[+] Running 3/3
 ✔ Container myapp-web-1    Removed
 ✔ Container myapp-cache-1  Removed
 ✔ Network myapp_default    Removed

6. まとめ

参考リンク

• Docker Compose overview（公式） — Compose 全体像の一次情報源。
• Migrate to Compose V2（公式） — V1 からの移行ガイド。

Dockerの基礎を動画で体系的に学びませんか？

実務で使う基礎だけを3時間に凝縮。環境構築から丁寧に解説しています。

クーポン割引で講座を見る →