コンテナー展開でのMicrosoft Dynamics 365 for SalesのSitecore Connectのアップグレード

チュートリアル: DockerでのDCRMのアップグレード

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、コンテナープラットフォームでSitecore Connect for Microsoft Dynamics 365 for Sales (DCRM) 6.0からDCRM 7.0にアップグレードする方法について説明します。

メモ

SXPインストールを10.2にアップグレードし、DCRMインストールを7.0に同時にアップグレードする必要があります。

DCRMコンテナをバージョン7.0にアップグレードする前に、次のものが必要です。

Sitecore Experience Platform (SXP) 10.1をDockerにデプロイ
DockerにデプロイされたDCRM 6.0
現在のDCRM 6.0コンテナファイルの最新のバックアップ

このチュートリアルでは、次の方法について説明します。

SXP 10.2およびDCRM 7.0用の新しいDockerイメージをビルドします。
mssql-upgradeイメージをビルドする
アップグレードを実行する

新しいDockerイメージを構築する

SXP 10.2およびDCRM 7.0 Dockerイメージをビルドするには、次の手順を実行します。

SXPコンテナデプロイメント10.2パッケージをSitecoreのダウンロードページからダウンロードします。フォルダ構造をそのままにして、ローカルワークステーション上の新しいフォルダに抽出します。新しいフォルダにDCRM7などの名前を付けます。
SitecoreのダウンロードページからDCRMコンテナデプロイメント7.0パッケージをダウンロードします。フォルダ構造をそのままにして、ローカルワークステーションに抽出します。dcrm\compose\<windows version>\<topology> フォルダ内のファイルをコピーし、SXP 10.2デプロイメント構造の \compose\<windows version>\<topology> フォルダに貼り付けます。
Sitecore 10.1コンテナデプロイメントフォルダーに移動します。 mssql-dataフォルダーからデータベースをコピーし、Sitecore 10.2コンテナーデプロイmssql-dataフォルダーに貼り付けます。
Sitecore 10.2をデプロイするには、管理者権限でPowerShellウィンドウを開き、SC 10.2 Containerデプロイフォルダーに移動して、次のコマンドを実行します。
docker-compose build docker-compose up
Sitecore Container 10.2が正常に稼働していることを確認します。

mssql-upgradeイメージをビルドします

カスタムmssql-upgradeイメージを使用して、DCRMがインストールされているSitecoreソリューションをアップグレードします。カスタムmssql-upgradeイメージをビルドするには、コンテナーレジストリから最新のSitecore XP mssql-upgradeイメージをダウンロードし、その上にカスタムDockerfileを作成する必要があります。

mssql-upgradeイメージをビルドするには:

Sitecoreダウンロードページの Resource files for Modules 1.0.0セクションから、Dynamics CRM Connect Upgrade resources 1.0.0パッケージをダウンロードします。ローカルマシン上のフォルダーに抽出します。
アップグレードリソースからDynamics CRM Connect Upgrade resources 1.0.0\6.0.0\Dataフォルダをコピーし、使用しているWindowsバージョンとトポロジのアップグレードフォルダ ( ltsc2019\upgrade\xp1など) に貼り付けます。

DCRM Connect Upgrade resources 1.0.0\6.0.0フォルダにDockerファイルを作成し、Dockerfileという名前を付けます。このファイルで、基本イメージを10.2 mssql-upgradeイメージを指すように指示を追加します。たとえば、ファイルは次のようになります。

ARG BASE_IMAGE= ${SITECORE_DOCKER_REGISTRY} /sxp/sitecore-xp1-mssql-upgrade : tag
FROM ${BASE_IMAGE}
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
# Add ? DCRM?  module
COPY <Data folder local path> "C:\data\ResourceItems\10.1\modules"

手記

Dockerfileで、ARG BASE_IMAGEパラメーターがmssql-upgradeイメージを指していること、およびDataフォルダーのローカルパスが手順1で作成したフォルダーの6.0.0\Dataフォルダーに設定されていることを確認します。

mssql-upgradeイメージをビルドするには、PowerShellウィンドウを開き、Dockerfileを配置したフォルダーに移動して、次のコマンドを実行します。
docker build . -t "<imageName>:<available port number>”
指定した名前でDockerがイメージを作成したことを確認します。

アップグレードの実行

アップグレードを実行するには:

ローカルマシンのPowerShellウィンドウで、Sitecore Container Deployment 10.2フォルダーに移動します。使用しているWindowsバージョンとトポロジのアップグレードフォルダ ( ltsc2019\upgrade\xp1など) に移動します。
トポロジフォルダーで、compose-init.ps1 script.このスクリプトは、SQLユーザー名、SQLパスワード、SQL Serverアドレス、Sitecoreライセンスファイルなど、すべての環境変数の適切な値で環境設定ファイルを更新します。

手記

デプロイの準備のためのスクリプトの実行の詳細については、Sitecoreのダウンロードページにある「Developer Workstation with Containersのインストールガイド」を参照してください。
アップグレードフォルダーで、upgrade.envファイルの詳細が正しいことを確認します。詳細については、『 Upgrade Container Deployment Guide for SXP 10.2.0』を参照してください。
docker-compose.upgrade.ymlファイルで、前に作成したmssql-upgradeイメージでimage設定を更新します。
管理者権限で新しいPowerShellウィンドウを開きます。アップグレードディレクトリに移動します。
mssqlコンテナが稼働していることを確認します。
アップグレードを開始するには、次のコマンドを実行します。
docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env up
アップグレードのステータスを確認するには、次のコマンドを実行します。
docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env ps
アップグレードプロセスが完了したら、環境をクリーンアップできます。

アップグレードコンテナをDocker Composeで実行した場合は、アップグレードしたトポロジのDocker Composeフォルダ ( sitecore-xp1など) から、次のPowerShellコマンドレットを実行します。
docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env down

この記事を改善するための提案がある場合は、お知らせください!