インストールファイルを準備してください

インストールに必要なファイルの準備:

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

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コンテナデプロイフォルダにアクセスしてください。例えば、compose\ltsc2019\xp1

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

7. .envファイルに以下の変数を追加します:

   DEF_IMAGE=scr.sitecore.com/sxp/modules/sitecore-def-xp1-assets

   .0.0-1809 TOOLING_IMAGE=scr.sitecore.com/tools/sitecore-docker-tools-assets
   .3.0-1809

8. .envファイルを保存してください。

9. DEF compose\\ フォルダからdocker-compose.override.ymlファイルをコピーし、Sitecoreコンテナデプロイメントcompose\\ フォルダ( 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=`

   Version: 8.0

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

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

   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

   Version: 8.0

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

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

   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=`

   Version: 8.0

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

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

   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

   Version: 8.0

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

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

   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=`

   Version: 8.0

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

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

   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

   Version: 8.0

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

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

   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\\\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にデプロイする場合は、「 Walkthrough: Installation Data Exchange Framework in the Service」の指示をAzure Kubernetes続けてください。

!注接続文字列の追加やウェブ設定ファイルの変更など、Sitecoreのデプロイメントを変更する場合、設定変換を使う必要があります。構成変換の適用方法については、Sitecoreコンテナ開発ドキュメントをご覧ください。