プロキシサーバーの設定(非OCPインストール)
Application Modernization Accelerator プロキシサーバー経由で動作するよう設定可能であり、負荷分散と強化されたセキュリティをサポートします。
注記: プロキシを使用するように設定すると、プロキシのみがサポート URL されます。 代替URL(マシンIPなど)は今後サポートされません。
Application Modernization Accelerator 構成
外部からアクセス可能な設定を URL プロキシサーバーのものに設定する必要があります。 これらの変更は .env と .env_orig ファイルで行ってください。
- インストール先へ移動し、AMA_LOCALを停止してください。
./launch.sh
Choose Stop Application Modernization Accelerator from the menu option
- 設定を更新してください。
cd scripts
vi .env
- プロキシサーバーに基づいて、以下の変数を適切な値で更新してください
- [PROXY_URL]: プロキシサーバーが待機している URL URL。 このプレースホルダーに値を入力する必要があります。
- [PROXY_PORT]: プロキシサーバーが待機しているポート番号。 このプレースホルダーに値を入力する必要があります。
TA_LOCAL_PUBLIC_ACCESSIBLE_API_SERVER_URL=<protocol>://[PROXY_URL]:[PROXY_PORT]
TA_PUBLIC_ACCESSIBLE_UI_URL=<protocol>://[PROXY_URL]:[PROXY_PORT]
vi .env_orig
- プロキシサーバーに基づいて、以下の変数を適切な値で更新してください
- [PROXY_URL]: プロキシサーバーが待機している URL URL。 このプレースホルダーに値を入力する必要があります。
- [PROXY_PORT]: プロキシサーバーが待機しているポート番号。 このプレースホルダーに値を入力する必要があります。
TA_LOCAL_PUBLIC_ACCESSIBLE_API_SERVER_URL=<protocol>://[PROXY_URL]:[PROXY_PORT]
TA_PUBLIC_ACCESSIBLE_UI_URL=<protocol>://[PROXY_URL]:[PROXY_PORT]
- 認証を有効にしている場合は、コールバックURIも更新する必要があります
vi .security_config
TA_LOCAL_TA_AUTH_OIDC_CALLBACK_URI=<protocol>://[PROXY_URL]:[PROXY_PORT]/auth/callback
- では、AMA_LOCAL を開始します。
./launch.sh
Choose Start Application Modernization Accelerator from the menu option
プロキシー・サーバーの構成
必要な具体的な手順は、使用しているプロキシサーバーによって異なります。 AMA_LOCALが機能するためには、プロキシサーバーが以下をサポートしていることを確認する必要があります:
- UIポート(3000または3443)およびアドバイザーポート(2220)へのプロキシ
- ファイルの最大アップロードサイズは、データに十分な大きさである必要があります。推奨されるデフォルト値は 250MB
- UIプロキシはWebソケットをサポートする必要があります
- TLS が有効化されている場合、 SSL をサポートし、適切な証明書でプロキシを設定する必要があります。
nginx のサンプル設定
nginxに必要な最小構成を示すサンプル設定を以下に示します。 具体的な環境と要件に基づいて、追加の設定を適用する必要があります。
この例では:- プロキシサーバーは で利用可能です- proxy.example.com AMA_LOCAL は で利用可能です ta.example.com
サンプルの非 TLS 構成
server {
listen 3000;
server_name proxy.example.com;
client_max_body_size 250M; #Max upload size
location /lands_advisor/ {
proxy_pass http://ta.example.com:2220;
}
location / {
proxy_pass http://ta.example.com:3000;
#Support websockets
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
TLS 設定例
このサンプルでは、プロキシが自身の自己署名証明書を生成し、それがスニペットに保存されていることを前提としています。
server {
listen 3443 ssl;
include snippets/self-signed.conf;
server_name proxy.example.com;
client_max_body_size 250M; #Max upload size
location /lands_advisor/ {
proxy_pass https://ta.example.com:2220;
}
location / {
proxy_pass https://ta.example.com:3443;
#Support websockets
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
この self-signed.conf ファイルは、証明書と鍵の場所を参照しています。 これはサンプル self-signed.conf ファイルです。
ssl_certificate /etc/ssl/certs/nginx-selfsigned.crt;
ssl_certificate_key /etc/ssl/private/nginx-selfsigned.key;