Docker Composeとは何か、またなぜ使うのか？

Question

Accepted Answer

**Docker Compose**は、単一のYAMLファイルを使用して**マルチコンテナアプリケーション**を定義および実行するツールです。多くの`docker run`コマンドを手動で実行する代わりに、すべてのサービス（アプリ、データベース、キャッシュ）を`docker-compose.yml`で説明し、1つのコマンドで一緒に起動します。

## Composeが解決する問題

```text
A real app often has MULTIPLE containers: a web app + a database + a cache + ...
  → manually running each with docker run (ports, networks, volumes, env, dependencies)
    is tedious, error-prone, and hard to reproduce/share
→ Compose defines the WHOLE stack in one file → start it all with one command.
```

## docker-compose.ymlの例

```yaml
services:
  web:
    build: .                    # build from the local Dockerfile
    ports:
      - "3000:3000"             # map ports
    environment:
      - DATABASE_URL=postgres://db:5432/myapp
    depends_on:
      - db                       # start db before web
  db:
    image: postgres:16           # use a prebuilt image
    environment:
      - POSTGRES_PASSWORD=secret
    volumes:
      - dbdata:/var/lib/postgresql/data   # persist the database
volumes:
  dbdata:
```

1つのファイルがすべてのサービス、イメージ/ビルド、ポート、環境変数、ボリューム、依存関係を定義します。また、サービスはネットワークを共有し、サービス名（例：`db`）で互いに到達できます。

## スタックの実行

```bash
docker compose up -d        # build and start ALL services (in the background)
docker compose ps           # list the running services
docker compose logs -f      # view logs from all services
docker compose down         # stop and remove everything
docker compose down -v      # also remove volumes
```

## なぜ重要なのか

Docker Composeを理解することは価値があります。実際のアプリケーションはほぼ常に**複数のコンテナ**を含みますし、Composeはそれらを管理するための標準ツールであるため、実用的な知識として重要です。

解決する問題は現実的です。典型的なアプリケーションには複数のサービス（Webアプリ、データベース、キャッシュ、メッセージキューなど）があり、別々の`docker run`コマンドで各サービスを手動で実行する場合、ポート、ネットワーク、ボリューム、環境変数、起動順序を設定する必要があり、退屈で、エラーが起きやすく、再現や共有が難しいです。**Compose**はこれに対処し、**マルチコンテナスタック全体を1つの宣言的なYAMLファイルで定義**し、単一のコマンド（`docker compose up`）ですべてを起動することで、マルチコンテナアプリケーションの実行、再現、共有を容易にします。

`docker-compose.yml`の構造（サービスを定義し、イメージ/ビルド、ポート、環境変数、ボリューム、依存関係を設定し、サービスが自動的にネットワークされ、名前で到達可能になること）と主要なコマンド（`up`、`down`、`ps`、`logs`）を理解することは、開発やマルチサービスアプリケーションの実行における実用的で日常的な知識です。

Composeは特に**ローカル開発環境**（アプリをデータベースと依存関係と一緒に1つのコマンドで起動する）やアプリケーションスタックを再現可能に定義する際に価値があります。

実際のアプリケーションはほぼ常にマルチコンテナであり、Docker Composeはそれらを簡潔に定義および実行するための標準で広く使用されているツール（退屈な手動オーケストレーションを1つの宣言的なファイルとコマンドで置き換える）であるため、Docker Composeを理解することは、マルチコンテナアプリケーションを使用する際に価値があり、頻繁に応用される知識です。これは、非自明なコンテナ化されたアプリケーションにおいて、Dockerの実質的な相棒であり、開発ワークフローに遍在するツールです。