ステージ1：DXPバージョンのマッチング

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

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

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

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

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

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

パッチツールには、Liferayサービスを設定するために必要な関連情報が表示されます。

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

Liferay Cloud は、プロジェクトと一緒に GitHub にリポジトリを提供します。各サービスの LCP.json ファイルなど、プロジェクト内のいくつかのファイルに対して設定を行うには、ローカルにリポジトリのクローンを用意する必要があります。

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

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

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

Docker Hub の Liferay DXP images ページにアクセスします。
フィルタタグ フィールドを使い、メジャーバージョンとフィックスパック番号を用いて画像のリストをフィルタリングします。以前に見つけた（例えば 7.2.10-dxp-5のような形式です）。このDockerイメージ名をコピーしてください。

tip

複数の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
```

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

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

Liferay Cloud の Services Changelog ページにアクセスします。
リストの一番上にある最新のサービス更新をクリックします。
ページに記載されている Liferay のサービス画像を探してください。オンプレミスの Liferay インストールの メジャーバージョン に一致するイメージ名をコピーしてください。
リポジトリで、 liferay/LCP.json ファイルを開いてください。
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 のバージョンと互換性のある最新のバージョンを使用するようになります。

また、オンプレミスでインストールしたパッチのhotfix情報をCIサービスの LCP.json ファイルに追加する必要があります。

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

現在インストールされているHotfix（または「パッチ」）の名前をコピーしてください。複数のHotfix名が表示された場合は、利用可能な最新のHotfixの名前をコピーします。
リポジトリで、 ci/LCP.json ファイルを開いてください。
先にコピーしたHotfix名をLCP_CI_LIFERAY_DXP_HOTFIXES_COMMONという新しい環境変数で追加します。
```
"env": {
    "LCP_CI_LIFERAY_DXP_HOTFIXES_COMMON": "dxp-5-7210"
}
```

important

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

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

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

変更したファイルをGitに追加します。
```
git add .
```
変更内容とメッセージを添えてコミットしてください。
```
git commit -m "Liferay Cloud Migration Stage 1"
```
変更をGitHubにプッシュします。
```
git push origin master
```

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