はじめに
Dockerは、コンテナでアプリケーションプロセスを管理するプロセスを簡素化します。コンテナは仮想マシンに似ていますが、より軽量でリソースフレンドリーです。これにより、開発者はアプリケーション環境を複数の孤立したサービスに分解することができます。
複数のサービスに依存するアプリケーションの場合、すべてのコンテナを一緒に整理、起動、通信、シャットダウンすると、たちまち手に負えなくなることがあります。Docker Composeは、YAMLファイルの定義に基づいてマルチコンテナアプリケーション環境を実行できるツールです。サービス定義を使用して、ネットワークやデータ量を共有できる複数のコンテナで完全にカスタマイズ可能な環境を構築します。
本ガイドでは、Ubuntu 20.04サーバーにDocker Composeをインストールし、このツールを使用する方法を説明します。
前提条件
次のものを準備してください。
- sudo権限を持つroot以外のユーザーとして、Ubuntu 20.04ローカルマシンまたは開発サーバーにアクセス。リモートサーバーを使用している場合、アクティブなファイアウォールをインストールしておくことをお勧めします。これらのセットアップは、Ubuntu 20.04の初期サーバー設定ガイドを参照してください。
- お使いのサーバーまたはローカルマシンインストールされたDocker。インストール方法は、Ubuntu 20.04へのDockerのインストールおよび使用方法のステップ1と2に従ってください。
ステップ1— Docker Composeをインストールする
Docker Composeの最近更新された安定バージョンを取得するために、公式のGithubリポジトリからこのソフトウェアをダウンロードします。
まず、リリースページで利用可能な最新バージョンを確認します。この執筆時点では、最新の安定バージョンは1.26.0
です。
次のコマンドは、1.26.0
リリースをダウンロードし、実行ファイルを/usr/local/bin/docker-compose
に保存することで、このソフトウェアをdocker-compose
としてグローバルにアクセス可能にします。
- sudo curl -L "https://github.com/docker/compose/releases/download/1.26.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
次に、docker-compose
コマンドが実行可能になるように、正しい権限を設定します。
- sudo chmod +x /usr/local/bin/docker-compose
インストールが成功したことを確認するには、以下を実行します。
次のような出力が表示されます。
Output
docker-compose version 1.26.0, build 8a1c60f6
Docker Composeがシステムに正常にインストールされました。次のセクションでは、docker-compose.yml
ファイルをセットアップし、コンテナ化された環境を取得し、このツールを使用して実行する方法を示します。
ステップ2 —docker-compose.yml
ファイルをセットアップする
docker-compose.yml
ファイルをセットアップし、Docker Composeで作業する方法を実証するために、パブリックのCockerレジストリであるDocker Hubから、公式Nginxイメージを使用してWebサーバー環境を作成します。このコンテナ化された環境は、単一の静的HTMLファイルの処理に役立ちます。
まずはホームフォルダ内に新しいディレクトリを作成し、そこに移動することから始めましょう。
- mkdir ~/compose-demo
- cd ~/compose-demo
このディレクトリでは、Nginx環境のドキュメントルートとして機能するアプリケーションフォルダをセットアップします。
優先テキストエディタを使用すると、アプリ
フォルダに 新しいindex.html
ファイルが作成されます。
次のコンテンツをこのファイルに配置します。
~/compose-demo/app/index.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Docker Compose Demo</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/kognise/water.css@latest/dist/dark.min.css">
</head>
<body>
<h1>This is a Docker Compose Demo Page.</h1>
<p>This content is being served by an Nginx container.</p>
</body>
</html>
完了したら、ファイルを保存して閉じます。nano
を使用している場合、CTRL+X
、Y
、ENTER
とタイプして確認できます。
次に、docker-compose.yml
ファイルを作成します。
docker-compose.yml
に次のコンテンツを挿入します。
docker-compose.yml
version: '3.7'
services:
web:
image: nginx:alpine
ports:
- "8000:80"
volumes:
- ./app:/usr/share/nginx/html
docker-compose.yml
ファイルは、通常、バージョン
定義から開始します。こうすることで、私たちが使用しているDocker Composeに設定バージョンが伝えられます。
すると、この環境の一部であるサービスをセットアップするサービス
ブロックが現れます。私たちの場合、Web
という単一サービスがあります。このサービスではnginx:alpine
イメージを使用し、ポート
ディレクティブでポートのリダイレクトを設定します。ホストマシン(Docker Composeを実行しているシステム)のポート8000
へのすべてのリクエストは、Nginxが実行するポート80
のWeb
コンテナにリダイレクトされます。
ボリューム
ディレクティブにより、ホストマシンとコンテナ間の共有ボリュームが作成されます。これにより、ローカルアプリ
フォルダがコンテナと共有され、ボリュームはコンテナ内の/usr/share/nginx/html
に配置され、Nginxのデフォルトドキュメントルートを上書きします。
ファイルを保存して閉じます。
デモページとdocker-compose.yml
ファイルがセットアップされ、コンテナ化されたWebサーバー環境が作成されました。次のステップでは、この環境をDocker Composeで立ち上げます。
ステップ3 — Docker Composeを実行する
docker-compose.yml
ファイルが所定の位置に配置されたら、Docker Composeを実行して環境を立ち上げられます。次のコマンドでは、必要なDockerイメージをダウンロードし、Web
サービスのコンテナが作成され、コンテナ化された環境をバックグラウンドモードで実行します。
Docker Composeは、ローカルシステムで定義されたイメージを最初に探し、イメージが見つらない場合、Docker Hubからイメージをダウンロードします。出力は次のようになります。
Output
Creating network "compose-demo_default" with the default driver
Pulling web (nginx:alpine)...
alpine: Pulling from library/nginx
cbdbe7a5bc2a: Pull complete
10c113fb0c77: Pull complete
9ba64393807b: Pull complete
c829a9c40ab2: Pull complete
61d685417b2f: Pull complete
Digest: sha256:57254039c6313fe8c53f1acbf15657ec9616a813397b74b063e32443427c5502
Status: Downloaded newer image for nginx:alpine
Creating compose-demo_web_1 ... done
環境は、バックグラウンドで実行されています。コンテナがアクティブであることを確認するために、以下を実行できます。
このコマンドでは実行中のコンテナとその状態だけでなく、現在所定の位置に配置されたポートリダイレクトに関する情報が表示されます。
Output
Name Command State Ports
----------------------------------------------------------------------------------
compose-demo_web_1 /docker-entrypoint.sh ngin ... Up 0.0.0.0:8000->80/tcp
これで、ローカルマシンでこのデモを実行している場合はlocalhost:8000
に、またはリモートサーバーでこのデモを実行している場合はyour_server_domain_or_IP:8000
にブラウザを指し示すことで、デモアプリケーションにアクセスできるようになりました。
以下のページが表示されます。
共有ボリュームはdocker-compose.yml
ファイル内部でセットアップしされたため、アプリ
フォルダファイルは引き続きコンテナのドキュメントrootと同期し続けます。index.html
ファイルに変更を加えると、コンテナに自動的に取り上げられ、ページをリロードするときにブラウザに反映されます。
次のステップでは、Docker Composeコマンドでコンテナ化された環境を管理する方法が表示されます。
ステップ4 — Docker Composeコマンドに精通する
これまではdocker-compose.yml
ファイルがセットアップされ、環境をdocker-compose up
で立ち上げる方法を見てきました。ここでは、Docker Composeコマンドを使用してコンテナ化された環境を管理しやり取りする方法を見てみましょう。
Nginxコンテナにより生成されたログをチェックするために、logs
コマンドを使用できます。
次のような出力が表示されます。
Output
Attaching to compose-demo_web_1
web_1 | /docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
web_1 | /docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
web_1 | /docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
web_1 | 10-listen-on-ipv6-by-default.sh: Getting the checksum of /etc/nginx/conf.d/default.conf
web_1 | 10-listen-on-ipv6-by-default.sh: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
web_1 | /docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
web_1 | /docker-entrypoint.sh: Configuration complete; ready for start up
web_1 | 172.22.0.1 - - [02/Jun/2020:10:47:13 +0000] "GET / HTTP/1.1" 200 353 "-" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.61 Safari/537.36" "-"
コンテナの現在の状態を変更せずに環境実行を一時停止したい場合は、以下を使用します。
Output
Pausing compose-demo_web_1 ... done
一時停止を発行した後で実行を再開するには、以下を実行します。
Output
Unpausing compose-demo_web_1 ... done
stop
コマンドは、コンテナ実行を終了しますが、コンテナに関連付けられたデータは破棄されません。
Output
Stopping compose-demo_web_1 ... done
このコンテナ化された環境に関連付けられたコンテナ、ネットワーク、ボリュームを削除する場合は、down
コマンドを使用します。
Output
Removing compose-demo_web_1 ... done
Removing network compose-demo_default
このコマンドはDocker Composeが使用するベースイメージを削除せずに環境をスピンアップさせることに注意してください(この場合はnginx:alpine
)。このように、docker-compose upで環境を再び立ち上げ
るときには常にイメージがシステム上にすでにあるため、プロセス速度がはるかに上がります。
システムからベースイメージを削除したい場合も、以下を使用できます。
- docker image rm nginx:alpine
Output
Untagged: nginx:alpine
Untagged: nginx@sha256:b89a6ccbda39576ad23fd079978c967cecc6b170db6e7ff8a769bf2259a71912
Deleted: sha256:7d0cdcc60a96a5124763fddf5d534d058ad7d0d8d4c3b8be2aefedf4267d0270
Deleted: sha256:05a0eaca15d731e0029a7604ef54f0dda3b736d4e987e6ac87b91ac7aac03ab1
Deleted: sha256:c6bbc4bdac396583641cb44cd35126b2c195be8fe1ac5e6c577c14752bbe9157
Deleted: sha256:35789b1e1a362b0da8392ca7d5759ef08b9a6b7141cc1521570f984dc7905eb6
Deleted: sha256:a3efaa65ec344c882fe5d543a392a54c4ceacd1efd91662d06964211b1be4c08
Deleted: sha256:3e207b409db364b595ba862cdc12be96dcdad8e36c59a03b7b3b61c946a5741a
注:Dockerコマンドの詳細なリファレンスについては、Dockerのインストールと使用方法で当社のガイドを参照してください。
まとめ
本ガイドでは、Docker Composeをインストールし、Nginx Webサーバーイメージに基づいてコンテナ化された環境を設定する方法をご紹介しました。また、Composeコマンドを使用して、この環境を管理する方法も学びました。
利用可能なすべてのdocker-compose
コマンドについての詳細は、公式ドキュメントを参照してください。