1. コンテナへのData Exchange Frameworkのインストール

チュートリアル: コンテナ環境にData Exchange Frameworkをインストールするための準備

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

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

Sitecore Data Exchange Framework (DEF) モジュールをインストールに追加する準備をするには、DockerにデプロイするかAzure Kubernetesサービスにデプロイするかに関係なく、このチュートリアルの手順に従います。このチュートリアルでは、次の方法について説明します。

  • インストール ファイルを準備する

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

インストール ファイルを準備する

インストールに必要なファイルを準備するには、次のようにします。

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

  2. DEFコンテナデプロイメントパッケージを抽出したフォルダで、使用しているWindowsバージョンとトポロジのフォルダ ( def\compose\ltsc2019\xp1など) を開きます。

  3. エディタで .env-exampleファイルを開きます。次に、ファイルの内容の例を示します。

    TOPOLOGY=xp1
#Note: Copy this below if you are using the Tenant Service in DEF
TENANT_SERVICE_HOST=xp1ts.localhost

  4. ファイル内のすべての必要な変数をクリップボードにコピーします。

  5. ローカル マシンのSitecoreコンテナー デプロイ フォルダーに移動します。使用しているWindowsのバージョンとトポロジのフォルダー ( compose\ltsc2019\xp1など) に移動します。

  6. エディタで .envファイルを開き、DEF .env-exampleファイルから変数を貼り付けます。

  7. 次の変数を .envファイルに追加します。

    DEF_IMAGE=scr.sitecore.com/sxp/modules/sitecore-def-xp1-assets:8.0.0-1809
TOOLING_IMAGE=scr.sitecore.com/tools/sitecore-docker-tools-assets:10.3.0-1809

  8. .envファイルを保存します。

  9. DEF compose\<version>\<topology> フォルダーからdocker-compose.override.ymlファイルをコピーし、Sitecoreコンテナーのデプロイcompose\<version>\<topology> フォルダー ( docker.compose.ymlファイルがある場所) に貼り付けます。

  10. DEFでテナントサービスを使用していない場合は、docker-compose.override.ymlファイルを開き、xdbautomationworkerイメージとidイメージのセクションを削除します。

Dockerイメージをビルドする

インストール・ファイルを準備したら、ロールごとにDockerファイルを作成し、Dockerイメージをビルドする必要があります。

メモ

画像アセットの詳細については、Sitecoreモジュールの追加方法に関するドキュメントを参照してください。

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

  1. ローカル マシンのSitecoreコンテナー デプロイ フォルダーに移動します。使用しているWindowsのバージョンとトポロジのフォルダー ( compose/ltsc2019/xp1など) に移動します。サブフォルダを作成し、moduleという名前を付けます。

  2. moduleフォルダに、次のサブフォルダを作成します。

    • cm

    • id

    • xdbautomationworker

    手記

    xdbautomationworkerモジュールとidモジュールは、テナントサービスを使用している場合にのみ必要です。テナント サービスを使用していない場合は、これら2つのモジュールのフォルダとファイルを作成する必要はありません。

  3. 各サブフォルダに新しいファイルを作成し、Dockerfileという名前を付けます。

  4. cmフォルダのDockerfileファイルに、次の手順を入力します。

    # escape=`

ARG BASE_IMAGE
ARG DEF_IMAGE
ARG TOOLING_IMAGE

FROM ${DEF_IMAGE} as def
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE}

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

WORKDIR C:\inetpub\wwwroot

# Add DEF module
COPY --from=def \module\cm\content\
COPY --from=def \module\transforms\ C:\transforms\

COPY --from=tooling \tools\ \tools\
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\inetpub\wwwroot -XdtPath \transforms\cm

  5. テナント サービスを使用している場合は、idフォルダのDockerfileファイルに次の手順を入力します。

    # escape=`

ARG BASE_IMAGE
ARG DEF_IMAGE
ARG TOOLING_IMAGE

FROM ${DEF_IMAGE} as def
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE}

SHELL ["pwsh", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

WORKDIR C:\Identity

# Add DEF module
COPY --from=def \module\transforms\ C:\transforms\

COPY --from=tooling \tools\ \tools\
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\Identity -XdtPath c:\transforms\id

  6. テナント サービスを使用している場合は、xdbautomationworkerフォルダのDockerfileファイルに次の手順を入力します。

    # escape=`

ARG BASE_IMAGE
ARG DEF_IMAGE
ARG TOOLING_IMAGE

FROM ${DEF_IMAGE} as def
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE}

SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

# Add DEF MA module
COPY --from=def \module\xdbautomationworker\content C:\service\
COPY --from=def \module\transforms\C:\transforms\
COPY --from=tooling \tools\\tools\
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\service -XdtPath \transforms\xdbautomationworker

  7. compose\<version>\<topology>\docker-compose.override.ymlファイルに、各ロールのビルド手順を追加します。

    すべてのトポロジで、cmロールの指示を追加する必要があります。たとえば、次のようになります。

    services:
   cm:
     image: sitecore-def-${TOPOLOGY}-cm:${SITECORE_VERSION}
     build:
       context: ./module/cm
       args:
         BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-cm:${SITECORE_VERSION}
         DEF_IMAGE: ${DEF_IMAGE}
         TOOLING_IMAGE: ${TOOLING_IMAGE}

    XP1トポロジをデプロイする場合は、次のようにcdロールの指示を追加します。

    cd:
  image: sitecore-def-${TOPOLOGY}-cd:${SITECORE_VERSION}
  build:
     context: ./module/cm
     args:
       BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-cd:${SITECORE_VERSION}
       DEF_IMAGE: ${DEF_IMAGE}
       TOOLING_IMAGE: ${TOOLING_IMAGE}

    XP0またはXP1トポロジをデプロイする場合は、次のように、idロールとxdbautomationworkerロールの指示を追加します。

    id:
  image: sitecore-def-${TOPOLOGY}-id:${SITECORE_VERSION}
  build:
     context: ./module/id
     args:
       BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-id:${SITECORE_VERSION}
       DEF_IMAGE: ${DEF_IMAGE}
       TOOLING_IMAGE: ${TOOLING_IMAGE}
xdbautomationworker:
  image: sitecore-def-${TOPOLOGY}-xdbautomationworker:${SITECORE_VERSION}
  build:
      context: ./module/xdbautomationworker
     args:
       BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-xdbautomationworker:${SITECORE_VERSION}
       DEF_IMAGE: ${DEF_IMAGE}
       TOOLING_IMAGE: ${TOOLING_IMAGE}

  8. Windowsコンソールで、docker-compose.override.ymlファイルが含まれているフォルダーに移動します。次のコマンドを実行します。

    docker-compose build

  9. Dockerにデプロイする場合は、DockerへのData Exchange Frameworkのインストールの手順に進みます。

    Kubernetesにデプロイする場合は、「 チュートリアル: Azure Kubernetes ServiceへのData Exchange Frameworkのインストール」の手順に進みます。

手記

接続文字列の追加やWeb設定ファイルの変更など、Sitecoreデプロイメントに対する一部の変更では、設定ファイルを変更するために設定変換を使用する必要があります。設定変換の適用方法については、Sitecoreの コンテナ開発ドキュメントコンテナ開発ドキュメント.

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