クライアント拡張機能用のLiferay PaaSの設定

Webサーバーの構成

デフォルトでは、Liferay PaaS のすべての非本番環境では、アクセスするために基本認証（Web ブラウザ経由）が必要です。 この要件により、開発環境が保護され、サイトの開発者だけが閲覧できるようになります。

ただし、基本認証の要件により、クライアント拡張機能はデフォルトでサービス間で通信できなくなります。 クライアント拡張機能がこの制約を回避できるように、Web サーバー上で例外を構成することができます。

1. プロジェクトのリポジトリで、目的の環境の webserver/configs/<ENV>/conf.d/ フォルダーに移動します (例: webserver/configs/dev/conf.d/)。

2. proxy.includeという新しいファイルを追加します。

   touch proxy.include
   

3. これらの内容をコピーして proxy.include ファイルに保存します。

   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;
   proxy_set_header X-Forwarded-Port $http_x_forwarded_port;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $http_x_forwarded_for;
   proxy_set_header Upgrade $http_upgrade;
   proxy_set_header Connection $http_connection;
   proxy_hide_header liferay-portal;
   
   proxy_pass http://upstream_server;
   proxy_http_version 1.1;
   proxy_intercept_errors on;
   

4. 同じフォルダで、 liferay.conf ファイルを編集し、内容を次のように置き換えます。

   location /o {
       include /etc/nginx/conf.d/proxy.include;
   }
   
   location / {
       auth_basic "Authentication Required";
       auth_basic_user_file /var/www/html/.htpasswd;
   
       include /etc/nginx/conf.d/proxy.include;
   }
   

5. これらの変更を保存してリポジトリにコミットします。

   git commit -m "Configure dev web server for client extensions."
   

6. 通常のワークフローを使用してビルドをプッシュし、選択した環境にデプロイします

ビルドが完了すると、Web サーバーはクライアント拡張機能が Liferay DXP サービスと通信できるように構成されます。

互換性のないLiferay DXP構成

Liferay DXP の特定の構成は、クライアント拡張機能と互換性がありません。 環境にクライアント拡張機能を展開するときに問題を回避するには、これらの構成を削除します。

環境変数

LIFERAY_COMPANY_PERIOD_DEFAULT_PERIOD_VIRTUAL_PERIOD_HOST_PERIOD_NAME
LIFERAY_COMPANY_PERIOD_DEFAULT_PERIOD_VIRTUAL_PERIOD_HOST_PERIOD_SYNC_PERIOD_ON_PERIOD_STARTUP
LIFERAY_MODULE_PERIOD_FRAMEWORK_PERIOD_PROPERTIES_PERIOD_ORG_PERIOD_APACHE_PERIOD_FELIX_PERIOD_CONFIGADMIN_PERIOD_PLUGIN_PERIOD_INTERPOLATION_PERIOD_SECRETSDIR
LIFERAY_VIRTUAL_PERIOD_HOSTS_PERIOD_VALID_PERIOD_HOSTS
LIFERAY_WEB_PERIOD_SERVER_PERIOD_PROTOCOL

OSGiの構成

"com.liferay.portal.http.internal.configuration.HttpConfiguration",
"com.liferay.portal.k8s.agent.override.OverridePortalK8sAgentConfiguration",
"com.liferay.portal.workflow.configuration.WorkflowDefinitionConfiguration"

ポータルプロパティ

company.default.virtual.host.name
company.default.virtual.host.sync.on.startup
module.framework.properties.org.apache.felix.configadmin.plugin.interpolation.secretsdir
virtual.hosts.valid.hosts
web.server.protocol

関連トピック

• クライアント拡張
• Liferay PaaSへのクライアント拡張機能の導入