Tutorial

Ubuntu 20.04へのDocker Composeのインストールおよび使用方法

Published on November 13, 2020

日本語

Ubuntu 20.04へのDocker Composeのインストールおよび使用方法

はじめに

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

インストールが成功したことを確認するには、以下を実行します。

docker-compose --version

次のような出力が表示されます。

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環境のドキュメントルートとして機能するアプリケーションフォルダをセットアップします。

mkdir app

優先テキストエディタを使用すると、アプリフォルダに新しいindex.htmlファイルが作成されます。

nano app/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ファイルを作成します。

nano 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 up -d

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

環境は、バックグラウンドで実行されています。コンテナがアクティブであることを確認するために、以下を実行できます。

docker-compose ps

このコマンドでは実行中のコンテナとその状態だけでなく、現在所定の位置に配置されたポートリダイレクトに関する情報が表示されます。

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デモページ

共有ボリュームはdocker-compose.ymlファイル内部でセットアップしされたため、アプリフォルダファイルは引き続きコンテナのドキュメントrootと同期し続けます。index.htmlファイルに変更を加えると、コンテナに自動的に取り上げられ、ページをリロードするときにブラウザに反映されます。

次のステップでは、Docker Composeコマンドでコンテナ化された環境を管理する方法が表示されます。

ステップ4 — Docker Composeコマンドに精通する

これまではdocker-compose.ymlファイルがセットアップされ、環境をdocker-compose upで立ち上げる方法を見てきました。ここでは、Docker Composeコマンドを使用してコンテナ化された環境を管理しやり取りする方法を見てみましょう。

Nginxコンテナにより生成されたログをチェックするために、logsコマンドを使用できます。

docker-compose 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" "-"

コンテナの現在の状態を変更せずに環境実行を一時停止したい場合は、以下を使用します。

docker-compose pause

Output
Pausing compose-demo_web_1 ... done

一時停止を発行した後で実行を再開するには、以下を実行します。

docker-compose unpause

Output
Unpausing compose-demo_web_1 ... done

stopコマンドは、コンテナ実行を終了しますが、コンテナに関連付けられたデータは破棄されません。

docker-compose stop

Output
Stopping compose-demo_web_1 ... done

このコンテナ化された環境に関連付けられたコンテナ、ネットワーク、ボリュームを削除する場合は、downコマンドを使用します。

docker-compose 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

OutputUntagged: nginx:alpine
Untagged: nginx@sha256:b89a6ccbda39576ad23fd079978c967cecc6b170db6e7ff8a769bf2259a71912
Deleted: sha256:7d0cdcc60a96a5124763fddf5d534d058ad7d0d8d4c3b8be2aefedf4267d0270
Deleted: sha256:05a0eaca15d731e0029a7604ef54f0dda3b736d4e987e6ac87b91ac7aac03ab1
Deleted: sha256:c6bbc4bdac396583641cb44cd35126b2c195be8fe1ac5e6c577c14752bbe9157
Deleted: sha256:35789b1e1a362b0da8392ca7d5759ef08b9a6b7141cc1521570f984dc7905eb6
Deleted: sha256:a3efaa65ec344c882fe5d543a392a54c4ceacd1efd91662d06964211b1be4c08
Deleted: sha256:3e207b409db364b595ba862cdc12be96dcdad8e36c59a03b7b3b61c946a5741a