Ubuntu20.04でDockerコンテナのリバースプロキシとしてTraefikv1を使用する方法
著者は、 Write for DOnations プログラムの一環として、 Girls WhoCodeを選択して寄付を受け取りました。
注:このチュートリアルはTraefikv1を対象としています。 Traefik v2をインストールして構成する場合は、この新しいチュートリアルを使用してください。
序章
Docker は、本番環境でWebアプリケーションを実行するための効率的な方法ですが、同じDockerホストで複数のアプリケーションを実行したい場合があります。 この状況では、ポート80
と443
のみを他の世界に公開する必要があるため、リバースプロキシを設定する必要があります。
Traefik は、独自の監視ダッシュボードを含むDocker対応のリバースプロキシです。 このチュートリアルでは、Traefikを使用して、リクエストを2つの異なるWebアプリケーションコンテナにルーティングします。WordpressコンテナとAdminerコンテナで、それぞれMySQLと通信します。データベース。 Let's Encrypt を使用して、HTTPS経由ですべてを提供するようにTraefikを構成します。
前提条件
このチュートリアルに従うには、次のものが必要です。
- 1台のUbuntu20.04サーバーは、 Ubuntu 20.04初期サーバーセットアップガイドに従ってセットアップされます。これには、sudo非rootユーザーとファイアウォールが含まれます。
- サーバーにDockerがインストールされています。これは、 Ubuntu20.04にDockerをインストールして使用する方法に従って実行できます。
- Ubuntu20.04にDockerComposeをインストールする方法の手順に従ってインストールされたDockerCompose。
- ドメインと3つのAレコード、
db-admin.your_domain
、blog.your_domain
、およびmonitor.your_domain
。 それぞれがサーバーのIPアドレスを指している必要があります。 DigitalOceanのドメインとDNSのドキュメントを読むことで、ドメインがDigitalOceanドロップレットを指す方法を学ぶことができます。 このチュートリアル全体を通して、構成ファイルと例でyour_domain
をドメインに置き換えてください。
ステップ1—Traefikの構成と実行
Traefikプロジェクトには公式Dockerイメージがあるため、これを使用してDockerコンテナーでTraefikを実行します。
ただし、Traefikコンテナを起動して実行する前に、構成ファイルを作成し、暗号化されたパスワードを設定して、監視ダッシュボードにアクセスできるようにする必要があります。
htpasswd
ユーティリティを使用して、この暗号化されたパスワードを作成します。 まず、apache2-utils
パッケージに含まれているユーティリティをインストールします。
sudo apt-get install apache2-utils
次に、htpasswd
を使用してパスワードを生成します。 secure_password
を、Traefik管理者ユーザーに使用するパスワードに置き換えます。
htpasswd -nb admin secure_password
プログラムからの出力は次のようになります。
Outputadmin:$apr1$ruca84Hq$mbjdMZBAG.KWn7vfN/SNK/
Traefik構成ファイルの独自の出力を使用して、Traefikヘルスチェックおよび監視ダッシュボードのHTTP基本認証を設定します。 後で貼り付けることができるように、出力行全体をコピーします。 サンプル出力は使用しないでください。
Traefikサーバーを構成するには、TOML形式を使用してtraefik.toml
という新しい構成ファイルを作成します。 TOML は、INIファイルに似た構成言語ですが、標準化されています。 このファイルを使用すると、Traefikサーバーと、使用するさまざまな統合またはproviders
を構成できます。 このチュートリアルでは、Traefikで利用可能な3つのプロバイダー、api
、docker
、およびacme
を使用します。 最後のacme
は、Let'sEncryptを使用したTLS証明書をサポートしています。
nano
またはお気に入りのテキストエディタで新しいファイルを開きます。
nano traefik.toml
まず、2つの名前付きエントリポイントhttp
とhttps
を追加します。これらは、すべてのバックエンドがデフォルトでアクセスできます。
traefik.toml
defaultEntryPoints = ["http", "https"]
このファイルの後半で、http
およびhttps
エントリポイントを構成します。
次に、api
プロバイダーを構成します。これにより、ダッシュボードインターフェイスにアクセスできるようになります。 ここに、htpasswd
コマンドからの出力を貼り付けます。
traefik.toml
... [entryPoints] [entryPoints.dashboard] address = ":8080" [entryPoints.dashboard.auth] [entryPoints.dashboard.auth.basic] users = ["admin:your_encrypted_password"] [api] entrypoint="dashboard"
ダッシュボードは、Traefikコンテナ内で実行される別個のWebアプリケーションです。 ダッシュボードをポート8080
で実行するように設定しました。
entrypoints.dashboard
セクションは、api
プロバイダーとの接続方法を構成し、entrypoints.dashboard.auth.basic
セクションは、ダッシュボードのHTTP基本認証を構成します。 実行したhtpasswd
コマンドからの出力を、users
エントリの値に使用します。 追加のログインは、コンマで区切って指定できます。
最初のentryPoint
を定義しましたが、api
プロバイダーに向けられていない標準のHTTPおよびHTTPS通信用に他のものを定義する必要があります。 entryPoints
セクションは、Traefikとプロキシされたコンテナがリッスンできるアドレスを構成します。 entryPoints
見出しの下のファイルに次の行を追加します。
traefik.toml
... [entryPoints.http] address = ":80" [entryPoints.http.redirect] entryPoint = "https" [entryPoints.https] address = ":443" [entryPoints.https.tls] ...
http
エントリポイントはポート80
を処理し、https
エントリポイントはTLS/SSLにポート443
を使用します。 ポート80
のすべてのトラフィックをhttps
エントリポイントに自動的にリダイレクトして、すべての要求に対して安全な接続を強制します。
次に、このセクションを追加して、TraefikのLet'sEncrypt証明書のサポートを構成します。
traefik.toml
... [acme] email = "your_email@your_domain" storage = "acme.json" entryPoint = "https" onHostRule = true [acme.httpChallenge] entryPoint = "http"
ACME は、Let's Encryptと通信して証明書を管理するために使用されるプロトコルの名前であるため、このセクションはacme
と呼ばれます。 Let's Encryptサービスでは、有効な電子メールアドレスで登録する必要があるため、Traefikにホストの証明書を生成させるには、email
キーを電子メールアドレスに設定します。 次に、Let'sEncryptから受け取る情報をacme.json
というJSONファイルに保存するように指定します。 entryPoint
キーは、エントリポイント処理ポート443
(この場合はhttps
エントリポイント)を指す必要があります。
キーonHostRule
は、Traefikが証明書を生成する方法を指示します。 指定されたホスト名を持つコンテナが作成されたらすぐに証明書をフェッチする必要があります。これがonHostRule
設定で行われます。
acme.httpChallenge
セクションでは、Let'sEncryptが証明書を生成する必要があることを確認する方法を指定できます。 http
エントリポイントを介してチャレンジの一部としてファイルを提供するように構成しています。
最後に、次の行をファイルに追加して、docker
プロバイダーを構成しましょう。
traefik.toml
... [docker] domain = "your_domain" watch = true network = "web"
docker
プロバイダーにより、TraefikはDockerコンテナーの前でプロキシとして機能できます。 web
ネットワーク上の新しいコンテナ用にプロバイダーをwatch
に構成しました。これは間もなく作成され、your_domain
のサブドメインとして公開されます。
この時点で、traefik.toml
には次の内容が含まれているはずです。
traefik.toml
defaultEntryPoints = ["http", "https"] [entryPoints] [entryPoints.dashboard] address = ":8080" [entryPoints.dashboard.auth] [entryPoints.dashboard.auth.basic] users = ["admin:your_encrypted_password"] [entryPoints.http] address = ":80" [entryPoints.http.redirect] entryPoint = "https" [entryPoints.https] address = ":443" [entryPoints.https.tls] [api] entrypoint="dashboard" [acme] email = "your_email@your_domain" storage = "acme.json" entryPoint = "https" onHostRule = true [acme.httpChallenge] entryPoint = "http" [docker] domain = "your_domain" watch = true network = "web"
ファイルを保存して、エディターを終了します。 これらの構成を設定すると、Traefikを初期化できます。
ステップ2—Traefikコンテナを実行する
次に、プロキシがコンテナと共有するDockerネットワークを作成します。 Dockerネットワークは、DockerComposeを使用して実行されるアプリケーションで使用できるようにするために必要です。 このネットワークをweb
と呼びましょう。
docker network create web
Traefikコンテナが起動したら、このネットワークに追加します。 次に、後でTraefikがプロキシするために、このネットワークにコンテナを追加できます。
次に、Let'sEncrypt情報を保持する空のファイルを作成します。 これをコンテナに共有して、Traefikが使用できるようにします。
touch acme.json
Traefikは、コンテナ内のrootユーザーがこのファイルへの一意の読み取りおよび書き込みアクセス権を持っている場合にのみ、このファイルを使用できます。 これを行うには、acme.json
の権限をロックダウンして、ファイルの所有者のみが読み取りおよび書き込み権限を持つようにします。
chmod 600 acme.json
ファイルがDockerに渡されると、所有者はコンテナ内のrootユーザーに自動的に変更されます。
最後に、次のコマンドを使用してTraefikコンテナを作成します。
docker run -d \ -v /var/run/docker.sock:/var/run/docker.sock \ -v $PWD/traefik.toml:/traefik.toml \ -v $PWD/acme.json:/acme.json \ -p 80:80 \ -p 443:443 \ -l traefik.frontend.rule=Host:monitor.your_domain \ -l traefik.port=8080 \ --network web \ --name traefik \ traefik:1.7-alpine
コマンドは少し長いので、分解してみましょう。
-d
フラグを使用して、コンテナーをデーモンとしてバックグラウンドで実行します。 次に、docker.sock
ファイルをコンテナーに共有して、Traefikプロセスがコンテナーへの変更をリッスンできるようにします。 また、コンテナに作成したtraefik.toml
構成ファイルとacme.json
ファイルを共有します。
次に、Dockerホストのポート:80
と:443
をTraefikコンテナー内の同じポートにマップして、TraefikがサーバーへのすべてのHTTPおよびHTTPSトラフィックを受信するようにします。
次に、トラフィックをホスト名monitor.your_domain
に向けてTraefikコンテナ内のポート:8080
に転送するように、Traefikに指示する2つのDockerラベルを設定します。これにより、監視ダッシュボードが公開されます。
コンテナのネットワークをweb
に設定し、コンテナにtraefik
という名前を付けます。
最後に、このコンテナは小さいため、traefik:1.7-alpine
イメージを使用します。
DockerイメージのENTRYPOINTは、イメージからコンテナーが作成されるときに常に実行されるコマンドです。 この場合、コマンドはコンテナ内のtraefik
バイナリです。 コンテナを起動するときにそのコマンドに追加の引数を渡すことができますが、すべての設定はtraefik.toml
ファイルで構成されています。
コンテナが起動すると、コンテナの状態を確認するためにアクセスできるダッシュボードができました。 このダッシュボードを使用して、Traefikが登録したフロントエンドとバックエンドを視覚化することもできます。 ブラウザでhttps://monitor.your_domain
を指定して、監視ダッシュボードにアクセスします。 ユーザー名とパスワードの入力を求められます。これらはadminであり、手順1で構成したパスワードです。
ログインすると、次のようなインターフェースが表示されます。
まだ見るものはあまりありませんが、このウィンドウを開いたままにしておくと、Traefikが管理するコンテナを追加すると内容が変化します。
これで、Traefikプロキシが実行され、Dockerと連携するように構成され、他のDockerコンテナーを監視する準備が整いました。 Traefikのコンテナをプロキシに追加しましょう。
ステップ3—コンテナをTraefikに登録する
Traefikコンテナを実行すると、その背後でアプリケーションを実行する準備が整います。 Traefikの背後にある次のコンテナを起動しましょう。
- 公式WordPress画像を使用したブログ。
- 公式管理者イメージを使用するデータベース管理サーバー。
docker-compose.yml
ファイルを使用して、DockerComposeでこれらのアプリケーションの両方を管理します。
docker-compose.yml
ファイルを作成してエディターで開きます。
nano docker-compose.yml
次の行をファイルに追加して、使用するバージョンとネットワークを指定します。
docker-compose.yml
version: "3" networks: web: external: true internal: external: false
DockerComposeバージョン3
は、Composeファイル形式の最新のメジャーバージョンであるため、使用しています。
Traefikがアプリケーションを認識するためには、それらが同じネットワークの一部である必要があります。ネットワークは手動で作成したため、web
のネットワーク名を指定し、external
を[ X208X]。 次に、公開されたコンテナを、Traefikを介して公開しないデータベースコンテナに接続できるように、別のネットワークを定義します。 このネットワークをinternal
と呼びます。
次に、各services
を一度に1つずつ定義します。 blog
コンテナーから始めましょう。これは、公式のWordPressイメージに基づいています。 次の構成をファイルの最後に追加します。
docker-compose.yml
... services: blog: image: wordpress:4.9.8-apache environment: WORDPRESS_DB_PASSWORD: labels: - traefik.backend=blog - traefik.frontend.rule=Host:blog.your_domain - traefik.docker.network=web - traefik.port=80 networks: - internal - web depends_on: - mysql
environment
キーを使用すると、コンテナー内に設定される環境変数を指定できます。 WORDPRESS_DB_PASSWORD
の値を設定しないことで、Docker Composeにシェルから値を取得し、コンテナーを作成するときにそれを渡すように指示しています。 コンテナを起動する前に、シェルでこの環境変数を定義します。 このようにして、パスワードを構成ファイルにハードコーディングしません。
labels
セクションでは、Traefikの構成値を指定します。 Dockerラベルはそれ自体では何もしませんが、Traefikはこれらを読み取るため、コンテナーの処理方法を認識しています。 これらの各ラベルの機能は次のとおりです。
traefik.backend
は、Traefikのバックエンドサービスの名前を指定します(実際のblog
コンテナーを指します)。traefik.frontend.rule=Host:blog.your_domain
は、要求されたホストを調べるようにTraefikに指示し、blog.your_domain
のパターンと一致する場合は、トラフィックをblog
コンテナにルーティングする必要があります。traefik.docker.network=web
は、このコンテナーの内部IPを見つけるためにTraefikを探すネットワークを指定します。 TraefikコンテナはすべてのDocker情報にアクセスできるため、これを指定しなかった場合、internal
ネットワークのIPを取得する可能性があります。traefik.port
は、トラフィックをこのコンテナにルーティングするためにTraefikが使用する必要がある公開ポートを指定します。
この構成では、Dockerホストのポート80
に送信されるすべてのトラフィックは、blog
コンテナーにルーティングされます。
このコンテナを2つの異なるネットワークに割り当てて、Traefikがweb
ネットワーク経由でコンテナを見つけ、internal
ネットワーク経由でデータベースコンテナと通信できるようにします。
最後に、depends_on
キーは、依存関係が実行された後にこのコンテナーを開始する必要があることをDockerComposeに通知します。 WordPressを実行するにはデータベースが必要なため、blog
コンテナーを開始する前に、mysql
コンテナーを実行する必要があります。
次に、ファイルの最後に次の構成を追加して、MySQLサービスを構成します。
docker-compose.yml
... mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: networks: - internal labels: - traefik.enable=false
このコンテナには、公式のMySQL5.7イメージを使用しています。 値のないenvironment
アイテムを再び使用していることに気付くでしょう。 MYSQL_ROOT_PASSWORD
変数とWORDPRESS_DB_PASSWORD
変数は、WordPressコンテナがMySQLと通信できるようにするために、同じ値に設定する必要があります。 mysql
コンテナをTraefikまたは外部に公開したくないので、このコンテナをinternal
ネットワークに割り当てるだけです。 TraefikはDockerソケットにアクセスできるため、プロセスはデフォルトでmysql
コンテナーのフロントエンドを公開します。そのため、ラベルtraefik.enable=false
を追加して、Traefikがこのコンテナーを公開しないように指定します。
最後に、この構成をファイルの最後に追加して、Adminerコンテナーを定義します。
docker-compose.yml
... adminer: image: adminer:4.6.3-standalone labels: - traefik.backend=adminer - traefik.frontend.rule=Host:db-admin.your_domain - traefik.docker.network=web - traefik.port=8080 networks: - internal - web depends_on: - mysql
このコンテナは、公式のAdminerイメージに基づいています。 このコンテナーのnetwork
およびdepends_on
構成は、blog
コンテナーに使用しているものと完全に一致します。
ただし、すべてのトラフィックをDockerホストのポート80
に直接blog
コンテナーに転送しているため、トラフィックがadminer
コンテナ。 行traefik.frontend.rule=Host:db-admin.your_domain
は、要求されたホストを調べるようにTraefikに指示します。 db-admin.your_domain
のパターンと一致する場合、Traefikはトラフィックをadminer
コンテナにルーティングします。
この時点で、docker-compose.yml
には次の内容が含まれているはずです。
docker-compose.yml
version: "3" networks: web: external: true internal: external: false services: blog: image: wordpress:4.9.8-apache environment: WORDPRESS_DB_PASSWORD: labels: - traefik.backend=blog - traefik.frontend.rule=Host:blog.your_domain - traefik.docker.network=web - traefik.port=80 networks: - internal - web depends_on: - mysql mysql: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: networks: - internal labels: - traefik.enable=false adminer: image: adminer:4.6.3-standalone labels: - traefik.backend=adminer - traefik.frontend.rule=Host:db-admin.your_domain - traefik.docker.network=web - traefik.port=8080 networks: - internal - web depends_on: - mysql
ファイルを保存して、テキストエディタを終了します。
次に、コンテナを起動する前に、シェルでWORDPRESS_DB_PASSWORD
変数とMYSQL_ROOT_PASSWORD
変数の値を設定します。
export WORDPRESS_DB_PASSWORD=secure_database_password export MYSQL_ROOT_PASSWORD=secure_database_password
secure_database_password
を目的のデータベースパスワードに置き換えます。 WORDPRESS_DB_PASSWORD
とMYSQL_ROOT_PASSWORD
の両方に同じパスワードを使用することを忘れないでください。
これらの変数を設定した状態で、docker-compose
を使用してコンテナーを実行します。
docker-compose up -d
次に、Traefik管理ダッシュボードをもう一度見てください。 2つの公開されたサーバーにbackend
とfrontend
があることがわかります。
blog.your_domain
に移動します。 TLS接続にリダイレクトされ、WordPressのセットアップを完了することができます。
次に、ブラウザでdb-admin.your_domain
にアクセスし、ドメインをyour_domain
に置き換えて、Adminerにアクセスします。 mysql
コンテナは外界に公開されていませんが、adminer
コンテナは、mysql
を使用して共有するinternal
Dockerネットワークを介してアクセスできます。 ]ホスト名としてのコンテナ名。
管理者ログイン画面で、システムドロップダウンメニューをMySQLに設定します。 次に、サーバーにmysql
と入力し、ユーザー名にroot
と入力し、MYSQL_ROOT_PASSWORD
に設定した値を[ X134X]パスワード。 データベースは空のままにします。 次に、ログインを押します。
ログインすると、Adminerユーザーインターフェイスが表示されます。
現在、両方のサイトが機能しており、monitor.your_domain
のダッシュボードを使用してアプリケーションを監視できます。
結論
このチュートリアルでは、Dockerコンテナー内の他のアプリケーションにリクエストをプロキシするようにTraefikを構成しました。
アプリケーションコンテナレベルでのTraefikの宣言型構成により、より多くのサービスを簡単に構成できます。TraefikはDockerソケットファイルを介して変更にすぐに気付くため、プロキシトラフィックに新しいアプリケーションを追加するときにtraefik
コンテナを再起動する必要はありません。監視しています。
Traefikで何ができるかについて詳しくは、公式のTraefikドキュメントをご覧ください。