compose.yml 完全ガイド｜services / networks / volumes / configs / secrets の書き方

6-1 で Compose の全体像と最小例を押さえました。ここでは compose.yml の構造そのものを、主要キー別に整理します。「どこに何を書けばいいか」を一望できる辞書記事です。

目次

1. ファイル名と自動検索
2. トップレベル5つのキー
3. services の基本プロパティ
4. build vs image
5. networks を明示する
6. volumes を明示する
7. configs / secrets
8. フル機能例
9. まとめ

1. ファイル名と自動検索

docker compose up はカレントディレクトリから以下の順でファイルを探します。

# 明示的にファイルを指定
docker compose -f my-compose.yml up

# 複数ファイルの合成（後から指定したものが上書き）
docker compose -f compose.yml -f compose.override.yml up

2. トップレベル5つのキー

# compose.yml の全体構造（全てが同じファイル内）
services:    # コンテナ定義（必須）
  ...
networks:    # カスタムネットワーク定義（任意）
  ...
volumes:     # Named Volume 定義（任意）
  ...
configs:     # 設定ファイル配布（任意）
  ...
secrets:     # 機密情報配布（任意）
  ...

3. services の基本プロパティ

services:
  web:
    image: nginx:1.27                 # 使うイメージ
    container_name: myweb             # コンテナ名（省略可：自動で <project>-web-1 等）
    ports:                            # -p 相当
      - "8080:80"
    volumes:                          # -v 相当
      - ./html:/usr/share/nginx/html:ro
    environment:                      # -e 相当（dict または list）
      ENV: production
      LOG_LEVEL: info
    env_file:                         # ファイルから環境変数を読み込む
      - .env
    depends_on:                       # 起動順（6-4 で深掘り）
      - db
    restart: unless-stopped           # 停止時の再起動ポリシー
    networks:                         # 参加ネットワーク
      - app-net
    command: ["nginx", "-g", "daemon off;"]   # デフォルトコマンドを上書き
    healthcheck:                      # ヘルスチェック（6-4）
      test: ["CMD", "curl", "-f", "http://localhost/"]
      interval: 30s
      timeout: 3s
      retries: 3

4. build vs image

image: は既存イメージを引いてくるだけですが、build: を使うとCompose 起動時に Dockerfile からビルドできます。

# シンプル：Dockerfile がカレントにある
services:
  app:
    build: .

# 詳細指定
services:
  app:
    build:
      context: ./app          # Dockerfile のあるディレクトリ
      dockerfile: Dockerfile   # ファイル名（デフォルトは Dockerfile）
      args:                    # ビルド時変数
        VERSION: "1.2.3"
      target: production       # マルチステージの対象ステージ

# build と image を併用（ビルド結果に名前を付ける）
services:
  app:
    build: .
    image: myapp:latest

5. networks を明示する

services:
  app:
    networks:
      - frontend
      - backend
  db:
    networks:
      - backend       # db は backend のみに参加（app→db は通るが、proxy→db は通らない）
  proxy:
    networks:
      - frontend

networks:
  frontend:           # シンプル定義（デフォルトは bridge）
  backend:
    driver: bridge
    ipam:
      config:
        - subnet: 172.28.0.0/16

省略した場合、Compose はプロジェクト名_default という名前のカスタムブリッジを自動作成し、すべてのサービスを参加させます。単純な構成なら何も書かなくて大丈夫。

6. volumes を明示する

services:
  db:
    image: postgres:16
    volumes:
      - pgdata:/var/lib/postgresql/data      # Named Volume
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro  # Bind Mount

volumes:
  pgdata:               # ここに書けば Named Volume として宣言される
  # 外部で作成済みのものを参照
  # shared-vol:
  #   external: true

トップレベルの volumes: に書いた名前は、Compose が自動で <プロジェクト名>_pgdata として作成します。

7. configs / secrets

設定ファイル・機密情報を複数サービスで安全に共有するための仕組みです。bind mount と似ていますが、より構造化された管理が可能。

services:
  app:
    configs:
      - source: app_config
        target: /etc/app/config.yml
    secrets:
      - db_password

configs:
  app_config:
    file: ./config.yml

secrets:
  db_password:
    file: ./secrets/db_password.txt   # コンテナ内 /run/secrets/db_password として読める

8. フル機能例

これまでの要素を盛り込んだ、実戦に近いサンプル：

services:
  proxy:
    image: nginx:1.27
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - app
    networks:
      - frontend

  app:
    build:
      context: ./app
      target: production
    environment:
      DATABASE_URL: postgres://postgres:${DB_PASSWORD}@db:5432/postgres
      REDIS_URL: redis://cache:6379
    depends_on:
      db:
        condition: service_healthy
      cache:
        condition: service_started
    networks:
      - frontend
      - backend

  db:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      retries: 10
    networks:
      - backend

  cache:
    image: redis:7-alpine
    networks:
      - backend

volumes:
  pgdata:

networks:
  frontend:
  backend:

9. まとめ

参考リンク

• Compose file reference（公式） — 全キー・全オプションの一次情報源。
• Services top-level element（公式） — services 配下プロパティの詳細。

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

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

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