DXPインスタンスを新しいマイナーバージョンにアップデートする¶
Liferay DXPのインストールを定期的に更新することは、DXP Cloud環境を維持するための重要な要素です。 Liferay DXP Docker Hubページの にある利用可能なタグを使用して、サービスの更新とデプロイを行います。
注釈
新しいメジャーバージョン(Liferay DXP 7.3など)へのアップグレードは、小さいバージョンのアップデートとは異なる手順が必要です。 詳しくは Liferay DXPインスタンスのアップグレード を参照してください。
注釈
もし、 hotfix をインストールしたいのであれば、代わりに these steps を実行してください。
DXP 7.3+のモジュールアップグレードの有効化¶
まず、DXPの7.3バージョンを更新しているのであれば、環境変数を設定して、必要に応じてモジュールがアップグレードできるようにします。
DXPクラウドのコンソールで、目的の環境のLiferayサービスをクリックします。
[環境変数] タブをクリックします。
LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN
変数の値をtrue
にしてリストに追加します。[変更を保存]ボタンをクリックします。
これにより、モジュールはDXPの新しいマイナーバージョンに必要なアップグレードを行うことができます。 DXPのバージョンを新しいフィックスパックやサービスパックにアップデートする際に、常にモジュールのアップグレードを許可するつもりであれば、アップデート後もこの環境変数を維持することができます。
DXPの新しいバージョンへのアップデートと導入¶
Liferay DXPのマイナーバージョンのアップデートには、プロジェクトのリポジトリの変更も必要です。
以下の手順で、プロジェクトリポジトリの変更点を更新およびデプロイします。
Docker Hub で、アップデートするLiferayのバージョンのタグを見つけます。
リポジトリで、
liferay.workspace.docker.image.liferay
のプロパティの値を、liferay/gradle.properties
の新しいバージョンのタグに変更します:liferay.workspace.docker.image.liferay=liferay/dxp:7.3.10-ga1
この環境変数を、リポジトリの
env
ブロックのliferay/LCP.json
ファイルに追加します。{ "LIFERAY **UPGRADE** PERIOD **DATABASE** PERIOD **AUTO** PERIOD_RUN": "true" }
目的の環境の
liferay
サービスに変更をデプロイします。DXPのバージョン7.3+の場合、今後新しいフィックスパックやサービスパックへのアップグレード時にモジュールのアップグレードを許可しないつもりであれば、Liferayサービスの「環境変数」ページで以前に追加した
LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN
環境変数を削除します。変更をデプロイすると、
liferay
サービスが再起動し、アップデートを完了するために必要なアップグレード手順を開始します。
クラスタリングが有効になっている新しいサービスパックへの更新¶
データベーススキーマを変更するLiferay DXPのバージョンにアップデートする場合、クラスター化された liferay
サービスは、すべてのノードが正しくアップデートされるように、アップデート手順中に一時的な変更が必要になります。
次の手順を実行します:
リポジトリの
liferay/LCP.json
ファイルのスケール
プロパティを1
に設定します:{ "scale": 1, }
liferay
サービスに変更内容をデプロイします。Docker Hub で、アップデートするLiferayのバージョンのタグを見つけます。
liferay/gradle.properties
のliferay.workspace.docker.image.liferay
のプロパティの値を、新しいバージョンのタグに変更します:liferay.workspace.docker.image.liferay=liferay/dxp:7.3.10-ga1
liferay/LCP.json
でdeployment strategy をRecreate
に設定します。{ "strategy": { "type": "Recreate" } }
liferay
サービスにこれらの変更内容をデプロイします。お客様の
liferay
サービス上のLiferay DXPインストールは、起動時に新しいバージョンに更新されます。 ただし、一時的に行われたサービスの変更を元に戻す必要があります。scale
プロパティを、liferay/LCP.json
で希望するノード数に戻します:{ "scale": 3, }
liferay/LCP.json
のデプロイメントストラテジーを元の値に戻します(もしくはバージョン更新のためだけに追加されたプロパティを削除します)。もう一度変更内容をデプロイします。
DXPのバージョン7.3+の場合、今後新しいフィックスパックやサービスパックへのアップグレード時にモジュールのアップグレードを許可しないつもりであれば、Liferayサービスの「環境変数」ページで以前に追加した
LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN
環境変数を削除します。更新された
liferay
サービスは、最終的なデプロイメントの後、希望する数のノードで再起動します。