ステージ1：DXPバージョンのマッチング¶
移行の第一段階として、DXP Cloud上で動作するLiferayサービスが、移行したいインストールと同じバージョンで動作するように設定します。
そのため、DXP Cloudのリポジトリをクローンし、バージョン変更の設定を行い、ビルドを展開することでDXP Cloudにその更新を戻す必要があります。
Liferayのバージョン情報を検索する¶
まず、移行したい Liferay DXP インストールのバージョン番号とインストールされているパッチを探します。 DXP Cloud で Liferay サービスを適切に設定するために、これらの値が必要です。
これらの値を求めるには、パッチングツールを使用します。
こちらの の指示に従い、 パッチツールを移行したいインストール先にインストールします。
任意のコマンドラインツールでパッチングツールフォルダーに移動します。
cd $LIFERAY_HOME/patching-tool
パッチツールを使用して、インストールのバージョン情報を取得します。
./patching-tool.sh info
パッチツールは、ビルドバージョン、インストールされているフィックスパックやホットフィックスなど、パッチとバージョン情報を表示します。
今後のステップのために、この情報をメモしておいてください。
DXPクラウドリポジトリのクローン¶
DXPクラウドでは、プロジェクトと一緒に GitHub にリポジトリを提供しています。 各サービスの LCP.json ファイル など、プロジェクト内のいくつかのファイルに設定を行うには、リポジトリのクローンをローカルに用意する必要があります。
まだリポジトリをクローンしていない場合は、 Git がインストールされているターミナルで ローカルにリポジトリをクローンしてください。
git clone https://github.com/dxpcloud/acme
リポジトリ内の Liferay DXP イメージを更新する¶
次に、以前 クローンした リポジトリ内のLiferay DXPイメージを更新します。 このため、Liferayインストールのバージョン情報と互換性のあるDockerイメージを見つける必要があります。
Docker Hub の Liferay DXP images ページに移動します。
フィルタータグ フィールドを使用して、以前に見つけたメジャーバージョンとフィックスパック番号 を使用してイメージのリストをフィルター処理し （たとえば、フォーム
7.2.10-dxp-5）。 このDockerイメージ名をコピーしてください。
ちなみに
複数のDockerイメージが見つかった場合は、最新の一致するものをコピーしてください。 最新順のリストでは、最新の Liferay DXP イメージは、その名前にタイムスタンプが付加されていても、一番上にリストアップされます。
リポジトリで、
liferay/gradle.propertiesファイルを開いてください。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
これにより、DXPクラウド環境で正しいバージョンのLiferay DXPが動作し、データを正常にアップロードできるようになります。
リポジトリ内のLiferayサービスイメージの更新¶
次に、リポジトリ内のLiferayサービスの LCP.json ファイルにあるLiferayサービスのイメージを更新します。 このため、Liferayのインストールバージョンと互換性のある最新のDockerイメージを見つける必要があります。
DXP Cloudの Services Changelog のページに移動します。
リストの一番上にある最新のサービス更新をクリックします。
ページに記載されている Liferay サービス画像を探します。 オンプレミスのLiferayインストールの メジャーバージョン に一致するイメージ名をコピーしてください。
リポジトリで、
liferay/LCP.jsonファイルを開いてください。imageフィールドの値を、以前コピーしたDockerイメージ名に設定します。たとえば、Liferayサービスイメージ名が
liferaycloud/liferay-dxp：7.2-4.0.4の場合、これをに設定します。
"image": "liferaycloud/liferay-dxp:7.2-4.0.4"
これにより、あなたのLiferayサービスは、あなたのLiferay DXPのバージョンと互換性のある最新のバージョンを使用することが保証されます。
Hotfixの情報を追加する¶
また、オンプレミスでインストールした パッチのホットフィックス情報 をCIサービスの LCP.json ファイルへ追加する必要があります。
ンストールされているパッチのリストを確認するには、
$LIFERAY_HOME/patching-toolフォルダーから./patching-tool.sh infoコマンドを再度実行します。
レポジトリで、
ci/LCP.jsonファイルを開いてください。先にコピーしたHotfix名を新しい 環境変数として追加します 名前
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コマンドを実行し、変更内容を送信します。
変更したファイルをGitに追加します。
git add .
変更内容とメッセージを添えてコミットしてください。
git commit -m "DXP Cloud Migration Stage 1"変更をGitHubにプッシュします。
git push origin master
プロジェクトはGitHubのリポジトリにリンクされているため、変更をプッシュすると自動的にビルドが作成されます。 ビルドが完了するのを待ってから、次に進みます。
ビルドを選択した環境にデプロイする¶
最後に、 DXP Cloud Console を使用して、完成したビルドを選択した環境にデプロイします。
DXP Cloud Consoleで、Buildsページに移動します（ページ上部のリンクを使用します）。
リストの中から前回作成したビルドを探し、[アクション]メニューから Deploy build to をクリックします。
ビルドをデプロイする環境を選択します（例：
acme-dev）。以下の情報を読み、確認ボックスを選択して、展開結果を確認します。
Deploy Build をクリックします。
ビルドは選択した環境にデプロイされ、サービス起動時に正しいバージョンが適用されます。
注釈
デプロイメントが完了し、お客様のサービスが利用できるようになるまでには、ある程度の時間がかかります。 その環境に初めて導入する場合は、通常よりも時間がかかる場合があります。
次のステップ¶
これで、選択した環境に、正しい Liferay DXP のバージョン情報をすべて含むデプロイができました。 次に、 インスタンスのデータのバックアップファイル を作成し、DXP Cloud に対応させる準備をします。