チュートリアル: コンテナ環境でのSCCHコネクタモジュールのインストールの準備

Version:

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

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

Dockerサービスにデプロイするか、Azure Kubernetesサービスにデプロイするかに関係なく、Sitecore Connect for Cisco Content Hub (SCCH) コネクタをインストールに追加する準備をするには、このチュートリアルの手順に従います。

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

インストールファイルを準備する
Dockerイメージをビルドする

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

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

SitecoreのダウンロードページからSCCHコンテナデプロイメントパッケージをダウンロードします。フォルダ構造をそのままにして、ローカルワークステーションに抽出します。
Sitecore Experience PlatformコンテナデプロイメントパッケージをSitecoreのダウンロードページからダウンロードします。フォルダ構造をそのままにして、ローカルワークステーション上の新しいフォルダに抽出します。新しいフォルダにSCCHなどの名前を付けます。
ステップ1でSCCHパッケージを抽出したフォルダで、使用しているWindowsバージョンとトポロジのフォルダ (SCCH\compose\ltsc2019\xp1など) に移動します。docker-compose.override.ymlファイルをステップ2で作成したSCCH\compose\<version>\<topology> フォルダーにコピーします。
SCCHフォルダで、使用しているWindowsバージョンとトポロジのフォルダ (compose\ltsc2019\xp1など) に移動します。テキストエディタで.envファイルを開きます。ファイルの下部に、SCCHイメージの定義を追加します。例えば：
SCCH_IMAGE= scr.sitecore.com/sxp/modules/sitecore-chub-assets:5.2.0-<target-OS-to-deploy>
SCCHパッケージを抽出したフォルダーで、テキストエディターで .env-exampleファイルを開き、すべての内容をコピーします。
手順4の.envファイルの下部、SCCH画像データの後に、.env-exampleファイルの内容を貼り付けます。.envファイルを保存します。

Dockerイメージをビルドする

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

メモ

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

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

SCCHフォルダで、使用しているWindowsバージョンとトポロジのフォルダ (compose\ltsc2019\xp1など) に移動します。サブフォルダを作成し、moduleという名前を付けます。
moduleフォルダーに、次のサブフォルダーを作成します。
- cm
- cd
  
  手記
  
  cdサブフォルダを作成する必要があるのは、XP1またはXM1トポロジにデプロイする場合のみです。
- mssql
  
  手記
  
  mssqlサブフォルダを作成する必要があるのは、DockerでSitecore 10.1.3にデプロイする場合のみです。
- mssql-init
  
  手記
  
  mssql-initサブフォルダを作成する必要があるのは、KubernetesでSitecore 10.1.3にデプロイする場合のみです。
各サブフォルダに新しいファイルを作成し、Dockerfileという名前を付けます。

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

# 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

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

# 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

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

# 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;

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

# 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

SCCH\compose\<version>\<topology>フォルダに移動します。編集用にdocker-compose.override.ymlファイルを開き、cmイメージに次の手順を追加します。

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}

XP1またはXM1トポロジにデプロイする場合は、cdイメージに次の手順を追加します。

 	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}

DockerでSitecore 10.1.3にデプロイする場合は、mssqlイメージに次の手順を追加します。

 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}

KubernetesでSitecore 10.1.3にデプロイする場合は、mssql-initイメージに次の手順を追加します。

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}

Windowsコンソールで、docker-compose.override.ymlファイルがあるSCCH\compose\<version>\<topology> フォルダーに移動します。次のコマンドを実行します。
docker-compose build
Dockerにデプロイする場合は、DockerでSitecoreにSCCHコネクタモジュールを追加するの手順に進みます。

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

手記

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

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

チュートリアル: コンテナ環境でのSCCHコネクタ モジュールのインストールの準備

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

Dockerイメージをビルドする

チュートリアル: コンテナ環境でのSCCHコネクタモジュールのインストールの準備

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