Liferay DXPサービスの使用
Liferayのサービスは、あらゆるプロジェクトの心臓部です。 アプリケーションのLiferay DXPインスタンスを実行し、Webサーバー、Elasticsearch、MySQLデータベースなどの他のサービスとやり取りします。
Liferay CloudのLiferayサービスは、オンプレミスのLiferay DXPのインスタンスと多くの点で同じように使用することができます。 しかし、Liferay Cloudのインスタンスで作業する場合、設定や開発ワークフローにいくつかの違いがあります。
詳しくは、 Liferay service limitations を参照してください。
バージョンの選択
使用しているLiferay DXPのメジャーバージョンは、Gitリポジトリのliferay/
フォルダのLCP.json
ファイル内で設定されています。 LCP.json
ファイル内のDockerイメージ名を使用してメジャーバージョンを image
変数として設定します。
"image": "liferaycloud/liferay-dxp:7.2-4.0.1"
同じ liferay/
フォルダ内のgradle.properties
ファイルで、サービスパックとフィックスパックを定義します。 liferay.workspace.docker.image.liferay
プロパティは、実際のデプロイに使用される、この特定のフィックスパックレベルを持つ別のDockerイメージ名を定義します。
liferay.workspace.docker.image.liferay=liferay/dxp:7.2.10-sp2-202005120922
もしあなたの Liferay Cloud スタックがまだ 4.x.x にアップデートされていない場合、デフォルトではこのバージョンはリポジトリのルートにある gradle.properties
ファイルに格納されます。 この場合、liferay.workspace.lcp.liferay.image
プロパティでバージョンを定義します(メジャーバージョンとは別に定義する必要はありません)。 バージョンの確認方法については,Understanding Service Stack Versions_を参照してください。
Services Changelog for Liferay Cloud で、新リリースごとのリファレンスを確認することができます。 新しい各サービスアップデートには、インスタンスに使用できるDockerイメージが含まれています。 また、 Docker HubのDXPタグ を直接確認して、使用するDockerイメージ名を探すこともできます。
リリースメモに記載されている新しいバージョンを使用して、Dockerイメージの値を更新します。 新しいDockerイメージは、インスタンスの起動時、または次回リポジトリからLiferayサービスをデプロイするときに使用されます。 新しいリリースのDockerイメージを使用して、他のサービスのプロパティをアップグレードすることもできます。
デプロイメント(カスタマイズ、パッチ適用、ライセンス)
Liferay DXPへのカスタム追加の導入には、Gitリポジトリの適切な場所への新しいモジュール、ライセンス、またはホットフィックスの追加が含まれます。
common/
ディレクトリを除き、特定の環境フォルダ(dev
、uat
、prod
など)に追加された変更は、対応する環境にデプロイするときに のみ 伝播されます。 common/
ディレクトリに追加された変更は、ターゲットのデプロイ環境に関係なく、 常に デプロイされます。 これは、すべてのサービスにおいて、 configs/
ディレクトリ内のすべてのサブフォルダに適用されます。
Liferayサービスは、他のサービスに比べて多くのカスタマイゼーション(ホットフィックスの追加、モジュールのソースコードの構築など)を提供しているため、サービスをデプロイする際には、いくつかの考慮すべき点があります。 詳しくは Liferayサービスへのデプロイ を参照してください。 また、一般的なデプロイメントワークフローについては、 Overview of Deployment Workflow を参照してください。 Liferay Cloud へのデプロイのチュートリアルについては、 Deploying Changes via DCP Cloud Consoleをご覧ください。
設定
portal.properties
変更など、Liferayサービスに設定を適用するには、Gitリポジトリに設定を追加し、変更をGitにプッシュする必要があります。 これらの設定ファイルの追加の詳細は、 Liferay DXPサービスの設定参照してください。
環境変数は、Liferayサービスの設定にも使用され、場合によってはポータルのプロパティをオーバーライドすることもあります。 詳しくは、 Liferayサービス環境変数 を参照してください。
ホットデプロイ
ホットデプロイは、Liferay DXP UIを介して実行できます。 これを行うには、[コントロールパネル]→[アプリ]→[アプリマネージャー]に移動します。 次に、右上の点をクリックして、[アップロード]をクリックします。 この画面から、ローカルファイルシステムからファイルを選択してデプロイおよびインストールできます。
Liferay Cloudでホットデプロイを使用することは not 推奨されません。この方法でデプロイされたカスタマイズは、その後のLiferayサービスのデプロイ時に失われてしまうからです。
クラスタリングを有効にする
Liferay DXP を Liferay Cloud でクラスタリングすることは、Liferay DXP で行うのに比べて非常に簡素化されたプロセスです。 Liferay Cloudでは、クラスタリングのサポートが利用可能で、すぐに有効になります。 クラスタリングの動作とスケールのための追加の設定には、いくつかの追加の手順が必要です。 詳しくは、 Liferay Cloud でクラスタリングを設定する を参照してください。
スクリプトの実行
configs/{ENV}/scripts
フォルダーにある .sh
ファイルは、サービスを開始する前に自動的に実行されます。 スクリプトは、より広範なカスタマイズに使用できます。 ただし、これを行う際は注意してください。 これはLiferay DXPをカスタマイズする最も強力な方法であり、望ましくない副作用を引き起こす可能性があります。
例えば、すべてのログファイルを削除するスクリプトを含めるには、プロジェクトのGitリポジトリ内の次のディレクトリ構造に配置します。
liferay
├── LCP.json
└── configs
└── dev
├── deploy
├── osgi
├── patching
└── scripts
└── remove-log-files.sh
バージョン3.x.xのサービスを使用している場合、スクリプトは代わりにリポジトリの lcp/liferay/script/
フォルダに入ります。 バージョンの確認方法については,Understanding Service Stack Versions_を参照してください。
制限事項
Liferay DXPには、コンテンツを構築、管理、Webにデプロイするための強力な機能が多数搭載されています。 しかし、それらの機能の中には、Liferay Cloudで利用できないものもあります。
- Remote Staging は、現在 Liferay Cloud ではサポートされていません。 オンプレミスインストールから Liferay Cloud に移行するユーザーは、Staging 機能を継続して使用するために Local Staging に変換する必要があります。