One place for hosting & domains

      2004へのDocker

      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

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

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

      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+XYENTERとタイプして確認できます。

      次に、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が実行するポート80Webコンテナにリダイレクトされます。

      ボリュームディレクティブにより、ホストマシンとコンテナ間の共有ボリュームが作成されます。これにより、ローカルアプリフォルダがコンテナと共有され、ボリュームはコンテナ内の/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デモページ

      共有ボリュームは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コマンドについての詳細は、公式ドキュメントを参照してください。



      Source link