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

Sitecore Experience Commerce(サイトコアエクスペリエンスコマース)
コマースDevOps
行政
Commerceコンテナーの使用を開始する
カスタム Commerce コンテナイメージを作成するためのワークフロー

カスタムCommerceコンテナイメージを作成するためのワークフロー

Version:

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

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

Visual Studioで正常に実行できる機能または完全なソリューションの開発が完了したら、デプロイ用の新しいコマースソリューションのコンテナーイメージを作成できます。

メモ

このワークフローは、開発者ワークステーションにSitecore.Commerce.Container.SDK.ZIPパッケージを既にダウンロードして抽出していることを前提としています。

Sitecore Commerce Container SDKの内容と、それが提供するスクリプトファイルについて理解しておいてください。

先に進む前に、以下を行います。

Docker Composeバージョン1.27.4 (またはそれ以前) を使用して、カスタムXCコンテナをビルドしてください。Docker Composeのバージョンを確認するには、docker-compose --versionコマンドを実行します。
Dockerコンテナのすべてのトポロジフォルダは、Sitecore Commerce Containers SDKフォルダに保持します。トポロジフォルダーは、カスタムコンテナーを正常にビルドするために必要なリソースを共有します。

独自のSitecore XCコンテナイメージを作成するには:

WDPマッピングファイルを更新する

WDPMapping.jsonファイルには、Sitecore Experience Commerce (XC) リリースパッケージアーティファクトのコンテンツをdocker-compose build処理する正しい場所に配置するために使用されるマッピング情報が含まれています。

手記

独自のCommerce EngineソリューションでXCコンテナを初めて作成する場合は、Sitecore XCリリースパッケージの一部であるデフォルトのサンプルCommerce Engine WDP (Sitecore.Commerce.Engine.OnPrem.Solr) への参照を削除する必要があります。

カスタマイズしたソリューションの領域に対応するパッケージからWDPへの参照を削除して、カスタマイズが既定のリリースパッケージで上書きされないようにする必要があります。たとえば、Commerce Business Toolsをカスタマイズした場合は、WDPMapping.jsonファイルからSitecore.BizFx.OnPremブロックを削除する必要があります。

を更新するには WDPMappings.json

Sitecore.Commerce.Container.SDK.*.*.***/scripts/WDPMapping.jsonを開きます。

サンプルのCommerce Engine WDPを削除します。

{
    "WDPs": [
        "Sitecore.Commerce.Engine.OnPrem.Solr"
    ],
    "DestinationFolder": "xc-common/engine/wdp",
    "ToCopyFolder": "Content/Website"
}

XC Business Toolsをカスタマイズした場合は、Sitecore.BizFx.OnPremパッケージへのマッピングを含む次のセクションも削除する必要があります。

{
    "WDPs": [
         "Sitecore.BizFx.OnPrem"
    ],
    "DestinationFolder": "xc-common/bizfx/wdp",
     "ToCopyFolder": "Content/Website"

}

カスタム画像タグを設定に追加する

デフォルトでは、Commerceコンテナのビルドプロセスでは、latestタグのイメージが使用されます。コンテナに特定のイメージを含める場合は、使用するイメージのバージョンに対応するタグを使用して設定を更新する必要があります。

変更する設定ファイルは、Windows OSタグのバージョンによって異なります。コンテナをホストしているWindows OSのバージョンに対応するJSONファイル ( 、config2009.json、config.2004、config20H2.json、configltsc2019.jsonなど) を変更します。

カスタム画像タグを設定に追加するには:

ホストで実行されているOSに基づいて、適切なJSONファイル ( config2009.json、config2004.json、config20H2.json、configltsc2019.jsonなど) を開きます。
"customercommercetag"の値を適切なタグ値に置き換えます。

カスタマイズをSitecore Commerce Container SDKに追加する

Commerce Engineのカスタマイズをコンテナ化するには、カスタムコードまたはバイナリを適切なSitecore.Commerce.Container.SDKフォルダに追加する必要があります。SDKフォルダー構造内でカスタム成果物を追加する場所は、カスタマイズの影響を受けるソリューションの領域によって異なります。

Commerce Engineのカスタマイズアーティファクトを次のフォルダーに追加します。 xc-common/engine/wdp/

手記

wdpフォルダを作成する必要があります。
Business Toolsのカスタマイズを次のフォルダーに追加します。 xc-common/engine/bizfx/wdp

手記

WDPフォルダを作成する必要があります。
Content Delivery (CD) ロールまたはContent Management (CM) ロールに影響を与えるカスタム成果物を含めるには、それらを適切なWDPフォルダーに追加する必要があります。CMフォルダとCDフォルダへのパスは、それぞれ次のとおりです。
- CMカスタマイズ用のWDPフォルダー: <sdk_directory>xc1-cxa/cm/wdp
- CDカスタマイズ用のWDPフォルダ: <sdk_directory>xc1-cxa/cd/wdp
手記

WDPフォルダにカスタムファイルを追加する場合は、CDまたはCMインスタンスのルートフォルダと同じフォルダ構造をレプリケートする必要があります。 <sdk_directory>xc1-cxa/<CD or CM>/wdpフォルダは、inetpub/wwwroot/<CD or CM instance> フォルダに相当します。

たとえば、新しいバイナリファイルを含むCDカスタマイズがある場合は、新しいバイナリを含むbinフォルダをWDPフォルダのルートに作成し、sdk_directory>xc1-cxa/cm/wdp/binなど)、CDルートフォルダ ( inetpub/wwwroot/SXAstorefront/bin) の構造に一致させます。

環境変数を画像タグ値で更新する

UpdateEnvTag.ps1タグを使用して、.envファイルを新しいイメージタグ値 (config2009.jsonファイルやconfigltsc2019.jsonファイルなど) で更新します。

環境変数を新しいタグ値で更新するには:

PowerShellウィンドウを開き、次のコマンドを実行します。

UpdateEnvTag.ps1 -jsonFile 'C:\sitecore-commerce\scripts\configltsc2019.json' `
                 -envRootPath 'C:\sitecore-commerce'

コンテナイメージのコンテンツを取得する

PrepContainerbuild.ps1スクリプトを使用して、マシン上のSitecore Experience Commerceリリースパッケージの場所からアーティファクトを取得し、それらをSitecore.Commerce.Container.SDKディレクトリ構造に展開します。PrepContainerbuild.ps1は、WDPMapping.jsonで事前定義された場所にパッケージをコピーします。

画像の内容を取得するには:

次のSitecore Experience CommerceリリースパッケージをSitecoreダウンロードサイトからダウンロードします。
- Packages for On Premise WDP ****.**.**-*.*.***
手記

コンテナービルドの準備に使用されるPrepContainerbuild.ps1スクリプトには、このリリースパッケージ内のWDPへの参照が含まれています。

コンテナーイメージを取得するには、PowerShellウィンドウを開き、次のコマンドを実行します。

PrepContainerbuild.ps1 -jsonFile 'C:\src\Commerce.Containers\WDPMapping.json' -releaseZipPath 'C:\src\Commerce.Containers\downloads'

コンテナイメージをビルドする

コンテナイメージをビルドするには:

PowerShellウィンドウを開き、次のコマンドを実行します。
ContainerBuild.ps1 -envRootPath 'C:\sitecore-commerce'
すべてのDockerイメージをリストして、イメージが作成されたことを確認します。
docker images

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