1. コンテナデプロイメントでのData Exchange Frameworkのアップグレード

チュートリアル: Dockerでのデータ交換フレームワークのアップグレード

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

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

このトピックでは、Data Exchange Framework (DEF) Container 7.0をDEF 8.0にアップグレードする方法について説明します。DEF 8.0はSitecore 10.3と互換性があります。

メモ

DEFをアップグレードする前に、現在のDEF 7.0コンテナ ファイルをバックアップする必要があります。

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

  • Dockerイメージをビルドする

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

  • アップグレードを完了する

Sitecore ContainerのDockerイメージをDEFでビルドします。

DEFをアップグレードするには、新しいDockerイメージをビルドする必要があります。

新しいイメージをビルドするには:

  1. Sitecoreのダウンロード ページから10.3のSitecoreコンテナ デプロイメント パッケージをダウンロードします。フォルダ構造をそのままにして、ローカルワークステーションに抽出します。フォルダに名前を付けます (例: DEF 103.

  2. Sitecoreのダウンロード ページから8.0用のDEFコンテナ デプロイメント パッケージをダウンロードします。それをローカル ワークステーションのSitecore 10.3コンテナ パッケージを抽出したフォルダーに、フォルダー構造をそのままにして抽出します。たとえば、DEF 103フォルダーにコピーします。

  3. 現在のSitecore 10.2 Containerデプロイ フォルダーに移動し、mssql-dataフォルダーからデータベースをコピーして、Sitecore 10.3 mssql-dataフォルダーに貼り付けます。たとえば、C:/DEF103/mssql-dataにコピーします。

  4. 管理者として実行 オプションでPowerShellウィンドウを開き、Sitecore 10.3コンテナ ディレクトリに移動し、Sitecore 10.3コンテナをデプロイするには、次のコマンドを実行します。

    • docker-compose build

    • docker-compose up

  5. Sitecore Container 10.3が正常に動作していることを確認します。

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

DEFがインストールされているSitecoreソリューションをアップグレードするには、カスタムmssql-upgradeイメージを作成する必要があります。

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

  1. 「モジュールのリソース・ファイル」のダウンロード・ページで、「DEF Module Upgradeリソース」ファイルをダウンロードし、構造がそのままの状態でローカル・ワークステーションに解凍します。

  2. Dockerファイルを作成し、Dockerfileという名前を付けます。このファイルで、基本イメージを10.3 mssql-upgradeイメージを指すように指示を追加します。次に、ファイルの例を示します。

    ARG BASE_IMAGE=ideftdevacr.azurecr.io/sxp/sitecore-xp1-mssql-upgrade:10.3.0.006572.994-10.0.17763.2183-ltsc2019-unstable
FROM ${BASE_IMAGE}
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]
# Add DEF module
COPY <DEF Module Upgrade Resource file path> "C:\data\ResourceItems\10.3.0\modules\"
    手記

    Dockerファイルで、ARG BASE_IMAGE値がSitecore 10.3 mssql-upgradeイメージを指していることを確認します。

  3. 管理者権限を持つPowerShellウィンドウで、Dockerファイルと同じパスに移動し、次のコマンドを実行します。

    docker build . -t “<imageName>:<AnyAvailablePortNo>” command

    たとえば、docker build . -t "upgradedefimage:3636のようになります。

  4. イメージが作成されていることを確認します。

アップグレードを完了する

アップグレードを完了するには:

  1. ローカル マシンのPowerShellウィンドウで、DEFコンテナーのデプロイ フォルダーに移動します。使用しているWindowsバージョンとトポロジのアップグレード フォルダ ( Compose/<version>/upgrade/<topology>など) に移動します。

  2. Compose/<version>/upgrade/<topology> フォルダに移動し、compose-init.ps1スクリプトを実行します。このスクリプトは、SQLユーザー名、SQLパスワード、SQL Serverアドレス、Sitecoreライセンス ファイルなど、すべての環境変数の適切な値で環境設定ファイルを更新します。

    手記

    デプロイの準備のためのスクリプトの実行の詳細については、Sitecoreダウンロード ページの「Developer Workstation with ContainersのSitecoreインストール ガイド」を参照してください。

  3. compose-init.ps1スクリプトと同じディレクトリで、compose.upgrade.ymlファイルを開き、新しいイメージ値 (image:upgradedefimage:3636など) を開きます

  4. mssqlコンテナが稼働していることを確認します。

  5. アップグレードを完了するには、次のコマンドを実行します。

    docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env up

  6. アップグレードのステータスを確認するには、次のコマンドを実行します。

    Run “docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env ps

  7. アップグレード プロセスが完了したら、環境をクリーンアップできます。Docker Composeでアップグレード コンテナーを実行した場合は、アップグレードしたトポロジのDocker Composeフォルダーから、次のPowerShellコマンドレットを実行します。

    docker-compose.exe -f .\docker-compose.upgrade.yml --env-file .\upgrade.env down
この記事を改善するための提案がある場合は、 お知らせください!