
Docker Composeは、Webサーバーやデータベースなど複数のコンテナで連携するアプリケーションを一元的に定義し、コマンド1つで起動・停止・管理するための不可欠なツールです。
長年使われてきたPython製の「Docker Compose v1(ハイフン付きの docker-compose コマンド)」はすでにサポートが終了(EOL)しており、現在はGo言語で再設計された公式CLIプラグイン版「Docker Compose v2(スペース区切りの docker compose コマンド)」が標準となっています。
本記事では、UbuntuやWSL2環境へのDocker Compose v2のインストール手順(APTリポジトリ経由および手動バイナリ配置)、旧v1からの変更点、互換エイリアスの設定方法、基本的な使い方までを体系的に解説します。
目次
- Docker Compose v2とは?旧v1との主な違い
- インストール方法1:APTリポジトリからの導入(推奨)
- インストール方法2:バイナリの手動ダウンロードによる導入
- バージョンの確認と動作テスト
- 旧コマンド(docker-compose)との互換エイリアス設定
- Compose v2の基本的な使い方とポイント
- まとめ:Compose v2へ移行して快適な開発環境を構築しよう
- 参考情報
- 次に読むおすすめ記事
Docker Compose v2とは?旧v1との主な違い
Docker Compose v2は、Docker公式が開発・保守を行う現代の標準Compose環境です。旧v1と比較して以下の大きな違いがあります。
- 実装言語の変更:旧v1はPython製でしたが、v2はGo言語で開発されており、Docker CLIと統合されて高速に動作します。
- コマンド体系の統合:旧v1は独立したバイナリ
docker-composeでしたが、v2はDockerのサブコマンドdocker composeとして動作します。 - 設定ファイル仕様の進化:最上位の
version:記述が非推奨となり、省略可能になりました(Compose Specificationに準拠)。 - サポート状況:Compose v1は2023年7月をもって公式サポートが終了しているため、セキュリティの観点からもv2への移行が必須です。
インストール方法1:APTリポジトリからの導入(推奨)
UbuntuやDebian、WSL2上のUbuntu環境では、Docker公式リポジトリからパッケージマネージャー経由でインストールするのが最も推奨されます。パッケージの自動更新や依存関係の管理が容易になるためです。
1. パッケージリストの更新
Docker公式リポジトリが設定されている環境で、パッケージリストを更新します。
sudo apt-get update
2. Composeプラグインのインストール
以下のコマンドで docker-compose-plugin をインストールします。
sudo apt-get install -y docker-compose-plugin
これだけで、Docker CLIのサブコマンドとして docker compose が利用可能になります。
インストール方法2:バイナリの手動ダウンロードによる導入
パッケージマネージャーが使えない環境や、特定のバージョンをピンポイントで利用したい場合は、GitHubの公式リポジトリからバイナリを直接ダウンロードして配置します。
1. プラグインディレクトリの作成
現在のユーザー専用に導入する場合は、~/.docker/cli-plugins ディレクトリを作成します。
DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins
2. バイナリのダウンロードと配置
GitHubのリリースから、アーキテクチャに合わせた最新バイナリをダウンロードします。
curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-$(uname -m) -o $DOCKER_CONFIG/cli-plugins/docker-compose
3. 実行権限の付与
ダウンロードしたバイナリに実行権限を付与します。
chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
なお、システム全体(全ユーザー)にインストールしたい場合は、保存先を /usr/local/lib/docker/cli-plugins/docker-compose に変更して sudo で実行してください。
バージョンの確認と動作テスト
インストールが完了したら、バージョン確認コマンドを実行します。
docker compose version
実行結果として以下のように表示されれば、正常にCompose v2が導入されています。
Docker Compose version v2.33.0
旧コマンド(docker-compose)との互換エイリアス設定
既存のビルドスクリプトやMakefile、習慣でハイフン付きの docker-compose を実行してしまう場合、コマンドが見つからないエラー(command not found)になることがあります。
その場合は、シェルの設定ファイル(~/.bashrc や ~/.zshrc)にエイリアスを追記しておくと便利です。
echo "alias docker-compose='docker compose'" >> ~/.bashrc
source ~/.bashrc
これで、docker-compose up と入力しても自動的に docker compose up に変換されて正常に実行されるようになります。
Compose v2の基本的な使い方とポイント
Compose v2の基本的な操作フローは旧v1とほぼ共通ですが、コマンドの指定方法と設定ファイルの記述において以下のポイントを押さえておきましょう。
1. compose.yaml の推奨ファイル名
以前は docker-compose.yml が一般的でしたが、Compose Specificationでは compose.yaml が第一候補の標準ファイル名として推奨されています(従来の docker-compose.yml も引き続きサポートされます)。
また、ファイル先頭の version: '3.8' のようなバージョン指定は記述不要です。
services:
web:
image: nginx:alpine
ports:
- "8080:80"
2. よく使う日常コマンド
日常の開発で頻繁に利用する基本コマンドは以下の通りです。
- バックグラウンドでコンテナ群を起動する:
docker compose up -d - 実行中のコンテナ一覧と状態を確認する:
docker compose ps - コンテナのログをリアルタイム追尾する:
docker compose logs -f - コンテナ群とネットワークを安全に停止・削除する:
docker compose down - コンテナの再ビルドを行う:
docker compose build
まとめ:Compose v2へ移行して快適な開発環境を構築しよう
Docker Compose v2は、Docker CLIとの完全な統合とGo言語による高速動作、設定ファイルの簡素化により、日々のコンテナ開発をより快適にしてくれます。
旧v1の環境を使い続けている方は、この機会に公式プラグイン方式のCompose v2へアップデートし、安全で最新のDocker開発環境を整備しましょう。
参考情報
- Docker Documentation – Install Docker Compose
- Docker Documentation – Migrate to Compose V2
- Docker Documentation – Compose file reference
次に読むおすすめ記事
Docker Composeの準備が整ったら、実際にComposeを使ってデータベースコンテナを起動し、GUIツールから接続する実践ガイドもご覧ください。

