前書き
Dockerは、ソフトウェアコンテナ内のLinuxアプリケーションの展開を自動化するための優れたツールですが、その可能性を最大限に活用するには、アプリケーションの各コンポーネントを独自の個別のコンテナで実行する必要があります。 多数のコンポーネントを持つ複雑なアプリケーションの場合、すべてのコンテナをまとめて起動、通信、およびシャットダウンするように調整すると、すぐに扱いにくくなります。
Dockerコミュニティは、Figと呼ばれる一般的なソリューションを考案しました。これにより、単一のYAMLファイルを使用してすべてのDockerコンテナーと構成を調整できます。 これは非常に人気があったため、DockerチームはFigソースに基づいてDocker Composeを作成することを決定しましたが、現在は非推奨です。 Docker Composeを使用すると、ユーザーは、コンテナ内のリンクとボリュームの起動、シャットダウン、セットアップなど、Dockerコンテナのプロセスを簡単に調整できます。
このチュートリアルでは、マルチコンテナアプリケーションの管理に役立つ最新バージョンのDocker Composeのインストール方法を示します。
前提条件
この記事を読むには、次のものを備えたUbuntu 16.04サーバーが必要です。
-
non-root user with sudo privileges(Initial Server Setup with Ubuntu 16.04は、これを設定する方法を説明しています。)
-
How To Install and Use Docker on Ubuntu 16.04のStep 1およびStep 2からの指示とともにインストールされたDocker
これらの準備が整うと、次の手順に進むことができます。
[.note]#Note:前提条件にUbuntu 16.04にDockerをインストールする手順が記載されていますが、この記事のdocker
コマンドは、Dockerがインストールされている限り他のオペレーティングシステムでも機能するはずです。
#
[[step-1 -—- installing-docker-compose]] ==ステップ1— DockerComposeのインストール
公式のUbuntuリポジトリからDocker Composeをインストールできますが、これは最新リリースのいくつかのマイナーバージョンであるため、DockerのGitHubリポジトリからDocker Composeをインストールします。 以下のコマンドは、Releasesページにあるコマンドとは少し異なります。 この構文では、出力をリダイレクトするのではなく、-o
フラグを使用して最初に出力ファイルを指定することにより、sudo
の使用時に発生するアクセス許可拒否エラーが発生するのを回避します。
current releaseを確認し、必要に応じて、以下のコマンドで更新します。
sudo curl -L https://github.com/docker/compose/releases/download/1.18.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
次に、アクセス許可を設定します。
sudo chmod +x /usr/local/bin/docker-compose
次に、バージョンを確認して、インストールが成功したことを確認します。
docker-compose --version
これにより、インストールしたバージョンが出力されます。
Outputdocker-compose version 1.18.0, build 8dd22a9
Docker Composeがインストールされたので、「Hello World」の例を実行する準備ができました。
[[step-2 -—- running-a-container-with-docker-compose]] ==ステップ2— DockerComposeを使用したコンテナーの実行
パブリックDockerレジストリであるDockerHubには、デモンストレーションとテスト用のHello Worldイメージが含まれています。 これは、Docker Composeを使用してコンテナーを実行するために必要な最小限の構成を示しています:単一のイメージを呼び出すYAMLファイル:
最初に、YAMLファイルのディレクトリを作成して移動します。
mkdir hello-world
cd hello-world
次に、YAMLファイルを作成します。
nano docker-compose.yml
次の内容をファイルに入れ、ファイルを保存して、テキストエディターを終了します。
docker-compose.yml
my-test:
image: hello-world
YAMLファイルの最初の行は、コンテナー名の一部として使用されます。 2行目は、コンテナの作成に使用するイメージを指定します。 コマンドdocker-compose up
を実行すると、指定した名前hello-world
でローカルイメージが検索されます。 これを設定したら、ファイルを保存して終了します。
docker images
コマンドを使用して、システム上の画像を手動で確認できます。
docker images
ローカル画像がまったくない場合、列見出しのみが表示されます:
OutputREPOSITORY TAG IMAGE ID CREATED SIZE
ここで、~/hello-world
ディレクトリにいる間に、次のコマンドを実行します。
docker-compose up
コマンドを初めて実行するときに、hello-world
という名前のローカルイメージがない場合、DockerComposeはDockerHubパブリックリポジトリからコマンドをプルします。
OutputPulling my-test (hello-world:latest)...
latest: Pulling from library/hello-world
c04b14da8d14: Downloading [==================================================>] c04b14da8d14: Extracting [==================================================>] c04b14da8d14: Extracting [==================================================>] c04b14da8d14: Pull complete
Digest: sha256:0256e8a36e2070f7bf2d0b0763dbabdd67798512411de4cdcf9431a1feb60fd9
Status: Downloaded newer image for hello-world:latest
. . .
イメージをプルした後、docker-compose
はコンテナーを作成し、アタッチして、helloプログラムを実行します。これにより、インストールが機能しているように見えることが確認されます。
Output. . .
Creating helloworld_my-test_1...
Attaching to helloworld_my-test_1
my-test_1 |
my-test_1 | Hello from Docker.
my-test_1 | This message shows that your installation appears to be working correctly.
my-test_1 |
. . .
次に、実行内容の説明を出力します。
Output of docker-compose up1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.
Dockerコンテナーは、コマンドがアクティブである間のみ実行されるため、hello
の実行が終了すると、コンテナーは停止します。 したがって、アクティブなプロセスを見ると、列ヘッダーは表示されますが、hello-world
コンテナーは実行されていないため、リストされません。
docker ps
OutputCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
アクティブなコンテナだけでなく、すべてのコンテナを表示する-a
フラグを使用すると、次のステップで必要になるコンテナ情報を確認できます。
docker ps -a
OutputCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
06069fd5ca23 hello-world "/hello" 35 minutes ago Exited (0) 35 minutes ago drunk_payne
これにより、作業が完了したときにコンテナを削除するために必要な情報が表示されます。
[[step-3 -—- removing-the-image-optional]] ==ステップ3—イメージの削除(オプション)
不要なディスク領域を使用しないように、ローカルイメージを削除します。 これを行うには、docker rm
コマンドを使用してイメージを参照するすべてのコンテナを削除し、その後にCONTAINERIDまたはNAMEを指定する必要があります。 以下では、実行したばかりのdocker ps -a
コマンドのCONTAINERIDを使用しています。 コンテナのIDを必ず置き換えてください:
docker rm 06069fd5ca23
イメージを参照するすべてのコンテナが削除されたら、イメージを削除できます。
docker rmi hello-world
結論
これでDocker Composeをインストールし、Hello Worldの例を実行してインストールをテストし、テストイメージとコンテナーを削除しました。
Hello Worldの例ではインストールが確認されましたが、シンプルな構成ではDocker Composeの主な利点の1つではありません。Dockerコンテナーのグループを同時に上下させることができます。 Docker Composeの実際の機能を確認するには、この実用的な例、How To Configure a Continuous Integration Testing Environment with Docker and Docker Compose on Ubuntu 16.04を確認してください。