---
title: "Docker Composeとは｜compose.yamlの書き方と主要コマンド・仕組みをv5.7.1で実測解説"
url: "https://www.issoh.co.jp/tech/details/13282/"
published: 2026-07-08
updated: 2026-11-15
categories: ["Kubernetes・コンテナ"]
publisher: "株式会社一創"
---

# Docker Composeとは｜compose.yamlの書き方と主要コマンド・仕組みをv5.7.1で実測解説

Docker Composeは、Webサーバー・API・データベースのような複数のコンテナを1つのYAMLファイル（`compose.yaml`）に書き、`docker compose up`の1コマンドでまとめて起動・停止するツールです。この記事では、コンテナ同士をつなぐ仕組み、compose.yamlの主要キー、up・down・run・execの使い分け、本番への持ち込み方を、2026年11月15日時点の最新版v5.7.1を実際に動かした結果とあわせて解説します。

## まとめ：Docker Composeの仕組みと書き方の要点（v5.7.1時点）

Docker Composeは、`docker run`を何本も手で打っていた構成を`compose.yaml`に宣言し、同じ環境を誰でも1コマンドで再現できるようにする道具です。`up`を打つと、Composeはディレクトリ名から決まるプロジェクト名で`<プロジェクト名>_default`というネットワークを作り、全サービスをそこへつなぎます。サービス名がそのままホスト名になるため、アプリからDBへは`db`のような名前で接続できます。

コマンドはスペース区切りの`docker compose`を使います。ハイフン付きの`docker-compose`（Python製のV1）は保守が終わっています。最新は2026年11月11日のv5.7.1で、ファイル名は`compose.yaml`が推奨、先頭の`version:`行は警告が出るだけなので省きます。

使いどころは、開発環境の再現、CIでの結合テスト、1台のサーバーで完結する小規模な本番までです。複数ホストへの分散、負荷に応じた自動スケール、無停止のローリング更新のどれかが要件に入ったら、Kubernetesなどのオーケストレーション基盤へ移します。

## Docker Composeの仕組みとDocker単体との違い

Docker本体（Docker Engine）はコンテナを1つずつ作って動かす仕組みで、Composeはその上で複数コンテナの組み合わせを宣言として扱います。Docker本体の入れ方と必要スペックは[Dockerとは｜仮想マシンとの違い・必要スペック・Desktop/Engineの違いとインストール手順【2026年10月】](/tech/details/6857/)で扱っています。

### docker runの手打ちとcompose.yamlの宣言の違い

Docker単体でWebとDBを動かすには、ネットワークを`docker network create`で作り、必要ならボリュームを`docker volume create`で事前作成し（未作成なら次のコマンドで自動作成）、`docker run -d --name db --network app -e POSTGRES_PASSWORD=... -v db-data:/var/lib/postgresql postgres:18`のような長いコマンドをコンテナの数だけ正しい順番で打つ必要があります。Composeでは、この手順をすべて`compose.yaml`に書き、`docker compose up -d`だけで同じ状態を作ります。

手順がファイルになるので、Gitで差分を追え、新しく入ったメンバーも同じ構成を立ち上げられます。Composeが扱うのは「どのコンテナをどうつなぐか」で、イメージの中身はDockerfileが決めます。

| 道具             | 扱う範囲                | 主なコマンド                   |
| -------------- | ------------------- | ------------------------ |
| Dockerfile     | 1つのイメージの中身          | docker build             |
| Docker Engine  | 1つのコンテナの実行          | docker run / exec        |
| Docker Compose | 複数コンテナ・ネットワーク・ボリューム | docker compose up / down |
| Kubernetes     | 複数ホストへの配置と自動復旧      | kubectl apply            |

### プロジェクト名・既定ネットワーク・サービス名による名前解決

Composeは、既定ではcompose.yamlのあるディレクトリ名をプロジェクト名に使い、生成するリソース名の接頭辞やラベルに反映します。プロジェクト名は`-p`、環境変数`COMPOSE_PROJECT_NAME`、トップレベルの`name`で変えられます。[公式のネットワークの解説](https://docs.docker.com/compose/how-tos/networking/)は、`docker compose up`で`<プロジェクト名>_default`というネットワークが作られ、各サービスが内部DNSにサービス名で登録されると説明しています。

`proj`というディレクトリでweb（nginx）とdb（PostgreSQL 18）を起動すると、ネットワーク`proj_default`、ボリューム`proj_db-data`、コンテナ`proj-db-1`・`proj-web-1`が作られ、webの中から`db`の名前で届きました（2026年11月15日、colima上のDocker Engine 29.5.2とCompose v5.7.1で実行。以降の実行結果も同じ環境）。

```
$ docker compose up -d
 Network proj_default Created
 Container proj-db-1 Healthy
 Container proj-web-1 Started
$ docker network ls --filter name=proj
NAME           DRIVER
proj_default   bridge
$ docker compose exec web getent hosts db
172.22.0.2        db  db
```

同じcompose.yamlを1台で2組動かすときもプロジェクト名を変えれば、ネットワークもボリュームも別物として作られます。

### docker-compose（V1）とdocker compose（V2以降）の違いと版番号が5へ飛んだ理由

ハイフン付きの`docker-compose`はPythonで書かれた初代（V1）で、公式の[廃止済みプロダクト一覧](https://docs.docker.com/retired/)に「no longer maintained」として載っています。Docker社は[2023年1月の告知](https://www.docker.com/blog/new-docker-compose-v2-and-v1-deprecation/)でV1のサポートを2023年6月で終えると示しました。後継はGoで書き直されたDocker CLIのプラグインで、`docker compose`（スペース区切り）として呼びます。既存の`docker-compose.yml`もそのまま読めます。

後継の版番号は長く2.x系でしたが、[2025年12月2日のv5.0.0](https://github.com/docker/compose/releases/tag/v5.0.0)で5へ移りました。リリースノートは、V1時代のファイル書式の版数「2.x」「3.x」と混同されないよう3と4を飛ばしたと説明しています。同じv5.0.0で、ビルドはDocker Bakeへ任せる形に変わっています。

その後も[v5.3.0](https://github.com/docker/compose/releases/tag/v5.3.0)で後述の`pre_start`が入り、[v5.7.0](https://github.com/docker/compose/releases/tag/v5.7.0)（11月2日）でサービス属性`umask`が加わるなど、数週間おきに版が出ています。最新の[v5.7.1](https://github.com/docker/compose/releases/tag/v5.7.1)（11月11日）は不具合修正の版です。

## Docker Composeのインストールと版の確認

[公式のインストール案内](https://docs.docker.com/compose/install/)が推奨するのは、Engine・CLI・Composeを同梱したDocker Desktopを入れる方法です。Desktopの無料利用の条件（従業員250人未満かつ年間売上1,000万ドル未満など）は[Docker Desktopのライセンスと導入手順｜無料の条件・料金とWindows/Mac/Linuxへのインストール](/tech/details/17442/)にまとめています。

Desktopを使わずLinuxサーバーにDocker Engineを入れている場合は、[Linux向けのプラグイン導入手順](https://docs.docker.com/compose/install/linux/)に従い、Dockerの公式リポジトリから`docker-compose-plugin`パッケージを入れます。更新も同じコマンドです。

```
# Ubuntu・Debian（Dockerの公式リポジトリを登録済みであること）
sudo apt-get update
sudo apt-get install docker-compose-plugin

# RHEL・Fedora などRPM系
sudo yum update
sudo yum install docker-compose-plugin

# 入ったか・どの版かを確かめる
docker compose version
# Docker Compose version v5.7.1
```

公式は単体バイナリ（standalone）の導入も残していますが「Legacy」の扱いで、呼び出しも`docker-compose`になります。新しく入れるならDesktopかプラグインを選んでください。

## compose.yamlの書き方：services・volumes・networksの主要キー

compose.yamlの書式は[Compose Specification](https://github.com/compose-spec/compose-spec)に従います。トップレベルの要素は`services`（コンテナ）、`volumes`（名前付きボリューム）、`networks`（独自のネットワーク）が中心です。

### ファイル名の優先順位とversion行の扱い

[公式のアプリケーションモデルの解説](https://docs.docker.com/compose/intro/compose-application-model/)は、既定のファイル名を`compose.yaml`（推奨）または`compose.yml`とし、`docker-compose.yaml`・`docker-compose.yml`も後方互換のために読むと定めています。両方を置いて`docker compose config`を打つと、`Found multiple config files`の警告のあと`compose.yaml`が使われました。どちらが効いているか紛らわしいので、古い方は消しておきます。

先頭の`version: "3.8"`のような行は、[versionとnameのリファレンス](https://docs.docker.com/reference/compose-file/version-and-name/)によれば情報としてだけ残されており、Composeは常に最新のスキーマで検証します。v5.7.1では`` the attribute `version` is obsolete, it will be ignored ``と警告が出るだけなので、新しく書くファイルでは省きます。

### サービス定義の主要キー：image・build・ports・environment・command

各サービスには、既存のイメージを使う`image`か、Dockerfileから作る`build`のどちらかを書きます。`ports`は「ホスト側:コンテナ側」の順でポートを公開し、`environment`は環境変数、`command`はイメージ既定の起動コマンドの上書きです。次はweb（Dockerfileで作る自作アプリ）・redis・db（PostgreSQL 18）の3サービスの例です。

```
services:
  web:
    build: .
    command: npm start
    ports:
      - "8080:3000"
    environment:
      DATABASE_URL: postgres://app:secret@db:5432/app
      REDIS_HOST: redis
    depends_on:
      db:
        condition: service_healthy
        restart: true
      redis:
        condition: service_started
  redis:
    image: redis:8-alpine
  db:
    image: postgres:18
    environment:
      POSTGRES_USER: app
      POSTGRES_PASSWORD: secret
      POSTGRES_DB: app
    volumes:
      - db-data:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s
      retries: 5
      start_period: 30s
volumes:
  db-data:
```

`DATABASE_URL`の接続先が`db`になっているのは、前章のとおりサービス名がホスト名になるためです。`$${POSTGRES_USER}`の`$$`は、Composeにファイル読み込み時の変数展開をさせず、コンテナ内のシェルへ`$`のまま渡すための書き方です。パスワードを平文で置いているのは開発用の割り切りで、本番では[secrets](https://docs.docker.com/compose/how-tos/use-secrets/)で渡します。`build: .`が参照するDockerfileの書き方は[Dockerfileとは｜書き方・ファイル名（拡張子）・主要命令とsyntaxの版を実測で解説【2026年10月】](/tech/details/3315/)を見てください。

### サービス側のvolumesとトップレベルのvolumesの違い

compose.yamlには`volumes`が2か所に出てきます。サービスの中の`volumes`は「どこをコンテナのどのパスにつなぐか」、トップレベルの`volumes`は「Composeが管理する名前付きボリュームを作る」宣言です。上の例の`db-data:/var/lib/postgresql`は、トップレベルで宣言した`db-data`をコンテナの`/var/lib/postgresql`へつないでいます。

| 書き方                         | 種類        | 向く用途       |
| --------------------------- | --------- | ---------- |
| db-data:/var/lib/postgresql | 名前付きボリューム | DBのデータ     |
| ./src:/app/src              | バインドマウント  | 開発中のソースコード |
| /tmp/cache（左辺なし）            | 匿名ボリューム   | 使い捨てのキャッシュ |

名前付きボリュームは`<プロジェクト名>_db-data`の名前でDocker側に作られ、コンテナを作り直しても残ります。PostgreSQL 18の公式イメージはデータの置き場所が`/var/lib/postgresql/data`から`/var/lib/postgresql/18/docker`へ変わったため、古い記事の`/var/lib/postgresql/data`をそのまま書くと起動に失敗します。詳細は[Docker PostgreSQL構築の手順｜18で変わったボリューム位置とcompose定義・initdb初期化を実装目線で解説](/tech/details/16976/)で扱っています。

### depends\_onとhealthcheckによる起動順の制御

`depends_on`をサービス名の列挙だけで書く短い形では、Composeは依存先のコンテナが起動したところで次へ進み、中のDBが接続を受け付けるまでは待ちません。[servicesリファレンス](https://docs.docker.com/reference/compose-file/services/)の長い形では、`condition`に次の3つを指定できます。

- `service_started`：起動したら進む（短い形と同じ）
- `service_healthy`：依存先の`healthcheck`が通るまで待つ
- `service_completed_successfully`：依存先が正常終了するまで待つ（マイグレーション用の使い捨てサービス向け）

あわせて`restart: true`を書くと、Composeの操作で依存先を更新したときに依存元も再起動されます（コンテナが落ちて自動再起動した場合は対象外）。`required: false`は、依存先が無くても警告だけで起動を続ける指定です。別途検証したnginxとPostgreSQLの2サービス構成（healthcheckのintervalは2s）をv5.7.1で`up -d`すると、dbが`Waiting`から`Healthy`になってからwebが`Started`になり、全体で約7.5秒でした。

## docker compose upから停止まで：主要コマンドの使い分け

日常で使うコマンドは次のとおりで、どれもcompose.yamlのあるディレクトリで打つか、`-f`でファイルを指定します。

| コマンド                                        | 役割                |
| ------------------------------------------- | ----------------- |
| `docker compose up -d`                      | 全サービスをバックグラウンドで起動 |
| `docker compose ps`                         | サービスの状態と公開ポート     |
| `docker compose logs -f web`                | webのログを追い続ける      |
| `docker compose exec db psql -U app -d app` | 動いているコンテナで実行      |
| `docker compose run --rm web`               | 新しいコンテナで1回だけ実行    |
| `docker compose build`                      | build指定のイメージを作り直す |
| `docker compose config`                     | 重ね合わせ後の最終設定を表示    |
| `docker compose down`                       | コンテナとネットワークを削除    |

### downとdown -vで消えるものの違い

[downのリファレンス](https://docs.docker.com/reference/cli/docker/compose/down/)によれば、既定の`down`が消すのはコンテナと、Composeファイルで定義したネットワークおよび使用中の既定ネットワークで、名前付きボリュームは残ります。`-v`を付けると、トップレベルで宣言した名前付きボリュームとコンテナに付いた匿名ボリュームも消えます。`external`指定のネットワークとボリュームは、どちらの場合も消えません。

dbに1行入れてから確かめると、次のようになりました。`down`のあと`up`し直しても入れた値（42）は読めましたが、`down -v`ではボリューム`proj_db-data`ごと消えています。「DBを初期化したいとき」と「うっかり消してはいけないとき」の分かれ目は`-v`の有無だけなので、本番のサーバーでは`-v`付きのコマンドを履歴から再実行しないよう気を付けてください。

```
$ docker compose exec -T db psql -U app -d app -c "create table t(x int); insert into t values (42);"
$ docker compose down
$ docker volume ls --filter name=proj
local     proj_db-data          # 残っている
$ docker compose up -d
$ docker compose exec -T db psql -U app -d app -tAc "select x from t"
42
$ docker compose down -v
 Volume proj_db-data Removed
```

### runとexecの違い

`exec`は、すでに動いているサービスのコンテナの中でコマンドを実行します。`run`は、そのサービスの設定で新しいコンテナを1つ作り、コマンドを1回だけ実行します。`docker compose run --rm web sh -c 'hostname; getent hosts db'`を打つと、`proj-web-run-6d13924abfb5`という別のコンテナが作られ、依存先のdbが`Healthy`になるのを待ってから実行されました。

[runのリファレンス](https://docs.docker.com/reference/cli/docker/compose/run/)は、もう一つの差として、`run`はサービスに書いた`ports`を公開しないと述べています。動いているwebとポートがぶつからないための仕様で、公開したいときは`--service-ports`を付けます。使い分けは、DBへの接続確認やログの調査なら`exec`、マイグレーションやテストのように使い捨てで回す処理なら`run --rm`です。

## 開発から本番へ：override・profiles・Watch・pre\_startの使いどころ

開発環境を揃える用途では、リポジトリを`git clone`して`docker compose up`を打つだけで、Web・API・DB・キャッシュが揃います。フロントエンドを含む構成の例は[Next.jsをDockerで動かす｜Compose開発環境とstandalone本番イメージを16.4で実測](/tech/details/2840/)、20近いサービスを1ファイルで束ねる規模の例は[Supabaseセルフホストの構成と運用：Envoy移行後のDocker Compose実測](/tech/details/17074/)で追えます。

### compose.override.yamlと-fによる環境別設定の重ね合わせ

Composeは、`compose.yaml`と同じディレクトリに`compose.override.yaml`があれば、指定しなくても自動で重ねて読みます。`environment`の`A: base`を書いた`compose.yaml`に、`A: override`だけを書いた`compose.override.yaml`を置いて`docker compose config`を打つと、最終設定は`A: override`になりました。開発用のバインドマウントやデバッグ用ポートはoverride側に寄せると、本番に持ち込まずに済みます。

本番用の差分は、[公式の本番運用の解説](https://docs.docker.com/compose/how-tos/production/)が示すとおり`compose.production.yaml`のような別ファイルに書き、`-f`で順に重ねます。[複数ファイルの解説](https://docs.docker.com/compose/how-tos/multiple-compose-files/merge/)のとおり、overrideを自動で読むのは`-f`を省いたときだけです。同ページが本番で変える項目に挙げるのは、アプリのコードのバインドマウントを外す、ポートを変える、環境変数を変える、`restart: always`などの再起動ポリシーを付ける、ログ収集のサービスを足す、の5つです。

```
# 共通定義に本番差分を重ねて起動する
docker compose -f compose.yaml -f compose.production.yaml up -d

# 重ねた結果を事前に確かめる
docker compose -f compose.yaml -f compose.production.yaml config

# コードを変えたあとwebだけ作り直す（DBやキャッシュは触らない）
docker compose -f compose.yaml -f compose.production.yaml build web
docker compose -f compose.yaml -f compose.production.yaml up --no-deps -d web
```

### profilesによる開発用サービスの選択とCompose Watchによる変更反映

[profiles](https://docs.docker.com/compose/how-tos/profiles/)は、管理画面やテスト用のサービスを必要なときだけ起動する仕組みです。サービスに`profiles: [debug]`と書くと、通常の`up`では起動せず、`docker compose --profile debug up`か環境変数`COMPOSE_PROFILES=debug`で有効になります。profilesを書いていないサービスは常に起動します。

Compose Watchは、ホスト側のファイルの変更を検知してコンテナへ反映する機能で、サービスの`develop.watch`にルールを書きます。[developのリファレンス](https://docs.docker.com/reference/compose-file/develop/)が定める`action`は5つです。

| action       | 変更を検知したときの動き | 向くファイル             |
| ------------ | ------------ | ------------------ |
| sync         | コンテナへファイルを同期 | ホットリロード対応のソース      |
| rebuild      | イメージを作り直して置換 | package.jsonなど依存定義 |
| sync+restart | 同期してから再起動    | 設定ファイル             |
| sync+exec    | 同期してからコマンド実行 | 同期後に処理が要るもの        |
| restart      | コンテナを再起動     | 同期が不要な変更           |

```
services:
  api:
    build: .
    command: npm start
    develop:
      watch:
        - action: sync
          path: ./api
          target: /src/api
          initial_sync: true
          ignore:
            - node_modules/
        - action: rebuild
          path: package.json
```

起動は`docker compose watch`か`docker compose up --watch`です。`ignore`のパターンは、[Compose Watchの解説](https://docs.docker.com/compose/how-tos/file-watch/)によればプロジェクトの直下からではなく、そのルールの`path`からの相対で解釈されます。上の例の`node_modules/`は`./api/node_modules/`を指します。エディタごと環境を揃えたいなら[Dev Container（devcontainer）のメリットとは](/tech/details/3728/)の仕組みと組み合わせられます。

### pre\_startによるサービス起動前のマイグレーション

`pre_start`はv5.3.0で入った初期化コンテナの仕組みです。[servicesリファレンス](https://docs.docker.com/reference/compose-file/services/)によれば、各ステップは使い捨てのコンテナで宣言順に最後まで実行され、すべて終了コード0で終わったときだけサービスのコンテナが起動します。ステップは`depends_on`の条件を満たしたあとに、サービスと同じネットワークとボリュームで動くので、マイグレーションや権限調整に向きます。

```
services:
  app:
    image: myapp:latest
    depends_on:
      db:
        condition: service_healthy
    pre_start:
      - command: ["./manage.py", "migrate"]
      - image: busybox:1.37
        command: ["sh", "-c", "chown -R 1000:1000 /data"]
    volumes:
      - data:/data
  db:
    image: postgres:18
    environment:
      POSTGRES_PASSWORD: development-only
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
      interval: 2s
      timeout: 5s
      retries: 10
volumes:
  data:
```

`image`を省いたステップはサービス本体と同じイメージで動きます。指定できるのはほかに`user`・`privileged`・`working_dir`・`environment`・`per_replica`です。一度成功したステップは、定義が変わるかサービスが作り直されるまで、次の`up`でも再起動ポリシーによる再起動でも走りません。

ステップを`exit 3`で終わるように書き換えて`up -d`すると、`pre_start[0] exited with code 3`と表示され、サービスのコンテナは`Created`のまま起動しませんでした。失敗したステップのコンテナは調査用に残る（`retained for inspection`）ので、`docker logs`で原因を見たら手で消します。v5.3.0より前のComposeでは使えないため、チームとCIの版を先に揃えてください。

## Docker Composeで足りる範囲とKubernetesへ移す境界

Composeは1台のホストの中で完結する道具です。移行するかどうかは、規模ではなく要件で決めます。

### Composeのまま運用してよい条件

次をすべて満たすなら、Composeのまま運用して差し支えありません。

- アプリケーションが1台のホストに収まり、台数を増やして負荷を分ける要件がない
- 数分程度の停止を許容でき、無停止での入れ替えまでは求められない
- compose.yamlから依存関係と運用手順を把握でき、担当者が構成変更を管理できる
- 開発・検証環境、CIの結合テスト、社内向けや小規模なサービスの本番である

落ちたコンテナの自動復旧は`restart`ポリシー（`no`・`always`・`on-failure`・`unless-stopped`）に頼るだけで、サーバー自体が止まれば全サービスが止まります。CIで使う場合は、[GitHub Actionsのサービスコンテナ（services）](/tech/details/16961/)で同じ構成を組む方法もあります。

### Kubernetesへ移す条件とComposeでよくある失敗

前の節の条件が1つでも外れたら、オーケストレーション基盤への移行を検討します。[Kubernetesの公式概要](https://kubernetes.io/docs/concepts/overview/)は、自己修復や自動ロールアウトを機能に挙げています。移行先の全体像は[Kubernetes（クバネティス）とは？仕組み・メリット・デメリットとDockerとの違いをわかりやすく解説](/tech/details/2928/)、判断の軸は[コンテナオーケストレーションとは？仕組み・ツール比較と料金、自社に要るかの判断](/column/details/13003/)にまとめています。クラウド上でのコンテナ基盤の設計や移行を相談したい場合は、[AWS・Google Cloud・Azureのインフラ構築支援](https://www.issoh.co.jp/service/system/aws/)で構成の検討から相談できます。

Composeで避けたい失敗は、開発用のcompose.yamlをデバッグ用ポートや平文のパスワードごと本番へ持ち込むことで、override・`-f`で差分を分ければ防げます。ホストのCPUやメモリを使い切っている場合は、`--scale`でコンテナ数を増やしてもホスト全体の計算資源は増えません。ホストに余力があり、単一プロセスがボトルネックの場合は、同一ホスト内の増設が有効なこともあります。そうなったら移行の時期です。

## Docker Composeに関するよくある質問

### DockerとDocker Composeの違いは何ですか？

Docker Engineはコンテナを1つずつ実行する基盤で、Docker Composeは複数コンテナの構成と起動順をcompose.yamlで宣言してまとめて扱うツールです。

### docker-composeとdocker composeの違いは何ですか？

ハイフン付きはPython製で保守が終わったV1、スペース区切りはGo製の現行版です。既存の`docker-compose.yml`は読めますが、コンテナ名の区切りが`proj_db_1`から`proj-db-1`のようにハイフンへ変わるため、名前を決め打ちしたスクリプトは移行時に直します。

### Docker ComposeとKubernetesの違いは何ですか？

Composeは1台のホストの中で複数コンテナを動かす道具で、Kubernetesは複数ホストへの配置・自動復旧・自動スケールまで担う基盤です。

### Docker Composeはどうやってインストールしますか？

Docker Desktopを入れれば、Windows・macOS・Linuxのどれでも同梱されています。Desktopを使わないLinuxでは、Dockerの公式リポジトリを登録したうえで`sudo apt-get install docker-compose-plugin`（RPM系は`yum`）を実行し、`docker compose version`で版を確かめます。

### compose.yamlとdocker-compose.ymlはどちらを使うべきですか？

新しく作るなら`compose.yaml`です。`docker-compose.yml`も後方互換で読まれるので既存のファイルを急いで改名する必要はありませんが、両方を同じディレクトリに置くと`compose.yaml`が優先され警告が出ます。改名するなら古い方は消してください。

## 関連記事

- [Dockerとは｜仮想マシンとの違い・必要スペック・Desktop/Engineの違いとインストール手順【2026年10月】](/tech/details/6857/)
- [Dockerの仕組みを図解：containerd・runc・namespaces・ネットワーク・Composeの内部を実測で解説](/tech/details/2661/)
- [Dockerfileとは｜書き方・ファイル名（拡張子）・主要命令とsyntaxの版を実測で解説【2026年10月】](/tech/details/3315/)
- [DockerでMySQLを構築する手順｜latestが26系へ変わったタグ選定とcompose定義・初期化を実装目線で解説](/tech/details/17642/)
- [Kubernetes（クバネティス）とは？仕組み・メリット・デメリットとDockerとの違いをわかりやすく解説](/tech/details/2928/)

---

出典: [Docker Composeとは｜compose.yamlの書き方と主要コマンド・仕組みをv5.7.1で実測解説](<https://www.issoh.co.jp/tech/details/13282/>)（株式会社一創）
