Documentation

ステージ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サービスを設定するために必要な関連情報が表示されます。

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

DXPクラウドリポジトリのクローン

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

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

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

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

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

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

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

    Filter Tagsフィールドを使用して、Liferay DXPイメージのリストをお探しのメジャーバージョンに絞り込みます。

    Tip

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

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

リポジトリ内のLiferayサービスイメージの更新

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

  1. Liferay Cloudの Services Changelog のページに移動します。

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

    最新のサービス更新のリンクをクリックし、環境が最新であることを確認します。

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

    表示された Liferay サービスイメージの中から、お使いの Liferay インストールのメジャーバージョンに合うものを選びます。

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

  5. 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 ファイルへ追加する必要があります。

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

    現在インストールされているパッチから最新のHotfixでLCP.jsonを更新する必要があります。

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

  3. 先にコピーした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コマンドを実行し、変更内容を送信します。

  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で、Buildsページに移動します(ページ上部のリンクを使用します)。

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

    ビルドのActionsメニューでデプロイします。

  3. ビルドをデプロイする環境を選択します(例: acme-dev)。

  4. 以下の情報を読み、確認ボックスを選択して、展開結果を確認します。

    チェックボックスにチェックを入れ、準備ができたらビルドをデプロイしてください。

  5. Deploy Build をクリックします。

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

注釈

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

次のステップ

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