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プロパティでバージョンを定義します（メジャーバージョンとは別に定義する必要はありません）。バージョンチェックの詳細については、サービススタックのバージョンについてを参照してください。

Liferay Cloudの Services Changelog を確認して、新リリースごとのリファレンスを確認できます。新しい各サービスアップデートには、インスタンスに使用できる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 CloudでのLiferay DXPのクラスタリングは、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

制限事項

Liferay DXPには、コンテンツを構築、管理、Webにデプロイするための強力な機能が多数搭載されています。しかし、その中にはLiferay Cloudでは利用できない機能もあります。

リモート本番環境ステージングの設定は、現在Liferay Cloudではサポートされていません。オンプレミスからLiferay Cloudに移行する場合、ステージング機能を継続して使用するためには、ローカルステージングに変更する必要があります。