C.2. Mod_proxy_cluster.so モジュールとディレクティブ

ロードバランサーが Apache HTTP Server の仮想ホストでどのように作成されるかを定義します。CreateBalancers では、以下の値が使用できます。

定義された Alias が ServerName に対応するかどうかを定義します。UseAlias には、以下の値が有効です。

ProxyPass は、リモートサーバーをローカルサーバーの名前空間にマッピングします。ローカルサーバーに http://local.com/ のアドレスがある場合、ProxyPass ディレクティブは http://local.com/requested/file1 のローカルリクエストを http://worker.local.com/file1 のプロキシーリクエストに変換します。

ProxyPass /requested/ http://worker.local.com/

ProxyPass /requested/ http://worker.local.com/

ProxyPassMatch は正規表現を使用して、プロキシーされた URL が適用されるローカルパスを照合します。

いずれかのディレクティブで、! は指定したパスがローカルであることを示します。そのパスのリクエストはリモートサーバーにルーティングしないでください。たとえば、以下のディレクティブは gif ファイルをローカルで提供するように指定します。

ProxyPassMatch ^(/.*\.gif)$ !

ProxyPassMatch ^(/.*\.gif)$ !

元の URL パスを変更せずにバックエンドに転送するかどうかを定義します。

デフォルト値は Off です。UseNocanon ディレクティブが Off に設定されている場合、プロキシーは変更された URL をバックエンドに転送できます。ただし、クライアントが要求した元の URL パスをバックエンドアプリケーションが想定している場合は、変更された URL パスが原因で予期しない問題が発生する可能性があります。

UseNocanon ディレクティブを On に設定すると、プロキシーは元の URL パスを変更せずにバックエンドに転送できます。この場合、プロキシーの動作は、mod_proxy_cluster.conf ファイルで要求された URL のコンテキストと ProxyPass ディレクティブも定義しているかどうかによって異なります。コンテキストは、仮想ホスト定義 とも呼ばれます。

UseNocanon ディレクティブを On に設定する場合は、次のガイドラインを考慮してください。

ProxyPass または ProxyPassMatch ディレクティブに一致するコンテキストがない場合に、サーバーがクライアントに送信する応答ステータスコードを定義します。

デフォルト値は 404 です。これは、サーバーがデフォルトで Not Found エラー応答を送信することを意味します。

JBCS 2.4.51 以前では、ProxyPass または ProxyPassMatch ディレクティブに一致するコンテキストがない場合、サーバーはデフォルトで 503 Service Unavailable 応答を送信しました。以前のリリースで使用可能だったデフォルトの動作を維持する場合は、代わりに ResponseStatusCodeOnNoContext ディレクティブを 503 に設定します。