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

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/configs/[ENV]/tomcat/conf/ フォルダに配置し、変更をデプロイすることで、Liferay コンテナのファイルシステム内の {TOMCAT HOME}/conf/web.xml ファイルを上書きできます。

注

Liferay Cloud の Liferay コンテナには、汎用の tomcat フォルダとバージョン管理されたフォルダ (tomcat-xxx) の 2 つの tomcat フォルダが存在します。 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 のサブディレクトリに属している場合は、このフォルダの同じサブディレクトリに配置します。