Documentation

ウェブサーバサービス(Nginx)

Nginx Webサーバーは、オープンインターネットからDXP クラウドサービスへのゲートウェイとして機能します。 ユーザーからのすべてのトラフィックを処理し、高性能なWebサーバーとして機能します。

図1:Webサーバーは、DXPクラウドで利用できるいくつかのサービスのうちの一つです。

詳細は、 Web server service limitations のセクションを参照してください。

設定

DXP Cloudのサービスはデフォルトでうまく機能するように微調整されていますが、さらにNginxを設定する必要がある場合があります。 これを行うには、 configs/{ENV}/conf.d/ フォルダー内に任意のCONFファイルを含めることができます。 変更をデプロイすると、ファイルが自動的にサービスに挿入され、デフォルトの設定が上書きされます。 以下は、 正しいディレクトリ内のそのようなファイルのフォルダー構造の例です:

webserver
├── configs
│   └── common
│       └── conf.d
│           └── nginx.conf
└── LCP.json

/webserver/configs/{ENV}/内のファイルは、DXP Cloudのウェブサーバコンテナ内の /etc/nginx/にオーバーライドとしてコピーされます。 /webserver/configs/{ENV}/public/のファイルはオーバーライドとしてvar/www/html/にコピーされます。

注釈

バージョン3.x.xのサービスを使用している場合は、Nginxの設定は適切な[lcp/webserver/config/{ENV}/]ディレクトリに属しています。 バージョンの確認方法については, サービススタックのバージョンについて を参照してください.

環境変数

これらの環境変数は、Webサーバーサービスで利用できます:

名称

デフォルト値

説明

LCP_HAPROXY_RESOLVER_HOLD_TIME

10

HAProxyロードバランサーの ホールド 構成 の設定を行います。 この構成は、 有効な ステータス用です。

LCP_HAPROXY_RESOLVER_RETRIES

3

HAProxyロードバランサーの resolve_retries の構成 を行います(再試行回数は、セッションがあきらめる前に、サーバーに接続しようとします)。

LCP_HAPROXY_RESOLVER_TIMEOUT_RESOLVE

1

HAProxyロードバランサーの タイムアウト 構成 の設定を行います(イベントタイムアウトの秒数)。 この構成は、 解決する イベント用です。

LCP_HAPROXY_RESOLVER_TIMEOUT_RETRY

1

HAProxyロードバランサーの タイムアウト 構成 の設定を行います(イベントタイムアウトの秒数)。 この構成は、 再試行 のイベント用です。

LCP_HAPROXY_SERVER_TEMPLATE_BACKEND_NUM

10

任意のサービスの最大インスタンス数を上書きします。 オートスケーリングを使用する場合は、必要な最大値を設定してください。

LCP_WEBSERVER_LOG_FORMAT

Nginxログの形式をカスタマイズします。 official Nginx documentation を参照してください。

のIngress ロードバランサー もWebサーバーサービスで設定されます。 このサービスに環境変数を追加して、ロードバランサーやカスタムドメインを設定することができます。 詳細については、 the Load Balancer environment variables reference を参照してください。

Nginx の環境変数やその他の設定はすべて official Nginx documentation にあります。 サービスのLCP.jsonファイルで、configs/{ENV}/ディレクトリと環境変数を設定することができます。

スクリプト

スクリプトを使用して、より広範なカスタマイズを行うことができます。 ただし、これを行う際は注意してください。 これは、Webサーバーサービスをカスタマイズする最も強力な方法であり、望ましくない副作用を引き起こす可能性があります。

configs/{ENV}/scripts/フォルダーにある .sh ファイルは、サービスを開始する前に実行されます。 たとえば、すべてのログファイルを削除するスクリプトを含めるには、次のディレクトリ構造に配置します:

webserver
├── configs
│   └── common
│       └── scripts
│           └── remove-log-files.sh
└── LCP.json

注釈

バージョン3.x.xのサービスを使用している場合、ウェブサースクリプトは適切な[lcp/webserver/script/{ENV}/]ディレクトリに置かれます。 バージョン確認の詳細については、 サービススタックのバージョンについて を参照してください。