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のバージョンを新しいフィックスパックやサービスパックにアップデートする際に、常にモジュールのアップグレードを許可するつもりであれば、アップデート後もこの環境変数を維持することができます。

Liferay DXPのマイナーバージョンのアップデートには、プロジェクトのリポジトリの変更も必要です。

重要

もし、クラスターサービスを使用していて、Liferay データベースのスキーマを変更するバージョン ( サービスパックなど) にアップデートする場合は、以下のステップに従ってください。

以下の手順で、プロジェクトリポジトリの変更点を更新およびデプロイします。

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 サービスは、最終的なデプロイメントの後、希望する数のノードで再起動します。