Haproxy Docker Compose (開発者向けの仕組み)

HAProxy Dockerの特徴

Dockerを使用してHAProxyをインストールして実行するのは比較的簡単なプロセスです。 以下に、一度に一つずつ実行される手順を示します。

Dockerのインストール

Dockerがシステムにインストールされていることを確認します。 インストールを確認するには、次のコマンドを実行できます:

docker --version

docker --version

Dockerがシステムにインストールされていない場合は、公式ウェブサイトから Dockerリンク を訪れてダウンロードしてインストールしてください。

HAProxy Dockerイメージをプルする

Docker Hubから公式のHAProxyイメージをプルします。 以下のコマンドは、最新の安定バージョンをダウンロードします:

docker pull haproxy:latest

docker pull haproxy:latest

HAProxy設定ファイルを作成する

HAProxyは、その動作を定義する設定ファイルを必要とします。 haproxy.cfgというファイルを、以下の内容で作成します:

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    timeout connect 5s
    timeout client  50s
    timeout server  50s
frontend http_front
    bind *:80
    default_backend http_back
backend http_back
    server app1 host.docker.internal:32769 check

このHAProxy設定が定義するもの:

• フロントエンド: ポート80でリッスンして、トラフィックをバックエンドにルーティングします。
• バックエンド: host.docker.internal:32769でホストされているapp1を指します。

HAProxy Dockerコンテナを実行する

設定ファイルをマウントし、必要なポートを公開してHAProxy Dockerコンテナを実行します:

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

• -d: コンテナをデタッチモードで実行します。
• --name haproxy-container: コンテナに名前を付けます。
• -p 80:80: ホストのポート80をコンテナのポート80にマッピングします。
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: ローカル設定ファイルをコンテナ内にマウントします。

HAProxyにアクセスする

ウェブブラウザを開いて、http://localhost:80またはサーバーのIPアドレスを指定してトラフィックルーティングをテストします。

IronSecureDoc をインストールして実行する

コマンドプロンプトやオープンなターミナルウィンドウで次のコマンドを使用して、IronSecureDocのDockerイメージをプルします:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

IronSecureDocコンテナを実行します:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

このコマンドはIronSecureDocのコンテナインスタンスを開始します。 これでポートhttp://localhost:8080/swagger/index.htmlにてIronSecureDocにアクセスできます。

HAProxyとのIronSecureDocの統合

フロントエンドとバックエンドの設定を定義するためにhaproxy.cfgファイルを準備します。 以下は簡単な設定例です:

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    option  httplog
    timeout connect 5000ms
    timeout client  50000ms
    timeout server  50000ms
frontend http_front
    bind *:4500
    acl body_has_data req.hdr_val(Content-Length) gt 0
    http-request set-method POST if METH_GET body_has_data
    use_backend ironsecuredoc if { path /ironsecuredoc } || { path_beg /ironsecuredoc/ }
    use_backend ironsecuredoc_ping if { path /ping } || { path_beg /ping/ }
    use_backend ironsecuredoc_encrypt if { path /encrypt } || { path_beg /encrypt/ }
backend ironsecuredoc
    balance roundrobin
    http-request set-path /swagger/index.html
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_encrypt
    balance roundrobin
    http-request set-path /v1/document-services/pdfs/encrypt
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_ping
    balance roundrobin
    http-request set-path /v1/document-services/ping
    server ironsecuredoc_server host.docker.internal:8080 check

このHAProxy設定は、複数のIronSecureDocサービスのためにHTTPトラフィックを処理します。 それはグローバル生データログ出力を定義し、詳細なログを持つデフォルトのHTTPモードを設定します。 フロントエンドはポート4500で要求を基にパスに基づいてルーティングします。 acl body_has_dataはデータの存在をチェックし、必要に応じてGETリクエストをPOSTに変換します。 バックエンドは、ラウンドロビンアルゴリズムを使用して負荷分散を行い、サーバーの可用性を確認するための健全性チェックを通じて、適切に要求を転送します。

cURLを使用してシンプルな暗号化要求を送信するには:

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

IronSecureDoc APIへのこの要求は、PDF文書にユーザーパスワード暗号化を適用し、出力ファイルを安全に送信しダウンロードします。