チュートリアル: SCCH コネクタ モジュールをコンテナー環境にインストールするための準備

Current version: 5.0
日本語翻訳に関する免責事項

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

Docker または Azure Kubernetes Service にデプロイするかどうかにかかわらず、Sitecore Connect for Content Hub コネクタをインストールに追加する準備をするには、このチュートリアルのステップに従ってください。

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

  • インストール ファイルの準備

  • Docker イメージの構築

インストール ファイルの準備

インストールに必要なファイルを準備するには、次の手順に従います。

  1. Sitecore のダウンロード ページから SCCH コンテナー デプロイ パッケージをダウンロードし、フォルダー構造を維持したままローカルのワークステーションに展開します。

  2. Sitecore のダウンロード ページ から、Sitecore Experience Platform コンテナー デプロイ パッケージをダウンロードし、フォルダー構造を維持したままローカルのワークステーションの新しいフォルダーに展開します。新しいフォルダーには、SCCH などの名前を付けます。

  3. ステップ 1 で SCCH パッケージを抽出したフォルダー内で、使用している Windows のバージョンとトポロジに対応したフォルダー (例: SCCH\compose\ltsc2019\xp1) に移動します。ステップ 2 で作成した SCCH\compose\<version>\<topology> フォルダーに、docker-compose.override.yml ファイルをコピーします。

  4. SCCH フォルダーで、使用している Windows のバージョンとトポロジに対応したフォルダー (例: compose\ltsc2019\xp1) に移動します。テキスト エディターで、.env ファイルを開きます。ファイルの末尾に、SCCH イメージの定義を追加します。次に例を示します。

    RequestResponse
    SCCH_IMAGE= scr.sitecore.com/sxp/modules/sitecore-chub-assets:5.0.0-<target-OS-to-deploy>

  5. SCCH パッケージを展開したフォルダーで、.env-example ファイルをテキスト エディターで開き、すべての内容をコピーします。

  6. ステップ 4 の .env ファイルの最後にある SCCH イメージ データの後に、.env-example ファイルの内容を貼り付けます。.env ファイルを保存します。

Docker イメージの構築

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

注記

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

イメージを作成するには:

  1. SCCH フォルダーで、使用している Windows のバージョンとトポロジに対応したフォルダー (例: compose\ltsc2019\xp1) に移動します。サブフォルダーを作成し、module という名前を付けます。

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

    • cm

    • cd

      注記

      cd サブフォルダーの作成は、XP1 または XM1 トポロジにデプロイする場合のみ必要です。

    • mssql

      注記

      mssql サブフォルダーの作成は、Docker 上で Sitecore 10.1.3 にデプロイする場合のみ必要です。

    • mssql-init

      注記

      mssql-init サブフォルダーの作成は、Kubernetes 上で Sitecore 10.1.3 にデプロイする場合のみ必要です。

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

  4. cm フォルダーの Dockerfile ファイルで、以下の命令を入力します。

    RequestResponse
    # escape=`
ARG BASE_IMAGE
ARG SCCH_IMAGE
ARG TOOL_IMAGE

FROM ${SCCH_IMAGE} as scch
FROM ${TOOL_IMAGE} as tooling
FROM ${BASE_IMAGE}

SHELL [“powershell”, “-Command”, “$ErrorActionPreference = ‘Stop’; $ProgressPreference = ‘SilentlyContinue’;”]
 	
WORKDIR C:\inetpub\wwwroot

# Add SCCH module
COPY –from=scch \module\cm\content .\

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

# Apply SCCH transformation files
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\inetpub\wwwroot -XdtPath \inetpub\wwwroot\App_Data\Transforms\scch\xdts

  5. XP1 または XM1 トポロジをデプロイする場合は、cd フォルダーの Dockerfile ファイルに次の命令を入力します。

    RequestResponse
    # escape=`
ARG BASE_IMAGE
ARG SCCH_IMAGE
ARG TOOL_IMAGE

FROM ${SCCH_IMAGE} as scch
FROM ${TOOL_IMAGE} as tooling
FROM ${BASE_IMAGE}

SHELL [“powershell”, “-Command”, “$ErrorActionPreference = ‘Stop’; $ProgressPreference = ‘SilentlyContinue’;”]

WORKDIR C:\inetpub\wwwroot

# Add SCCH module
COPY –from=scch \module\cm\content .\

# Copy SCCH transformation files
COPY –from=scch \module\transforms\ C:\transforms\

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

# Apply SCCH transformation files
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\inetpub\wwwroot -XdtPath \inetpub\wwwroot\App_Data\Transforms\scch\xdts 
RUN C:\tools\scripts\Invoke-XdtTransform.ps1 -Path C:\inetpub\wwwroot -XdtPath \transforms\cd

  6. Docker で Sitecore 10.1.3 にデプロイする場合は、mssql フォルダーの Dockerfile ファイルに次の命令を入力します。

    RequestResponse
    # escape=`
ARG BASE_IMAGE
ARG SCCH_IMAGE

FROM ${SCCH_IMAGE} as scch
FROM ${BASE_IMAGE}

SHELL [“powershell”, “-Command”, “$ErrorActionPreference = ‘Stop’; $ProgressPreference = ‘SilentlyContinue’;”]

# Copy SCCH dacpac files
COPY –from=scch C:\module\db C:\resources\scch_data

# Copy SCCH tool files
COPY –from=scch C:\module\tools\ C:\scch\

#  Deploy SCCH dacpac files
RUN C:\scch\Set-DbContainmentLevel.ps1 -moduleDacpacSource C:\resources\scch_data -isContainer $true; `
Remove-Item -Path C:\scch -Recurse -Force; `
C:\DeployDatabases.ps1 -ResourcesDirectory C:\resources\scch_data; `
Remove-Item -Path C:\resources\scch_data -Recurse -Force;

  7. Kubernetes で Sitecore 10.1.3 にデプロイする場合は、mssql-init フォルダーの Dockerfile ファイルに次の命令を入力します。

    RequestResponse
    # escape=`
ARG BASE_IMAGE
ARG SCCH_IMAGE

FROM ${SCCH_IMAGE} as scch
FROM ${BASE_IMAGE}

SHELL [“powershell”, “-Command”, “$ErrorActionPreference = ‘Stop’; $ProgressPreference = ‘SilentlyContinue’;”]

# Copy SCCH dacpac files
COPY –from=scch C:\module\db C:\resources\scch_data

# Copy SCCH tool files
COPY –from=scch C:\module\tools\ C:\scch\

#  Prepare SCCH dacpac files
RUN C:\scch\Set-DbContainmentLevel.ps1 -moduleDacpacSource C:\resources\scch_data -isContainer $true; `
Remove-Item -Path C:\scch -Recurse -Force;# 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. SCCH\compose\<version>\<topology> フォルダーに移動します。編集用の docker-compose.override.yml ファイルを開き、cm イメージに次の指示を追加します。

    RequestResponse
    cm:
    image: sitecore-chub-${TOPOLOGY}-cm:${SITECORE_VERSION}
    build:
      context: ./module/cm
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-cm:${SITECORE_VERSION}
        SCCH_IMAGE: ${SCCH_IMAGE}
        TOOL_IMAGE: ${TOOL_IMAGE}

  9. XP1 または XM1 トポロジにデプロイする場合は、cd イメージの作成命令を追加します。

    RequestResponse
     	cd:
    image: sitecore-chub-${TOPOLOGY}-cd:${SITECORE_VERSION}
    build:
      context: ./module/cd
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-cd:${SITECORE_VERSION}
        SCCH_IMAGE: ${SCCH_IMAGE}
        TOOL_IMAGE: ${TOOL_IMAGE}

  10. Docker で Sitecore 10.1.3 にデプロイする場合は、mssql イメージの作成命令を追加します。

    RequestResponse
     mssql:
    image: sitecore-chub-${TOPOLOGY}-mssql:${SITECORE_VERSION}
    build:
      context: ./module/mssql
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-mssql:${SITECORE_VERSION}
        SCCH_IMAGE: ${SCCH_IMAGE}

  11. Kubernetes で Sitecore 10.1.3 にデプロイする場合は、mssql-init イメージの作成命令を追加します。

    RequestResponse
    mssql-init:
    image: sitecore-chub-${TOPOLOGY}-mssql-init:${SITECORE_VERSION}
    build:
      context: ./module/mssql-init
      args:
        BASE_IMAGE: ${SITECORE_DOCKER_REGISTRY}sitecore-${TOPOLOGY}-mssql-init:${SITECORE_VERSION}
        SCCH_IMAGE: ${SCCH_IMAGE}

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

    RequestResponse
    docker-compose build

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

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

注記

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

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、