ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、こちらまでご連絡ください。

Liferay DXPサービスの設定　

Liferay PaaS で DXP を構成するには、いくつかの方法があります。 DXP システム設定を使用する方法と、 config およびプロパティファイルを使用する方法です。 Liferay PaaS の Liferay DXP インスタンスの DXP プロパティおよび構成ファイルは、リポジトリの Liferay DXP サービスディレクトリにある configs/ フォルダーのいずれかに配置することでデプロイされます。

liferay
├── configs
│   ├── common
│   ├── dev
│   ├── local
│   ├── prd
│   └── uat
└── LCP.json

common/ディレクトリを除き、特定の環境フォルダ（dev、uat、prodなど）に追加された変更は、対応する環境にデプロイするときにのみプロパゲートされます。 common/ディレクトリに追加された変更は、ターゲットのデプロイ環境に関係なく、常にデプロイされます。これは、すべてのサービスにおいて、 configs/ ディレクトリ内のすべてのサブフォルダに適用されます。

ポータルプロパティ

ポータルプロパティは、 portal-ext.properties ファイルに保存されるプロパティです。これらは、Liferay DXP環境の設定に使用されます。

オンプレミスのLiferay DXPインスタンスの場合、このファイルは $LIFERAY_HOMEの中に属します。 Liferay PaaS を使用する場合は、ポータルプロパティファイルを適切な configs/[ENV]/ フォルダーに配置して、デプロイ時に Liferay DXP インスタンス用に $LIFERAY_HOME にコピーします。

例えば、開発環境のプロパティは、 configs/common ディレクトリのプロパティファイルと、 configs/dev ディレクトリのプロパティから構成されています。同名のファイルがある場合は、環境固有のディレクトリにあるファイルが、 共通の ディレクトリにあるファイルを上書きします。

ポータルプロパティを複数のファイルに分割する

デフォルトでは、Liferayは portal-ext.properties ファイルのみから直接プロパティを読み取りますが、環境固有のファイルなど、リポジトリ内の異なるファイルにプロパティを整理しておくと便利です。ポータルプロパティを上書きするために、追加のファイルを定義することができます。

portal-all.properties：環境全体でLiferay DXPを変更するプロパティが含まれています
portal-env.properties：現在の環境にのみ影響するプロパティが含まれます（たとえば、環境ごとに異なる外部サービスの認証情報とURLエンドポイント）

これらのファイルを使用するには、 portal-ext.properties ファイルが、 portal-all.properties および portal-env.properties を、 include and override プロパティを使用して、明示的にインポートする必要があります。

include-and-override=/opt/liferay/portal-all.properties
include-and-override=/opt/liferay/portal-env.properties

そして、以下のような構造でプロパティを整理することができます：

liferay
├── configs
│   ├── common
│   │   ├── portal-ext.properties
│   │   └── portal-all.properties
│   ├── dev
│   │   └── portal-env.properties
│   ├── local
│   │   └── portal-env.properties
│   ├── prd
│   │   └── portal-env.properties
│   └── uat
│       └── portal-env.properties
└── LCP.json

portal-ext.properties と portal-all.propertiesファイルは、すべての環境で共有されます。そこに共有のプロパティを追加し、それぞれの portal-env.properties ファイルに環境固有のプロパティを追加することができます。詳細については、ポータルプロパティの優先度を参照してください。

注

ポータルプロパティは、環境変数として定義することもできます。詳細は環境変数のリファレンスを参照。

OSGiの構成

OSGi 構成 (.cfg または .config ファイル) は、Liferay DXP で OSGi コンポーネントを構成するために使用されます。

これらの構成ファイルは、 $LIFERAY_HOME内の osgi/configs/ フォルダに属しています。 Liferay Cloud を使用する場合は、これらのファイルを適切な configs/[ENV]/osgi/ フォルダーに配置して、デプロイ時に Liferay DXP インスタンス用に /osgi/configs にコピーします。

Tomcatの設定

適切な環境の liferay/configs/[ENV] フォルダーにファイルをデプロイして構成ファイルを上書きすることにより、Liferay サービスの Tomcat サーバーを構成します。例えば、Liferay コンテナのファイルシステムにある {TOMCAT HOME}/conf/web.xml ファイルを上書きするには、カスタマイズしたファイルをリポジトリ内の適切な liferay/configs/[ENV]/tomcat/conf/ フォルダに配置し、変更をデプロイします。

注

Liferay Cloud の Liferay コンテナには、2 つの tomcat フォルダが存在します。汎用 tomcat フォルダと、バージョン付きフォルダ (tomcat-xxx です。 tomcat フォルダーには、バージョン管理された tomcat-xxx フォルダーへのシンボリックリンクがあるため、汎用 tomcat フォルダー内のファイルを上書きすると、新しいファイルが両方のフォルダーに反映されます。

警告

Tomcatのデフォルト設定を上書きする場合、Liferay CloudのLiferayサービスは、Cloudプラットフォーム上の閉じたネットワークに存在することに留意してください。オンプレミスのLiferayインストールで変更可能なネットワーク構成の中には、クラウド環境ではデフォルト値から変更できないものや、お客様の環境で問題が発生する可能性のあるものがあります。

主要展開ディレクトリのリファレンス

ファイルの種類	パス	説明
Liferayにファイルをデプロイしました	liferay/configs/[ENV]/deploy/	Liferayに直接デプロイされたファイルには、テーマ、モジュール、ライセンスが含まれます。
OSGi構成	liferay/configs/[ENV]/osgi/configs/	`.cfg` または `.config` OSGi 設定ファイル。
ホットフィックス	liferay/configs/[ENV]/patching/	ホットフィックス `.zip` ファイル。一度に1つの環境に適用できるホットフィックスは1つだけです。
カスタムシェルスクリプト	liferay/configs/[ENV]/scripts/	ここに記述されたスクリプトは、サービス起動時に自動的に実行されます。
その他のオーバーライド	liferay/configs/[ENV]/	LiferayインスタンスのLiferayホームフォルダに属するその他の設定。それらが Liferay Home のサブディレクトリに属するものであれば、このフォルダと同じサブディレクトリに配置してください。

環境変数

Liferay Cloud の Liferay サービスは、オンプレミスインスタンスとは異なる方法で行われる JVM メモリ設定やデータベース接続設定などの一部の設定の代わりに、環境変数 (またはシークレット ) を使用します。環境変数は、ポータルのプロパティを上書きしたり置き換えたりするためにも使用できる。

詳細については、 Liferay サービス環境変数を参照してください。

Capability: