Ubuntu14.04にDockerComposeをインストールして使用する方法
序章
Docker は優れたツールですが、その可能性を最大限に活用するには、アプリケーションの各コンポーネントを独自のコンテナーで実行するのが最適です。 多くのコンポーネントを含む複雑なアプリケーションの場合、すべてのコンテナーを調整して、一緒に起動およびシャットダウンする(互いに話し合うことは言うまでもありません)と、すぐに扱いにくくなる可能性があります。
Dockerコミュニティは、 Fig と呼ばれる人気のあるソリューションを考案しました。これにより、単一のYAMLファイルを使用してすべてのDockerコンテナーと構成を調整できます。 これは非常に人気があり、Dockerチームは最終的にFigソースに基づいて独自のバージョンを作成することを決定しました。 彼らはそれをDockerComposeと呼びました。 つまり、Dockerコンテナーのオーケストレーションプロセス(コンテナー内のリンクとボリュームの起動、シャットダウン、セットアップなど)の処理が非常に簡単になります。
この記事の終わりまでに、DockerとDocker Composeがインストールされ、DockerComposeがどのように機能するかについての基本的な理解が得られます。
DockerとDockerComposeの概念
Docker Composeを使用するには、さまざまなDockerの概念を1つに組み合わせる必要があるため、始める前に、関連するさまざまな概念を確認してみましょう。 ボリューム、リンク、ポートフォワーディングなどのDockerの概念に既に精通している場合は、先に進んで次のセクションに進んでください。
Dockerイメージ
各Dockerコンテナは、Dockerイメージのローカルインスタンスです。 Dockerイメージは、完全なLinuxインストールと考えることができます。 通常、最小限のインストールには、イメージの実行に必要な最小限のパッケージのみが含まれます。 これらのイメージはホストシステムのカーネルを使用しますが、Dockerコンテナー内で実行され、独自のファイルシステムのみを表示するため、UbuntuホストでCentOSのようなディストリビューションを実行することは完全に可能です(またはその逆)。
ほとんどのDockerイメージは、Dockerチームによって管理されている DockerHubを介して配布されます。 最も人気のあるオープンソースプロジェクトでは、対応するイメージがDockerレジストリにアップロードされており、これを使用してソフトウェアをデプロイできます。 可能であれば、「公式」イメージを取得することをお勧めします。これは、DockerチームがDockerのベストプラクティスに従うことが保証されているためです。
Dockerイメージ間の通信
Dockerコンテナーは、デフォルトでホストマシンから分離されています。つまり、デフォルトでは、ホストマシンはDockerコンテナー内のファイルシステムにアクセスできず、ネットワークを介してDockerコンテナーと通信する手段もありません。 言うまでもなく、これにより、Dockerコンテナー内で実行されているイメージの構成と操作がデフォルトで困難になります。
Dockerには、これを回避するための3つの主要な方法があります。 最初の最も一般的な方法は、Dockerコンテナ内に設定される環境変数をDockerに指定させることです。 Dockerコンテナー内で実行されているコードは、起動時にこれらの環境変数の値をチェックし、それらを使用して適切に構成します。
もう1つの一般的に使用される方法は、Dockerデータボリュームです。 Dockerボリュームには、内部と共有の2つの種類があります。
内部ボリュームを指定するということは、特定のDockerコンテナーに指定するフォルダーの場合、コンテナーが削除されたときにデータが保持されることを意味します。 たとえば、ログファイルがハングしていることを確認したい場合は、内部/var/log
ボリュームを指定できます。
共有ボリュームは、Dockerコンテナー内のフォルダーをホストマシン上のフォルダーにマップします。 これにより、Dockerコンテナとホストマシン間でファイルを簡単に共有できます。これについては、Dockerデータボリュームの記事で説明します。
Dockerコンテナーと通信する3番目の方法は、ネットワークを介することです。 Dockerを使用すると、links
を介した異なるDockerコンテナー間の通信と、ポート転送が可能になり、Dockerコンテナー内からホストサーバー上のポートにポートを転送できます。 たとえば、WordPressコンテナとMariaDB Dockerコンテナが相互に通信できるようにするリンクを作成し、ポートフォワーディングを使用してWordPressを外部に公開し、ユーザーが接続できるようにすることができます。
前提条件
この記事をフォローするには、次のものが必要です。
- Ubuntu14.04ドロップレット
- sudo権限を持つroot以外のユーザー( Ubuntu 14.04 を使用した初期サーバーセットアップでは、これをセットアップする方法について説明しています。)
ステップ1—Dockerをインストールする
まず、Dockerをまだインストールしていない場合はインストールします。 Dockerをインストールする最も簡単な方法は、インストールスクリプトをダウンロードしてインストールすることです(sudoパスワードの入力を求められます)。
- wget -qO- https://get.docker.com/ | sh
上記のコマンドは、Dockerチームによって作成された小さなインストールスクリプトをダウンロードして実行します。 サードパーティのスクリプトを信頼できない場合、またはスクリプトの実行内容の詳細が必要な場合は、DigitalOceanDockerチュートリアルまたはDocker独自のインストールドキュメントの手順を確認してください。
ユーザーが正しく構成されていない場合、Dockerの操作は面倒なので、次のコマンドを使用してユーザーをdocker
グループに追加します。
sudo usermod -aG docker $(whoami)
サーバーからログアウトしてログインし、新しいグループをアクティブ化します。
注: Dockerの使用方法の詳細については、 Dockerのインストールと使用方法:はじめにのDockerの使用方法セクションをお読みください。
ステップ2—DockerComposeをインストールする
Dockerがインストールされたので、先に進んでDockerComposeをインストールしましょう。 まず、前提条件としてpython-pip
をインストールします。
- sudo apt-get -y install python-pip
次に、DockerComposeをインストールできます。
- sudo pip install docker-compose
ステップ3—DockerComposeを使用してコンテナーを実行する
パブリックDockerレジストリであるDockerHubには、単純な HelloWorldイメージが含まれています。 Docker Composeがインストールされたので、この非常に単純な例でテストしてみましょう。
まず、YAMLファイル用のディレクトリを作成します。
- mkdir hello-world
次に、ディレクトリに移動します。
- cd hello-world
次に、お気に入りのテキストエディタを使用してYAMLファイルを作成します(nanoを使用します)。
- nano docker-compose.yml
次の内容をファイルに入れ、ファイルを保存して、テキストエディタを終了します。
my-test:
image: hello-world
最初の行は、コンテナ名の一部として使用されます。 2行目は、コンテナの作成に使用するイメージを指定します。 イメージは公式のDockerHubリポジトリからダウンロードされます。
~/hello-world
ディレクトリにいる間に、次のコマンドを実行してコンテナを作成します。
- docker-compose up
出力は次のように始まります。
Output of docker-compose upCreating 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 |
次に、出力はDockerが実行していることを説明します。
- DockerクライアントがDockerデーモンに接続しました。
- Dockerデーモンは、DockerHubから「hello-world」イメージをプルしました。
- Dockerデーモンは、そのイメージから、現在読み取っている出力を生成する実行可能ファイルを実行する新しいコンテナーを作成しました。
- Dockerデーモンはその出力をDockerクライアントにストリーミングし、Dockerクライアントはそれをターミナルに送信しました。
プロセスが自動的に終了しない場合は、CTRL-C
を押します。
この簡単なテストでは、DockerComposeの主な利点の1つであるDockerコンテナーのグループを同時に上下させることができることは示されていません。 UbuntuにDockerComposeを使用してWordpressとPhpMyAdminをインストールする方法14.04の記事では、DockerComposeを使用して3つのコンテナーを1つのアプリケーショングループとして実行する方法を示しています。
ステップ4—Docker作成コマンドの学習
docker-compose
ツールがサポートするコマンドを見てみましょう。
docker-compose
コマンドは、ディレクトリごとに機能します。 1台のマシンでDockerコンテナの複数のグループを実行できます。コンテナごとに1つのディレクトリを作成し、そのディレクトリ内のコンテナごとに1つのdocker-compose.yml
ファイルを作成します。
これまで、docker-compose up
を単独で実行し、CTRL-C
を使用してシャットダウンしてきました。 これにより、デバッグメッセージをターミナルウィンドウに表示できます。 ただし、これは理想的ではありません。本番環境で実行する場合は、docker-compose
をサービスのように動作させる必要があります。 これを行う簡単な方法の1つは、セッションをup
するときに、-d
オプションを追加することです。
docker-compose up -d
docker-compose
はバックグラウンドに分岐します。
Dockerコンテナーのグループ(停止していて現在実行中の両方)を表示するには、次のコマンドを使用します。
docker-compose ps
たとえば、次の例は、helloworld_my-test_1
コンテナが停止していることを示しています。
Output of `docker-compose ps` Name Command State Ports
-----------------------------------------------
helloworld_my-test_1 /hello Exit 0
実行中のコンテナは、Up
の状態を示します。
Output of `docker-compose ps` Name Command State Ports
---------------------------------------------------------------
nginx_nginx_1 nginx -g daemon off; Up 443/tcp, 80/tcp
アプリケーショングループで実行中のすべてのDockerコンテナを停止するには、Dockerグループの起動に使用したdocker-compose.yml
ファイルと同じディレクトリで次のコマンドを発行します。
docker-compose stop
ノート: docker-compose kill
is also available if you need to shut things down more forcefully.
場合によっては、Dockerコンテナは古い情報を内部ボリュームに保存します。 最初からやり直したい場合は、rm
コマンドを使用して、コンテナグループを構成するすべてのコンテナを完全に削除できます。
docker-compose rm
Dockerコンテナと.yml
ファイルを含むディレクトリ以外のディレクトリからこれらのコマンドのいずれかを実行しようとすると、文句が表示され、コンテナは表示されません。
Output from wrong directory Can't find a suitable configuration file in this directory or any parent. Are you in the right directory?
Supported filenames: docker-compose.yml, docker-compose.yaml, fig.yml, fig.yaml
ステップ5— Docker Container Filesystemへのアクセス(オプション)
コンテナ内のコマンドプロンプトで作業する必要がある場合は、docker exec
コマンドを使用できます。
Hello World!の例は実行後に終了するため、実行を継続するコンテナーを開始して、docker exec
を使用してコンテナーのファイルシステムにアクセスできるようにする必要があります。 DockerHubのNginxイメージを見てみましょう。
そのための新しいディレクトリを作成し、それに変更します。
- mkdir ~/nginx && cd $_
新しいディレクトリにdocker-compose.yml
ファイルを作成します。
- nano docker-compose.yml
次のように貼り付けます。
nginx:
image: nginx
ファイルを保存して終了します。 次のコマンドを使用して、バックグラウンドプロセスとしてNginxコンテナを開始する必要があります。
- docker-compose up -d
Nginxイメージがダウンロードされ、コンテナーがバックグラウンドで開始されます。
次に、コンテナ用のCONTAINER ID
が必要です。 実行中のすべてのコンテナーのリスト:
- docker ps
次のようなものが表示されます。
Output of `docker ps`CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
e90e12f70418 nginx "nginx -g 'daemon off" 6 minutes ago Up 5 minutes 80/tcp, 443/tcp nginx_nginx_1
注: docker ps
コマンドでは、実行中のコンテナーのみがリストされます。
このコンテナ内のファイルシステムに変更を加えたい場合は、そのID(この例ではe90e12f70418
)を取得し、docker exec
を使用してコンテナ内のシェルを開始します。
- docker exec -it e90e12f70418 /bin/bash
-t
オプションは端末を開き、-i
オプションは端末をインタラクティブにします。 /bin/bash
オプションは、実行中のコンテナーに対してbashシェルを開きます。 必ずコンテナのIDを使用してください。
次のようなコンテナのbashプロンプトが表示されます。
root@e90e12f70418:/#
ここから、コマンドプロンプトから作業できます。 ただし、データボリュームの一部として保存されているディレクトリにいない限り、コンテナを再起動するとすぐに変更内容が表示されなくなることに注意してください。 もう1つの注意点は、ほとんどのDockerイメージは最小限のLinuxインストールで作成されるため、使用しているコマンドラインユーティリティとツールの一部が存在しない可能性があることです。
結論
これで、Docker Composeの基本的な概念と、DockerComposeをインストールして実行する方法について説明しました。 Docker Composeを使用してアプリケーションをデプロイする方法のより複雑な例については、 Ubuntu14.04でのDockerComposeを使用したWordpressとPHPMyAdminのデプロイのチュートリアルを確認してください。
docker-compose.yml
ファイルの構成オプションの完全なリストについては、ファイルリファレンスの作成を参照してください。