ステージ1：DXPバージョンの一致

移行の第一段階として、Liferay Cloud上で動作するLiferayサービスが、移行したいインストールと同じバージョンで動作するように設定します。

そのためには、Liferay Cloudのリポジトリをクローンし、そこにバージョン変更の設定を行い、ビルドをデプロイすることでLiferay Cloudにその更新を戻す必要があります。

Liferayのバージョン情報を検索する

まず、移行したい Liferay DXPインストールのバージョン番号とインストールされているパッチを探します。 Liferay Cloud で Liferay サービスを適切に設定するために、これらの値が必要です。

これらの値を求めるには、パッチングツールを使用します。

1. 移行するインストールにパッチ適用ツールをインストールするには、 ここ の指示に従ってください。

2. 任意のコマンドラインツールでパッチングツールフォルダーに移動します。

   cd $LIFERAY_HOME/patching-tool
   

3. パッチツールを使用して、インストールのバージョン情報を取得します。

   ./patching-tool.sh info
   

パッチツールは、ビルドバージョン、インストールされているフィックスパックやホットフィックスなど、パッチとバージョン情報を表示します。

今後のステップのために、この情報をメモしておいてください。

Liferay Cloudリポジトリのクローンを作成する

Liferay Cloud は、プロジェクトとともに GitHub 上にリポジトリを提供します。 各サービスの LCP.json ファイルなど、プロジェクト内の一部のファイルを構成するには、リポジトリのクローンをローカルに用意する必要があります。

リポジトリのクローンを作成していない場合は、 Git がインストール されている任意のターミナルを使用して、ローカルにクローンを作成します。

git clone https://github.com/dxpcloud/acme

リポジトリ内のLiferay DXPイメージを更新する

次に、 以前にクローンしたリポジトリ内の Liferay DXP イメージを更新します。 このため、Liferayインストールのバージョン情報と互換性のあるDockerイメージを見つける必要があります。

1. Docker Hubの Liferay DXPイメージ ページに移動します。

2. フィルター タグ フィールドを使用して、 以前に見つけた メジャー バージョンとフィックス パック番号を使用してイメージの一覧をフィルターします (たとえば、形式 7.2.10-dxp-5)。 このDockerイメージ名をコピーしてください。

   

   ヒント

   複数のDockerイメージが見つかった場合は、一致する最新のものをコピーしてください。 最新順のリストでは、最新のLiferay DXPイメージは、その名前にタイムスタンプが付加されていても、一番上にリストアップされます。

3. リポジトリで、liferay/gradle.propertiesファイルを開いてください。

4. liferay.workspace.docker.image.liferayの値を、前回コピーしたDockerイメージ名に設定します。

   例えば、Liferay DXPのイメージ名が7.2.10-dxp-5である場合、gradle.propertiesでこれを設定します。

   liferay.workspace.docker.image.liferay=liferay/dxp:7.2.10-dxp-5
   

これにより、Liferay Cloud 環境で正しいバージョンのLiferay DXPが動作するようになり、データを正常にアップロードできるようになります。

リポジトリ内のLiferay Serviceイメージを更新する

次に、リポジトリ内のLiferay ServiceのLCP.jsonファイルにあるLiferay Serviceのイメージを更新します。 このため、Liferayのインストールバージョンと互換性のある最新のDockerイメージを見つける必要があります。

1. Liferay Cloud の サービス変更ログ ページに移動します。

2. リストの一番上にある最新のサービス更新をクリックします。

   

3. ページにリストされている Liferay サービス イメージを探します。 オンプレミスのLiferayインストールのメジャーバージョンに一致するイメージ名をコピーしてください。

   

4. リポジトリで、liferay/LCP.jsonファイルを開いてください。

5. image項目の値を前回コピーしたDockerイメージ名に設定します。

   例えば、Liferayのサービスイメージ名がliferaycloud/liferay-dxp:7.2-4.0.4である場合、これを LCP.jsonに設定します。

   "image": "liferaycloud/liferay-dxp:7.2-4.0.4"
   

これにより、Liferayサービスは、Liferay DXPのバージョンと互換性のある最新のバージョンを使用するようになります。

ホットフィックスの情報を追加する

また、オンプレミス インストール にインストールされている パッチの修正プログラム情報を、CI サービスの LCP.json ファイルに追加する必要があります。

1. インストールされているパッチの一覧を確認するには、 ./patching-tool.sh info コマンドを $LIFERAY_HOME/patching-tool フォルダから再度実行してください。

   

   現在インストールされているホットフィックス（または「パッチ」）の名前をコピーしてください。 複数のホットフィックス名が表示された場合は、利用可能な最新のホットフィックス名をコピーします。

2. リポジトリで、ci/LCP.jsonファイルを開いてください。

3. 前にコピーした修正プログラム名を、新しい 環境変数 として追加し、名前は LCP_CI_LIFERAY_DXP_HOTFIXES_COMMONです。

   "env": {
      "LCP_CI_LIFERAY_DXP_HOTFIXES_COMMON": "dxp-5-7210"
   }
   

重要

LCP_CI_LIFERAY_DXP_HOTFIXES_COMMON で定義されたホットフィックスとその依存関係は、Jenkins ビルド プロセスの一部としてダウンロードされ、統合されます。

ビルドの作成とデプロイ

リポジトリのバージョン情報を更新したら、ビルドで環境にデプロイする必要があります。

変更した内容でJenkinsビルドを作成する

Gitコマンドを実行し、Gitがインストールされている端末で変更内容を送信します。

1. 変更したファイルをGitに追加します。

   git add .
   

2. 変更内容とメッセージをコミットします。

   git commit -m "Liferay Cloud Migration Stage 1"
   

3. 変更をGitHubにプッシュします。

   git push origin master
   

プロジェクトはGitHubのリポジトリにリンクされているため、変更をプッシュすると自動的にビルドが作成されます。 ビルドが完了するのを待ってから、次に進みます。

ビルドを選択した環境にデプロイする

最後に、 Liferay Cloud Console を使用して、完了したビルドを選択した環境にデプロイします。

1. Liferay Cloud Consoleでビルドページに移動します（ページ上部のリンクを使用します）。

2. リストの中から前回作成したビルドを探し、アクションメニューから［Deploy build to］をクリックします。

   

3. ビルドをデプロイする環境を選択します（例： acme-dev）。

4. 以下の情報を確認し、確認ボックスを選択して、デプロイ結果を確認します。

   

5. ビルドのデプロイをクリックします。

ビルドは選択した環境にデプロイされ、サービス起動時に正しいバージョンが適用されます。

注

デプロイメントが完了し、お客様のサービスが利用できるようになるまでには、ある程度の時間がかかります。 その環境に初めて導入する場合は、通常よりも時間がかかる場合があります。

今後の流れ

これで、選択した環境に、正しい Liferay DXP のバージョン情報をすべて含むデプロイができました。 次に、Liferay Cloud 用に準備するために、インスタンスのデータのバックアップ ファイル を作成します 。