ポータルプロパティの設定

従来のデプロイメントでは、 ポータルプロパティ は portal-ext.properties および関連ファイルを通じて構成されます。 CNEでは、それらはGitOps liferay.yamlの portalProperties フィールドで定義されます。 変更内容はバージョン管理され、監査可能で、簡単に元に戻すことができます。

これは、すべてのクラウドプロバイダー対応ツールキットに適用されます。 AWS Ready または GCP Ready を使用してデプロイする場合でも、手順は同じです。

ポータルプロパティを設定する前に、以下のものを用意してください。

• ブートストラップ済みの CNE 環境（AWSまたはGCP の「はじめに」を参照）
• GitOpsリポジトリへの書き込みアクセス権
• Argo CDダッシュボードへのアクセス

基本プロパティの設定

すべての環境のポータルプロパティを設定するには、

1. プロジェクトの基本ファイル liferay.yaml を開きます。

   liferay/projects/[projectId]/base/liferay.yaml
   

2. portalProperties ブロックを liferay-default: の下に、 key=value の形式で追加します。 portal.properties と同じです。

   liferay-default:
     portalProperties: |
       my.custom.property=value
       company.default.web.id=liferay.com
   

3. 変更内容をコミットして、GitOpsリポジトリにプッシュしてください。 リポジトリでプルリクエストが必要な場合は、マージして変更を適用してください。

   ヒント

   プルリクエストがマージされると、Argo CDは変更を検知し、環境を自動的に同期します。

4. Argo CDダッシュボードで、アプリケーションのステータスが「同期済み」になっていることを確認してください。 同期が完了すると、Liferayポッドは更新された設定で再起動します。

CNE は portalProperties の内容を中央の ConfigMap 内の portal-cloud.properties に書き込みます。 portal-ext.properties は include-and-override=portal-cloud.propertiesを介してそれをインクルードするため、これらの設定は基本ポータルプロパティのデフォルトよりも優先されます。

重要

プラットフォームが管理するプロパティの一部 ( web.server.http.port や schema.module.build.auto.upgradeなど) は、 portal-cloud.properties のエントリの後に追加され、 portalProperties で設定した一致するキーよりも優先されます。 アプリケーション固有の設定には、 portalProperties のみを使用してください。

環境ごとの上書き設定

特定の環境で異なるポータルプロパティを使用するには、環境固有の liferay.yaml に portalProperties ブロックを追加します。

liferay/projects/[projectId]/environments/[environmentId]/liferay.yaml

重要

環境固有の portalProperties ブロックは、その環境の基本構成を完全に置き換えます。 各環境のブロックには、必要なプロパティをすべて含めてください。 — 共有プロパティと環境固有のプロパティの両方 — を含めてください。 環境ファイルに portalProperties キーが定義されていない場合、基本構成は変更されずに適用されます。

liferay-default:
  portalProperties: |
    my.custom.property=dev-value
    feature.flag.LPS-000000=true

関連トピック

• ポータルプロパティ
• CNE AWS Ready: Helm 値リファレンス
• CNE GCP対応：Helm Valuesリファレンス