Docker Compose のインストール

Compose は macOS、Windows、64-bit Linux で実行可能です。

必要条件

Docker Compose は数々の動作を行うために Docker Engine を必要とします。したがって Docker Engine がインストール済であることを確認してください。設定状況に合わせてインストール先はローカルでもリモートでも構いません。

  • Docker for Mac や Docker for Windows のようなデスクトップの場合、Docker Compose はその一部に含まれてすでにインストールされているはずです。

  • Linux システムの場合はまずはじめに、Docker を手に入れるのページに示している各 OS ごとの Docker をインストールします。そしてここの手順に戻り Linux システム向けの Compose をインストールします。

Compose のインストール

Compose を Mac、Windows、Windows Server 2016、Linux にインストールする場合は、以下の手順に従ってください。他の方法として Python パッケージ・マネージャである pip を使う方法や、コンテナとして Compose をインストールする方法もあります。

macOS における Compose のインストール

Docker for MacDocker Toolbox には、Compose も各種 Docker アプリもすべて含んでいます。したがって Mac ユーザは個別に Compose をインストールする必要はありません。Docker のインストール手順は以下となります。

Windows における Compose のインストール

Docker for WindowsDocker Toolbox には、Compose も各種 Docker アプリもすべて含んでいます。したがって Windows ユーザは個別に Compose をインストールする必要はありません。Docker のインストール手順は以下となります。

Docker Engine - Enterprise を使って Microsoft Windows Server 上において Docker デーモンやクライアントを 直接動かしている場合は、Docker Compose をインストールする必要があります。以下の3つの手順を進めてください。

  1. PowerShell を管理者権限で起動します。つまり PowerShell を見つけたら右クリックして 管理者として実行 を選びます。PowerShell がデバイスへの変更をしても良いかどうかを尋ねられたら Yes をクリックします。

PowerShell において以下のコマンドを実行して Docker Compose をダウンロードします。$dockerComposeVersion の部分は、インストールしたい Compose のバージョンに置き換えてください。

Invoke-WebRequest"https://github.com/docker/compose/releases/download/$dockerComposeVersion/docker-compose-Windows-x86_64.exe"-UseBasicParsing-OutFile$Env:ProgramFiles\docker\docker-compose.exe

例えば Compose バージョン 1.16.1 をダウンロードするには、以下のコマンドを実行します。

Invoke-WebRequest"https://github.com/docker/compose/releases/download/1.16.1/docker-compose-Windows-x86_64.exe"-UseBasicParsing-OutFile$Env:ProgramFiles\docker\docker-compose.exe

重要

ダウンロードコマンド内での Compose 最新リリース番号の利用

すでに説明しているように、上に示したコマンドは一つの例ですから、すでに古いリリース番号になっているかもしれません。 コマンドの入力方法は上に示すものと同様に行ってください。 上の例をカット・アンド・ペーストして利用する場合は、必ずリリース番号を確認してください。 そして必要に応じて、$dockerComposeVersion の部分は必要としているリリース番号に書き換えてください。 Compose の各リリースは、GitHub 上にある Compose リポジトリのリリースページ から入手することができます。

  1. 実行モジュールを実行して Compose をインストールします。