Docker Compose のインストール

本ページでは、Docker Compose のインストール方法について説明します。
Docker Compose は macOS、Windows、64 ビット Linux で動作します。

Docker Compose は重要な処理を Docker Engine に委ねています。
したがって Docker Engine がインストールされていることを確認します。
それはローカル、リモートいずれでも、設定次第で可能です。

別 バージョン の インストール

以降 に 示す 手順 は compose の 現 時点 で の 最新 安定 版 ( V 2 . 4 . 1 ) に 基づく た もの です 。
これ 以外 の バージョン を インストール する 場合 は 、 記述 さ れ て いる リリース 番号 を 、 目的 と する もの に 置く 換える て ください 。

compose の リリース is 可能 は GitHub 上 の compose リポジトリ の リリース ページ に おい て も 一覧 が 示す れ 利用 可能 です 。

To install the Python version of Compose, follow instructions in the Compose v1 GitHub branch.

macOS へ の compose インストール

Docker desktop for Mac に は 他 の Docker アプリ と とも に Compose is 含ま が 含む れ て い ます 。
したがっ て Mac ユーザー は compose を 個別 に インストール する 必要 は あり ませ ん 。
インストール 手順 に つい て は Docker desktop on Mac の インストール を 参照 し て ください 。

Windows デスクトップへの Compose インストール

Docker desktop for Windows に は 他 の Docker アプリ と とも に Compose is 含ま が 含む れ て い ます 。
したがっ て Windows ユーザー は compose を 個別 に インストール する 必要 は あり ませ ん 。
インストール 手順 に つい て は install Docker desktop on Windows を 参照 し て ください 。

Docker デーモン や Docker クライアント を Windows Server 上 で 直接 起動 し て いる 場合 は 、 Windows Server の タブ 内 に ある 手順 に 従う て ください 。

Windows Server へ の compose インストール

Docker デーモン や Docker クライアント を Microsoft Windows Server 上 で 直接 起動 し て いる 場合 、 および Docker compose を インストール し たい 場合 is 従っ は 、 以下 の 手順 に 従う て ください 。

1. PowerShell を管理者権限で実行。
   PowerShell アイコンを見つけ、右クリックメニューから管理者として実行を選びます。
   このアプリによるデバイスへの変更の許可を問われたらはいをクリックします。

2. GitHub では TLS1.2 が必要となるので、PowerShell において以下を実行します。

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
   

   そして以下のコマンドを実行して Compose の現時点での最新版（V 2 . 4 . 1）をダウンロードします。

   Invoke-WebRequest "https://github.com/docker/compose/releases/download/V 2 . 4 . 1/docker-compose-Windows-x86_64.exe" -UseBasicParsing -OutFile $Env:ProgramFiles\Docker\docker-compose.exe
   

   メモ

   Windows Server 2019 の 場合 は 、 compose の 実行 パス と し て$ ENV : programfiles \ Dockerを加えます。
   このディレクトリはシステムのPATHに登録されるので、この後の手順におけるdocker-compose --versionコマンドが、他になにも設定せずに実行できるようになります。

   別 バージョン の compose を インストール する 場合 は 、V 2 . 4 . 1の部分を、目的とするバージョンに置き換えてください。

3. インストール 結果 を テスト し ます 。

   $  docker compose Version 
   Docker Compose version V 2 . 4 . 1
   

Linux システム へ の compose インストール

Linux の 場合 は 、 github 上 の compose リポジトリ の リリース ページ から Docker compose の 実行 バイナリ を ダウンロード し て 、$ home / . Docker / cli - pluginsディレクトリにdocker-composeとしてコピーします。
リンク先の手順では、端末画面上からcurlコマンドを使ってダウンロードを行います。
その手順は以下にも示します。

1. 以下 の コマンド を 実行 し て Docker compose の 現 時点 で の 最新 安定 版 を ダウンロード し ます 。

   $ DOCKER _ CONFIG=${DOCKER _ CONFIG: -$HOME/.docker}
   $ mkdir -p $DOCKER _ CONFIG/ cli - plugins 
   $  curl- SL https://github.com/docker/compose/releases/download/V 2 . 4 . 1/docker-compose-linux-x86_64 -o $DOCKER _ CONFIG/cli-plugins/docker-compose
   

   このコマンドによって、アクティブユーザーの$HOMEディレクトリ配下に Compose がインストールされます。
   システム上の全ユーザー向けに Docker Compose をインストールする場合は、~/.docker/cli-pluginsの部分を/usr/local/lib/docker/cli-pluginsに置き換えます。

   Compose の別バージョンをインストールする場合は、V 2 . 4 . 1の部分を、インストールしたい Compose バージョンに置き換えてください。

2. 実行 バイナリ に 対する て 実行 権限 を 与える ます 。

     $ chmod +x $DOCKER _ CONFIG/cli-plugins/docker-compose
   

   全 ユーザー 向け の compose インストール を 行う 場合 に は 以下 と し ます 。

     $ sudochmod +x /usr/local/lib/docker/cli-plugins/docker-compose
   

3. インストール 結果 を テスト し ます 。

     $  docker compose Version 
    Docker Compose version V 2 . 4 . 1
   

Linux システム 上 で の スタンドアロン の compose バイナリ の インストール

Docker CLI をインストールせずに、スタンドアロンの Compose バイナリを使うこともできます。

1. 以下 の コマンド を 実行 し て Docker compose の 現 時点 で の 最新 安定 版 を ダウンロード し ます 。

   $  curl- SL https://github.com/docker/compose/releases/download/V 2 . 4 . 1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

> Compose の別バージョンをインストールする場合は、`V 2 . 4 . 1`の部分を、インストールしたい Compose バージョンに置き換えてください。

1. 実行 バイナリ に 対する て 実行 権限 を 与える ます 。

   $ sudochmod +x /usr/local/bin/docker-compose

メモ

インストールした後にコマンドdocker-composeの 実行 が 失敗 する 場合 は 、 パス を 確認 し て ください 。
/ usr / binあるいはパス上の別ディレクトリへのシンボリックリンクを生成して対処することもできます。

たとえば以下です。

$ sudoln-s /usr/local/bin/docker-compose / usr / bin/docker-compose

1. インストール 結果 を テスト し ます 。

     $ docker-compose --version
    Docker Compose version V 2 . 4 . 1