1. Microsoft Dynamics 365 for SalesのSitecore Connectをコンテナーにインストールする

チュートリアル: コンテナ環境にDCRMコネクタをインストールする準備

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

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

Microsoft Dynamics 365 for Sales (DCRM) のSitecore Connectをコンテナー インストールに追加する準備をするには、Docker ServiceにデプロイするかAzure Kubernetes Serviceにデプロイするかに関係なく、このチュートリアルの手順に従います。

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

  • インストール ファイルを準備します。

  • Dockerイメージをビルドします。

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

インストールに必要なファイルを準備するには:

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

  2. DCRMコンテナ デプロイ パッケージを抽出したフォルダーに移動します。使用しているWindowsのバージョンとトポロジのフォルダー ( dcrm\compose\ltsc2019\xp1など) に移動します。

  3. エディタで .env-exampleファイルを開きます。すべての変数をクリップボードにコピーします。

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

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

  6. 次の変数のパラメーターを入力します。

    • ConnectionString_DCRM

    • ConnectionString_StagingDB

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

    DEF_IMAGE=scr.sitecore.com/sxp/modules/sitecore-def-xp1-assets:7.0.0-1497
DCRMCNN_IMAGE=scr.sitecore.com/sxp/modules/sitecore-dcrm-xp1-assets:7.0.0-1497
TOOLING_IMAGE=scr.sitecore.com/tools/sitecore-docker-tools-assets:10.2.0-1809

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

  9. DCRM compose\<version>\<topology> フォルダから、docker-compose.override.ymlファイルをSXPコンテナデプロイメントcompose\<version>\<topology> フォルダ ( docker-compose.ymlファイルがある場所) にコピーします。

Dockerイメージをビルドする

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

メモ

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

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

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

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

    • cm

    • xconnect

    • xdbsearchworker

    • mssql-init

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

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

    # escape=`
ARG BASE_IMAGE
ARG DCRMCNN_IMAGE
ARG DEF_IMAGE
ARG TOOLING_IMAGE

FROM ${DEF_IMAGE} as def
FROM ${DCRMCNN_IMAGE} as dcrm
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE} as baseImage

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

WORKDIR C:\inetpub\wwwroot

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

# Add DCRM module
COPY --from=dcrm  \module\cm\content

#Copy transformation files
COPY --from=dcrm  \module\xdttransform\cm\transforms\ C:\transforms\

#Add tools from sitecore-docker-tools-assets
COPY --from=tooling \tools\ C:\tools\

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

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

    # escape=`
ARG BASE_IMAGE
ARG DCRMCNN_IMAGE
ARG TOOLING_IMAGE

FROM ${DCRMCNN_IMAGE} as dcrm
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE} as baseImage

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

#Add tools from sitecore-docker-tools-assets
COPY --from=tooling \tools\ C:\tools\

# Copy models file into index worker
COPY --from=dcrm  \module\models C:\inetpub\wwwroot\App_Data\Models\

#Copy transformation files
COPY --from=dcrm  \module\transforms\ C:\transforms\

# Update value for IndexPIISensitive and IndexAnonymousContactData in IndexerSetting
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\inetpub\wwwroot -XdtPath C:\transforms\xconnect

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

    # escape=`
ARG BASE_IMAGE
ARG DCRMCNN_IMAGE
ARG TOOLING_IMAGE

FROM ${DCRMCNN_IMAGE} as dcrm
FROM ${TOOLING_IMAGE} as tooling
FROM ${BASE_IMAGE} as baseImage

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

#Add tools from sitecore-docker-tools-assets
COPY --from=tooling \tools\ C:\tools\

#Copy transformation files
COPY --from=dcrm  \module\transforms\ C:\transforms\

# Update value for IndexPIISensitive and IndexAnonymousContactData in IndexerSetting
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\service -XdtPath C:\transforms\xdbsearchworker

  7. mssql-initフォルダのDockerfileファイルに、次の手順を入力します。

    # escape=`
ARG BASE_IMAGE
ARG DCRMCNN_IMAGE

FROM ${DCRMCNN _IMAGE} as dcrm
FROM ${BASE_IMAGE}

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

# Deploy DCRM Staging database file
COPY --from=dcrm  C:\module\db C:\resources\dcrm

  8. compose\<version>\<topology>\docker-compose.override.ymlファイルに、各ロールのビルド手順を追加します。すべてのトポロジについて、次の手順から開始します。

    version: "2.4"
services:
  cm:
    image: sitecore-dcrm-xp1-cm:${SITECORE_VERSION}
    build:
      context: ./module/cm
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp1-cm:${SITECORE_VERSION}
        DEF_IMAGE: ${DEF_IMAGE}
        DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
        TOOLING_IMAGE: ${TOOLING_IMAGE}
  mssql:
    image: sitecore-dcrm-xp1-mssql:${SITECORE_VERSION}
    build:
      context: ./module/mssql
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp1-mssql:${SITECORE_VERSION}
        DEF_IMAGE: ${DEF_IMAGE}        
        DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
  xdbsearchworker:
    image: sitecore-dcrm-xp1-xdbsearchworker:${SITECORE_VERSION}
    build:
      context: ./module/xdbsearchworker
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp1-xdbsearchworker:${SITECORE_VERSION}
        DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
        TOOLING_IMAGE: ${TOOLING_IMAGE}

    XP0をデプロイする場合は、次の手順を追加しますxconnect

      xconnect:
  image: sitecore-dcrm-xp0-xconnect:${SITECORE_VERSION}
  build:
    context: ./module/xconnect/
    args:
      BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp0-xconnect:${SITECORE_VERSION}
      DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
      TOOLING_IMAGE: ${SITECORE_TOOLS_REGISTRY}sitecore-docker-tools-assets:${TOOLS_VERSION}

    XP1をデプロイする場合は、xdbsearchとxdbcollectionの手順を追加します。

      xdbsearch:
    image: sitecore-dcrm-xp1-xdbsearch:${SITECORE_VERSION}
    build:
      context: ./module/xconnect
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp1-xdbsearch:${SITECORE_VERSION}
        DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
        TOOLING_IMAGE: ${TOOLING_IMAGE}
  xdbcollection:
    image: sitecore-dcrm-xp1-xdbcollection:${SITECORE_VERSION}
    build:
      context: ./module/xconnect
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-xp1-xdbcollection:${SITECORE_VERSION}
        DCRMCNN_IMAGE: ${DCRMCNN_IMAGE}
        TOOLING_IMAGE: ${TOOLING_IMAGE}

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

  10. Dockerにデプロイする場合は、DockerでSitecoreにDCRMコネクタ モジュールを追加するの手順に進みます。

    Kubernetesにデプロイする場合は、「 チュートリアル: Azure Kubernetes ServiceのSitecoreへのDCRMコネクタ モジュールの追加」の手順に進みます。

手記

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

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