1. Commerceコンテナーの使用を開始する

Sitecore CommerceコンテナSDK

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

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

Sitecore Commerce Container SDKは、コンテナ化されたコマース ソリューションを使用するための出発点を開発者に提供します。

SDKパッケージには、Dockerファイル、環境変数ファイル、Docker Compose YAMLファイル、Kubernetes YAMLファイル、サンプル スクリプトなどのリソースが含まれており、これらを使用して次の操作を行うことができます。

Sitecore.Commerce.Container.SDK.*.ZIPパッケージとサポートのインストール ガイドは、SitecoreのダウンロードWebサイトで入手できます。

Sitecore Commerce Container SDKの構造

Sitecore.Commerce.Container.SDK.*.ZIPパッケージは複数のフォルダーに分割されており、特定のトポロジにSitecore XCをデプロイするために必要なアーティファクトが含まれているものもあれば、複数の設定で共有される共通ファイルが含まれているフォルダーもあります。

最上位レベルでは、Sitecore.Commerce.Container.*.ZIPパッケージには次のフォルダーが含まれています。

フォルダ名

形容

k8s-commerce-xc1

Kubernetes XC1デプロイメント・トポロジーに必要なファイルが含まれています。

postman

DockerまたはKubernetesで実行されるCommerceデプロイで使用するPostman環境ファイル (JSON形式) のサンプル セットが含まれています。

scripts

例として提供される一連のサポート スクリプトとJSONファイルが含まれており、Dockerを使用してSitecore Experience Commerceコンテナー イメージを簡単に作成できます。

また、各スクリプトの目的を説明するREADMEファイルも含まれています。

Upgrade

Sitecore XCデータベース コンテンツのアップグレードに使用される設定ファイルと環境ファイルが含まれています。

xc0

Commerce Engineのデプロイのみを目的として、XC0トポロジでSitecore XCインスタンスをビルドおよび実行するために使用されるファイルが含まれています。

メモ

開発者ワークステーションのXC0トポロジには、SXAストアフロントまたはサポート モジュールのコンテナ イメージは含まれていません。

SXAストアフロントをサポートするために必要なモジュールを含むデプロイメントでは、XC1-CXAトポロジをインストールする必要があります。

xc1

Sitecore XC1トポロジ イメージのビルドに使用されるファイルが含まれています。XC1トポロジは、SXA Storefrontをサポートするモジュールを除外するスケーリングされた展開用です。このトポロジは、SXA Storefrontを使用しない、スケーリングされたCommerce Engineのみのデプロイで使用します。

手記

Sitecore Commerce Container SDKには、XC1トポロジのコンテナ イメージをデプロイするために必要なすべてのDocker Compose YAMLファイルが含まれているわけではありません。

xc1-cxa

XC1トポロジでSitecore XCインスタンスをビルドして実行するために必要なファイルが含まれています。このデプロイ トポロジには、SXA Storefrontが含まれます。

xc-common

一般的なSitecore XCイメージをビルドするために必要なファイルが含まれています。

手記

共通のイメージは、すべてのSitecore XCトポロジで使用されます。

xc-commonフォルダ

xc-commonフォルダーには、SDKに含まれるすべてのデフォルトのデプロイ トポロジに共通するSitecore XCイメージをビルドするために必要なすべてのファイルが含まれています。

次に、xc-commonフォルダ構造の例を示します。

serviceフォルダ

service各フォルダ:

  • コンテナを表します

  • 少なくともDockerfileが含まれています。

  • Docker Composeファイル内の対応するサービスのDockerビルド コンテキストとして使用されます。

Docker composeビルドYAMLファイル

docker-compose.build.ymlファイルは、XC0とXC1の両方のデプロイメントトポロジで使用される次のサービスのイメージビルドを定義します。

手記

このフォルダ内のイメージは、xc0 、xc1、およびxc1-cxaフォルダにあるイメージの前にビルドする必要があります。

  • id

  • bizfx

  • engine

xc0フォルダ

xc0フォルダーには、Sitecore XC0トポロジ イメージのビルドと実行に必要なすべてのファイルが含まれています。

次に、xc0フォルダ構造の例を示します。

serviceフォルダ

service各フォルダ:

  • コンテナを表します。

  • Docker Composeファイル内の対応するサービスのDockerビルド コンテキストとして使用されます。

docker compose build YAMLファイル

docker-compose.build.ymlファイルは、次のサービス用にビルドされたイメージを定義します。

  • solr-init

  • cm

  • xconnect

  • xdbsearchworker

  • xdbautomationworker

このdocker-compose.ymlには、XC0インスタンスに必要なすべてのコンテナに関する情報が含まれています。

xc1フォルダ

xc1フォルダには、XC1トポロジ イメージのビルドに必要なすべてのファイルが含まれています。

次に、xc1フォルダ構造の例を示します。

serviceフォルダ

service各フォルダ:

  • コンテナを表します。

  • Docker Composeファイル内の対応するサービスのDockerビルド コンテキストとして使用されます。

docker compose build YAMLファイル

docker-compose.build.ymlファイルは、次のサービス用にビルドされたイメージを定義します。

手記

このフォルダ内の画像は、xc1-cxaフォルダに含まれる画像よりも先にビルドする必要があります。

  • mssql-init

  • solr-init

  • solr-init-searchstax

  • xdbcollection

  • prc

  • cm

  • cd

  • xdbsearch

  • xdbsearchworker

  • xdbautomation

  • xdbautomationworker

xc1-cxaフォルダ

xc1-cxaフォルダーには、SXAストアフロントを含むXC1トポロジ イメージのビルドと実行に必要なすべてのファイルが含まれています。

次に、xc1-cxaフォルダ構造の例を示します。

serviceフォルダ

xc1-cxaフォルダ内には、service各フォルダがあります。

  • コンテナを表します。

  • 少なくともDockerfileが含まれています。

  • Docker Composeファイル内の対応するサービスのDockerビルド コンテキストとして使用されます。

docker compose build YAMLファイル

docker-compose.build.ymlファイルは、次のサービス用にビルドされたイメージを定義します。

docker compose YAMLファイル

docker-compose.ymlファイルには、XC1インスタンスに必要なすべてのコンテナに関する情報が含まれています。

scriptsフォルダ

このscriptsフォルダーには、Dockerを使用したSitecore Experience Commerceコンテナー イメージの作成を容易にする一連のサポート スクリプトとJSONファイルが含まれています。

次の表に、scriptsフォルダの内容をリストし、簡単に説明します。

手記

詳細については、scriptフォルダに含まれるreadme.mdファイルを参照してください。スクリプトファイル自体にも、追加情報とガイダンスがコメントされています。

ファイル

形容

CleanContainerCache.ps1

Dockerコンテナイメージのキャッシュをクリーンアップするために使用されるスクリプト。コンテナイメージキャッシュは、レジストリからコンテナイメージをプルする必要があるアクションを高速化するために使用されます。コンテナイメージキャッシュを使用するDockerコマンドの例としては、docker pull、docker-compose up、docker-compose buildなどがあります。

ComposeInit.ps1

Windows Docker環境を初期化するために使用されるスクリプトで、環境が迅速に準備され、Dockerデプロイの準備が整います。

ContainerBuild.ps1

docker-compose.build.ymlファイルの内容に基づいてコンテナイメージを構築するために使用されるスクリプト。結果は、タグlatestが付いたコンテナイメージになります。

ContainerTag.ps1

指定されたタグ値に基づいてコンテナイメージにタグを付けるために使用されるスクリプト。

PrepEngineContainerBuild.ps1

WDPのCommerce.Engine.OnPrem.SolrとSitecore.BizFx.OnPremを取得し、Sitecore XCコンテナーのDockerファイルで想定される構造に内容を展開するスクリプト。

UpdateEnvTag.ps1

コンテナイメージのレジストリ、名前空間、プロジェクト、およびコンテナイメージのタグを設定するスクリプト。

UpdateK8SYaml.ps1

Kubernetesシークレット ファイルにconfigltsc2019.jsonファイルの値を設定するスクリプト。Kubernetesは、Windows LTSC 2019環境でのみサポートされます。

UpdateK8SUpgradeYaml.ps1

コンテナのアップグレードシナリオのシークレットファイルを更新するために使用されるスクリプト。 Kubernetesは、Windows LTSC 2019環境でのみサポートされます。

configltsc2019.json

config20H2.json

config2009.json

UpdateEnvTag.ps1、ComposeInit.ps1、およびUpdateK8SYaml.ps1スクリプトによって使用されるファイルで、.envファイルとymlファイル内のトークンをオーバーライドまたは置換します。これにより、ビルドおよび実行プロセスで使用するためにファイルをカスタマイズできます。

readme.md

提供されたスクリプトの詳細を含むreadmeファイル。

upgradeフォルダ

upgradeフォルダーには、Sitecore XCコンテンツのアップグレードに使用できる必要なDockerファイルとKubernetesファイルが含まれています。

次に、アップグレード フォルダ構造の例を示します。

+ upgrade
    + k8s-sitecore-xc1
        + configuration
            + [...]
        + kustomization.yaml
        + mssql-upgrade.yaml
    + sitecore-xc
        + docker-compose-upgrade.yml
        + upgrade.env

k8s-sitecore-xc1フォルダー

k8s-sitecore-xc1フォルダーには、Sitecore XCアップグレード用のKubernetesファイルが含まれています。

次の表に、k8s-sitecore-xc1scriptsフォルダの内容をリストし、その内容を簡単に説明します。

ファイル

形容

mssql-upgrade.yaml

Kubernetesクラスターでアップグレード コンテナーをデプロイ、構成、および実行するために使用するKubernetes仕様ファイル。

kustomization.yaml

アップグレードコンテナに必要なすべてのシークレットの名前と値をデプロイするファイル。

ks8s-sitecore-xc1/configurationフォルダー

ks8s-sitecore-xc1/configurationフォルダには、secretsファイルとConfigMapファイルが含まれています。これらのテキスト ファイルには、アップグレード コンテナーで使用されるKubernetes secretsとConfigMapの値が格納されます。

sitecore-xcフォルダー

sitecore-xcフォルダーには、Sitecore XCのアップグレードに使用されたdocker作成ファイルが含まれています。

次の表に、sitecore-xcフォルダ内のファイルの一覧と簡単な説明を示します。

ファイル

形容

docker-compose-upgrade.yaml

Sitecore XC Mssqlコンテナのアップグレードに使用されるdocker作成ファイル。

upgrade.env

アップグレードに使用される変数を含む環境ファイル。

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