Docker Composeのインストール方法:Debian編
Docker Composeは、複数のコンテナを定義して管理できるツールで、特に複数のサービスが連携するアプリケーションを扱う際に非常に便利です。この記事では、Debian環境にDocker Composeをインストールする手順を詳しく解説します。
必要な前提条件
Docker Composeをインストールするためには、まずDocker自体がインストールされている必要があります。したがって、Docker Composeをインストールする前に、Dockerがインストールされていない場合は、Dockerを先にインストールしてください。

Dockerのインストール方法
-
まず、Dockerのパッケージをインストールするために、Debianのリポジトリを更新します。
bashsudo apt update
-
次に、必要な依存パッケージをインストールします。
bashsudo apt install apt-transport-https ca-certificates curl software-properties-common
-
Dockerの公式GPGキーを追加します。
bashcurl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
-
Dockerのリポジトリを追加します。
bashsudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
-
パッケージリストを更新し、Dockerをインストールします。
bashsudo apt update sudo apt install docker-ce
-
Dockerが正常にインストールされたことを確認します。
bashsudo systemctl status docker
このコマンドで、Dockerサービスが正常に稼働しているか確認できます。
Dockerがインストールされていることを確認したら、次にDocker Composeをインストールします。
Docker Composeのインストール手順
Docker Composeは、Python製のツールで、公式のリリースをGitHubから直接ダウンロードする方法が一般的です。以下の手順に従ってインストールします。
1. Docker Composeの最新バージョンを確認
Docker Composeの最新バージョンはGitHubのリリースページで確認できます。ここでは、例として「1.29.2」を使用しますが、最新の安定版を確認して使用してください。
bashVERSION="1.29.2" # 最新バージョンを指定
2. バイナリファイルをダウンロード
指定したバージョンのDocker Composeのバイナリファイルをダウンロードします。
bashsudo curl -L "https://github.com/docker/compose/releases/download/$VERSION/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
3. ダウンロードしたファイルに実行権限を付与
ダウンロードしたファイルに実行権限を付与します。
bashsudo chmod +x /usr/local/bin/docker-compose
4. インストールが成功したか確認
インストールが成功したかどうかを確認するため、以下のコマンドを実行します。
bashdocker-compose --version
このコマンドで、インストールされたDocker Composeのバージョンが表示されれば、正常にインストールされたことが確認できます。
Docker Composeの基本的な使用方法
Docker Composeをインストールした後、基本的な使用方法について簡単に触れておきます。
1. docker-compose.yml
ファイルの作成
Docker Composeを使用するには、サービス定義を記述するために docker-compose.yml
という設定ファイルを作成します。例えば、以下は簡単なWebアプリケーションの設定例です。
yamlversion: '3'
services:
web:
image: nginx:latest
ports:
- "8080:80"
この例では、Nginxのコンテナをポート8080で起動する設定です。
2. Docker Composeのコマンド
docker-compose.yml
ファイルを作成したら、以下のコマンドを使ってコンテナを起動したり停止したりできます。
-
コンテナの起動:
bashdocker-compose up
-
コンテナのバックグラウンド起動:
bashdocker-compose up -d
-
コンテナの停止:
bashdocker-compose down
これらの基本的なコマンドを使って、サービスの管理ができます。
トラブルシューティング
Docker Composeをインストールして使用している際に発生する一般的な問題とその解決方法をいくつか紹介します。
1. 実行権限がない
もし docker-compose
コマンドを実行した際に「権限がない」とエラーが出た場合、実行権限が正しく設定されていない可能性があります。以下のコマンドで実行権限を再確認してください。
bashsudo chmod +x /usr/local/bin/docker-compose
2. バージョン確認エラー
docker-compose --version
でバージョン情報が表示されない場合、インストール時に何らかの問題があった可能性があります。この場合、再度インストール手順を確認し、バージョンを再指定してインストールを行ってください。
まとめ
Docker ComposeをDebianにインストールする方法を説明しました。Docker Composeは複数のコンテナを簡単に管理できる強力なツールです。これで、あなたの開発環境におけるコンテナ管理がより効率的になり、複数のサービスを簡単に連携させることができるようになります。
是非、この記事の手順を参考にして、Docker Composeのインストールを試みてください。