docker compose 主要コマンド完全ガイド｜up/down/ps/logs/exec/build の使い方

6-2 で compose.yml の書き方を押さえました。今回はそれを動かすコマンド群。日常使うのはせいぜい8個です。

目次

1. 主要コマンド一覧
2. up / down
3. ps / logs
4. exec / run
5. build / pull
6. start / stop / restart
7. config / ls
8. プロジェクト名と -p
9. まとめ

1. 主要コマンド一覧

2. up / down

2-1. up の定番オプション

# 前景（ログが画面に流れる、Ctrl+Cで停止）
docker compose up

# バックグラウンド（実務ほぼ常にこれ）
docker compose up -d

# ビルドも強制
docker compose up -d --build

# 特定のサービスだけ起動
docker compose up -d web cache

# 変更のあったコンテナだけ再作成
docker compose up -d --force-recreate

# スケール（同じサービスを N 個起動）
docker compose up -d --scale web=3

2-2. down の危険ゾーン

# 基本：コンテナとネットワークを削除（ボリュームは残る）
docker compose down

# 危険：ボリュームも一緒に削除（DBデータが消える！）
docker compose down -v

# イメージも削除
docker compose down --rmi local
docker compose down --rmi all

3. ps / logs

# 起動中サービスの一覧
$ docker compose ps
NAME              IMAGE           STATUS         PORTS
myapp-db-1        postgres:16     Up 1 minute    5432/tcp
myapp-web-1       nginx           Up 1 minute    0.0.0.0:8080->80/tcp

# 停止中も含めて表示
docker compose ps -a

# 全サービスのログを時系列表示
docker compose logs

# リアルタイム追跡（重要！）
docker compose logs -f

# 特定サービスだけ
docker compose logs -f web

# 直近100行だけ
docker compose logs --tail=100 web

4. exec / run — 違いを理解する

# 稼働中 db コンテナに psql で入る
docker compose exec db psql -U postgres

# 新コンテナを1つ立てて単発コマンド（終了後は自動削除しない）
docker compose run --rm app python manage.py migrate

# 新コンテナで対話シェル
docker compose run --rm app bash

5. build / pull

# 全サービスのイメージをビルド
docker compose build

# キャッシュを使わずに完全ビルド
docker compose build --no-cache

# 特定サービスだけビルド
docker compose build app

# 全イメージを最新に更新
docker compose pull

# 特定サービスのイメージだけ更新
docker compose pull db

6. start / stop / restart

# 停止（コンテナは残る）
docker compose stop

# 停止していたものを再開（up と違い、新規作成はしない）
docker compose start

# 再起動
docker compose restart

# 特定サービスのみ
docker compose restart app

7. config / ls

config：YAMLの検証＋合成結果

# 構文エラー確認＋環境変数展開済みの最終形を表示
docker compose config

# サービス名だけ一覧
docker compose config --services

# 環境変数一覧
docker compose config --environment

ls：全プロジェクト一覧

$ docker compose ls
NAME        STATUS       CONFIG FILES
myapp       running(3)   /home/me/myapp/compose.yml
another     running(2)   /home/me/another/compose.yml

8. プロジェクト名と -p

Compose はカレントディレクトリ名をプロジェクト名（コンテナ名・ネットワーク名の接頭辞）として自動で使います。これを明示的に変更したいときは -p：

# デフォルト: ディレクトリ名「myapp」
$ docker compose up -d
# → コンテナ名は myapp-web-1 等

# 明示指定
$ docker compose -p production up -d
# → コンテナ名は production-web-1 等

# 環境変数 COMPOSE_PROJECT_NAME でもOK
$ export COMPOSE_PROJECT_NAME=staging
$ docker compose up -d

9. まとめ

参考リンク

• docker compose CLI reference（公式） — 全サブコマンドの一次情報源。

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

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

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