docker compose up コマンド入門：オプションの解説と実行例

docker compose up は compose.yaml に定義されたサービスを作成して起動します。Compose の基本は Docker Compose 入門、ほかの compose コマンドは docker compose コマンド を参照してください。

構文

docker compose up [オプション] [サービス名...]

サービスを指定しなければ、すべてのサービスが対象です。up は次の順に処理します：ネットワークの作成、Volume の作成、必要に応じたイメージのダウンロードまたはビルド、コンテナの作成（設定が変わったものは再作成）、コンテナの起動。

オプション

サンプルプロジェクト

services:
  web:
    image: nginx:1.30-alpine
    ports:
      - "8080:80"
    depends_on:
      - cache
  cache:
    image: redis:8-alpine
    volumes:
      - cache_data:/data
  worker:
    image: alpine:3.23
    command: ["sh", "-c", "echo worker done"]

volumes:
  cache_data:

すべてのサービスを起動する

$ docker compose up -d
[+] up 15/15
 ✔ Image redis:8-alpine           Pulled                                                                                                          3.4s
 ✔ Network ref-compose_default    Created                                                                                                         0.0s
 ✔ Volume ref-compose_cache_data  Created                                                                                                         0.0s
 ✔ Container ref-compose-worker-1 Started                                                                                                         0.4s
 ✔ Container ref-compose-cache-1  Started                                                                                                         0.6s
 ✔ Container ref-compose-web-1    Started                                                                                                         0.8s

$ docker compose ps -a
NAME                   IMAGE               COMMAND                  SERVICE   CREATED        STATUS                              PORTS
ref-compose-cache-1    redis:8-alpine      "docker-entrypoint.s…"   cache     1 second ago   Up Less than a second               6379/tcp
ref-compose-web-1      nginx:1.30-alpine   "/docker-entrypoint.…"   web       1 second ago   Up Less than a second               0.0.0.0:8080->80/tcp, [::]:8080->80/tcp
ref-compose-worker-1   alpine:3.23         "sh -c 'echo worker …"   worker    1 second ago   Exited (0) Less than a second ago

worker は echo を実行すると終了するので Exited (0) になります。1 回だけ実行するサービスとしては正常な状態です。

一部のサービスだけを扱う

$ docker compose up -d --no-deps web
[+] up 1/1
 ✔ Container ref-compose-web-1 Running                                                                                                            0.0s

$ docker compose up -d --force-recreate web
[+] up 2/2
 ✔ Container ref-compose-cache-1 Running                                                                                                          0.0s
 ✔ Container ref-compose-web-1   Started                                                                                                          0.4s

$ docker compose up -d --wait cache
[+] up 1/1
 ✔ Container ref-compose-cache-1 Healthy                                                                                                          0.5s

• --no-deps web：web だけを処理し、依存先の cache には触れません。設定に変更がないので Running とだけ表示されます。
• --force-recreate web：設定が変わっていなくても web を再作成します（Started）。--no-deps を付けていないので、depends_on の cache もチェックされます（Running）。
• --wait cache：cache の準備ができるまで待ってから戻ります。redis イメージにはヘルスチェックが定義されていないため、コンテナが実行中であれば準備完了とみなされます。

--scale：複数のレプリカ

$ docker compose up -d --scale worker=3 worker
[+] up 3/3
 ✔ Container ref-compose-worker-3 Started                                                                                                         0.5s
 ✔ Container ref-compose-worker-2 Started                                                                                                         0.3s
 ✔ Container ref-compose-worker-1 Started                                                                                                         0.2s

$ docker compose ps -a worker
NAME                   IMAGE         COMMAND                  SERVICE   CREATED         STATUS                              PORTS
ref-compose-worker-1   alpine:3.23   "sh -c 'echo worker …"   worker    4 seconds ago   Exited (0) Less than a second ago   
ref-compose-worker-2   alpine:3.23   "sh -c 'echo worker …"   worker    1 second ago    Exited (0) Less than a second ago   
ref-compose-worker-3   alpine:3.23   "sh -c 'echo worker …"   worker    1 second ago    Exited (0) Less than a second ago

--scale worker=3 で worker のコンテナが 3 つになり、名前には -1、-2、-3 と自動で番号が付きます。ホストのポートを公開している（ports がある）サービスは、ホストポートが衝突するのでそのままではスケールできません。

--exit-code-from：CI でテストを実行する

$ docker compose up --abort-on-container-exit --exit-code-from worker worker
[+] up 2/2
 ✔ Container ref-compose-worker-2 Removed                                                                                                         0.0s
 ✔ Container ref-compose-worker-3 Removed                                                                                                         0.0s
Attaching to worker-1
worker-1  | worker done
worker-1 exited with code 0
Aborting on container exit...
Container ref-compose-worker-1 Stopping
Container ref-compose-worker-1 Stopped
w Enable Watch   d Detach

• worker だけを実行し、それが終了すると（--abort-on-container-exit）up 全体も終了します。up の終了コードは worker の終了コードになります（--exit-code-from）。CI でテスト用サービスを実行するときに使います：テスト失敗 → コマンド失敗 → CI 失敗。
• 前のステップの --scale で作られた worker-2、worker-3 は今回削除されました（Removed）。レプリカ数を指定しなかったので、デフォルトの 1 つに戻ったためです。

関連する章

• docker compose down
• docker compose コマンド
• compose.yaml の書き方

練習問題

練習問題：サンプルの compose.yaml で web のポートを 8081:80 に変更し、1 つのコマンドで反映してください。また、再作成されたのが web だけであることを確認してください。

docker compose up -d

更新日 2026年10月14日