1. Commerceコンテナの使い始め方

カスタムCommerceコンテナ画像作成のワークフロー

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

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

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

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

Sitecore Commerce Container SDKの内容や提供されるスクリプトファイルに慣れておくことを必ず確認してください。

自分だけのSitecore XCコンテナ画像を作成するには:

カスタム画像タグを設定に追加してください

デフォルトでは、Commerceコンテナのビルドプロセスでは最新のタグが付いた画像を使用します。特定の画像をコンテナに入れたい場合は、使いたい画像のバージョンに対応するタグで設定を更新する必要があります。

変更する設定ファイルは、Windows OSタグのバージョンによって異なります。例えば、config2009.json、config.2004、config20H2.json、configltsc2019.jsonなど、あなたのコンテナをホストするWindows OSのバージョンに対応する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 アセットの上に重ねてしまいます

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 Downloadsサイトからダウンロードしてください:

    • 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

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