Documentation

DXPインスタンスを新しいマイナーバージョンにアップデートする

Liferay DXPのインストールを定期的に更新することは、DXP Cloud環境を維持するための重要な要素です。 Liferay DXP Docker Hubページの にある利用可能なタグを使用して、サービスの更新とデプロイを行います。

注釈

新しいメジャーバージョン(Liferay DXP 7.3など)へのアップグレードは、小さいバージョンのアップデートとは異なる手順が必要です。 詳しくは Liferay DXPインスタンスのアップグレード を参照してください。

注釈

もし、 hotfix をインストールしたいのであれば、代わりに these steps を実行してください。

DXP 7.3+のモジュールアップグレードの有効化

まず、DXPの7.3バージョンを更新しているのであれば、環境変数を設定して、必要に応じてモジュールがアップグレードできるようにします。

  1. DXPクラウドのコンソールで、目的の環境のLiferayサービスをクリックします。

  2. 環境変数] タブをクリックします。

  3. LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN 変数の値を trueにしてリストに追加します。

  4. [変更を保存]ボタンをクリックします。

これにより、モジュールはDXPの新しいマイナーバージョンに必要なアップグレードを行うことができます。 DXPのバージョンを新しいフィックスパックやサービスパックにアップデートする際に、常にモジュールのアップグレードを許可するつもりであれば、アップデート後もこの環境変数を維持することができます。

DXPの新しいバージョンへのアップデートと導入

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

重要

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

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

  1. Docker Hub で、アップデートするLiferayのバージョンのタグを見つけます。

  2. リポジトリで、 liferay.workspace.docker.image.liferay のプロパティの値を、 liferay/gradle.properties の新しいバージョンのタグに変更します:

    liferay.workspace.docker.image.liferay=liferay/dxp:7.3.10-ga1
    
  3. この環境変数を、リポジトリの env ブロックの liferay/LCP.json ファイルに追加します。

    {
        "LIFERAY **UPGRADE** PERIOD **DATABASE** PERIOD **AUTO** PERIOD_RUN": "true"
    }
    
  4. 目的の環境のliferayサービスに変更をデプロイします

  5. DXPのバージョン7.3+の場合、今後新しいフィックスパックやサービスパックへのアップグレード時にモジュールのアップグレードを許可しないつもりであれば、Liferayサービスの「環境変数」ページで以前に追加した LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN 環境変数を削除します。

    変更をデプロイすると、 liferay サービスが再起動し、アップデートを完了するために必要なアップグレード手順を開始します。

クラスタリングが有効になっている新しいサービスパックへの更新

データベーススキーマを変更するLiferay DXPのバージョンにアップデートする場合、クラスター化された liferay サービスは、すべてのノードが正しくアップデートされるように、アップデート手順中に一時的な変更が必要になります。

次の手順を実行します:

  1. リポジトリのliferay/LCP.jsonファイルのスケールプロパティを1に設定します:

    {
        "scale": 1,
    }
    
  2. liferay サービスに変更内容をデプロイします

  3. Docker Hub で、アップデートするLiferayのバージョンのタグを見つけます。

  4. liferay/gradle.propertiesliferay.workspace.docker.image.liferayのプロパティの値を、新しいバージョンのタグに変更します:

    liferay.workspace.docker.image.liferay=liferay/dxp:7.3.10-ga1
    
  5. liferay/LCP.jsondeployment strategyRecreateに設定します。

    {
        "strategy": {
            "type": "Recreate"
        }
    }
    
  6. liferayサービスにこれらの変更内容をデプロイします

    お客様の liferay サービス上のLiferay DXPインストールは、起動時に新しいバージョンに更新されます。 ただし、一時的に行われたサービスの変更を元に戻す必要があります。

  7. scale プロパティを、 liferay/LCP.jsonで希望するノード数に戻します:

    {
        "scale": 3,
    }
    
  8. liferay/LCP.json のデプロイメントストラテジーを元の値に戻します(もしくはバージョン更新のためだけに追加されたプロパティを削除します)。

  9. もう一度変更内容をデプロイします

  10. DXPのバージョン7.3+の場合、今後新しいフィックスパックやサービスパックへのアップグレード時にモジュールのアップグレードを許可しないつもりであれば、Liferayサービスの「環境変数」ページで以前に追加した LIFERAY_UPGRADE_PERIOD_DATABASE_PERIOD_AUTO_PERIOD_RUN 環境変数を削除します。

    更新された liferay サービスは、最終的なデプロイメントの後、希望する数のノードで再起動します。