Liferay DXPサービスの使用

Liferayのサービスは、あらゆるプロジェクトの心臓部です。アプリケーションのLiferay DXPインスタンスを実行し、Webサーバー、Elasticsearch、MySQLデータベースなどの他のサービスとやり取りします。

Liferayサービスは、Liferay Cloudで利用できるいくつかのサービスのうちの1つです。

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

note

もしあなたの 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を介して実行できます。これを行うには、［コントロールパネル］→［アプリ］→［アプリマネージャー］に移動します。次に、右上の点をクリックして、[アップロード]をクリックします。この画面から、ローカルファイルシステムからファイルを選択してデプロイおよびインストールできます。

note

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

note

バージョン3.x.xのサービスを使用している場合、スクリプトは代わりにリポジトリの lcp/liferay/script/ フォルダに入ります。バージョンの確認方法については，Understanding Service Stack Versions_を参照してください。