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

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

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

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

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

メモ

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

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

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

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

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

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

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

  1. ホストで実行されているOSに基づいて、適切なJSONファイルを開きます。

  2. "customercommercetag"の値を適切なタグ値に置き換えます。

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

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

カスタマイズをSitecore Commerce Container SDKに追加するには、次の手順に従います。

  1. Commerce Engineのカスタマイズアーティファクトを次のフォルダに追加します。

    xc-common/engine/wdp/
    手記

    WDPフォルダを作成する必要があります。

  2. Business Toolsのカスタマイズを次のフォルダーに追加します。

    xc-common/engine/bizfx/wdp
    手記

    WDPフォルダを作成する必要があります。

  3. Content Delivery (CD) またはContent Management (CM) ロールに影響を与えるカスタム成果物を次の場所に追加します。

    • CMのカスタマイズを次のフォルダに追加します。 xc0/cm

    • このフォルダにCDカスタマイズを追加します。 xc1/cd

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

UpdateEnvTag.ps1スクリプトを使用して、.envファイルを、適切なWindows OSバージョンに対応する設定ファイルに含まれる新しいイメージ タグ値 (config2009.jsonファイルやconfigltsc2019.jsonファイルなど) で更新します。

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

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

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

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

Sitecore Experience Commerceは、ベースSitecore XPイメージの上にレイヤー化する次のXCアセット イメージを提供します。

  • sitecore-xc0-assets – sitecore-xp0* 画像の上にオーバーレイします。

  • sitecore-xc1-assets –sitecore-xp1* 画像の上にオーバーレイします

  • sitecore-xc1-storefront-assets – XC1-assetsの上にどのオーバーレイが重なるか

XCアセット イメージの使用方法の例として、Sitecore Experience.Commerce.Container.SDKのxc0、xc1、xc1-cxaフォルダーの内容を確認できます。

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

手記

PrepEngineContainerbuild.ps1スクリプトの目的は、Sitecore Commerce EngineとBusiness Tools (BizFx) のアーティファクトのみを配置することです。

次に、標準で提供されているCommerce EngineとBizFxのコンテンツを使用して、カスタムのCommerce EngineまたはBizFxイメージを作成する方法を示します。

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

  1. 次のSitecore Experience CommerceリリースパッケージをSitecoreダウンロード サイトからダウンロードします。

    • Packages for On Premise WDP ****.**.**-*.*.***

    手記

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

  2. リリース パッケージの内容を別のフォルダー ( c:\downloads\wdpsなど) に抽出します。

  3. コンテナイメージをビルドするための想定される場所にコンテンツパッケージを配置するには、PowerShellウィンドウを開き、次のコマンドを実行します。

    PrepEngineContainerbuild.ps1 -wdpPath 'C:\downloads\wdps

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

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

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

    ContainerBuild.ps1 -envRootPath 'C:\sitecore-commerce'

  2. すべてのDockerイメージをリストして、イメージが作成されたことを確認します。

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