---
title: "カスタムCommerceコンテナ画像作成のワークフロー"
slug: "workflow-for-creating-custom-commerce-container-images"
abstract: "Sitecore Commerce Container SDKに提供されているリソースを使って、自分だけのCommerceコンテナイメージを構築する方法。"
---
# カスタムCommerceコンテナ画像作成のワークフロー

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

> !注このワークフロー [は、すでに](https://dev.sitecore.net/Downloads/Sitecore_Commerce/102/Sitecore_Experience_Commerce_102.aspx) 開発者ワークステーションでSitecore.Commerce.Container.SDK.ZIPパッケージをダウンロードし解凍していることを前提としています。
> 
> [Sitecore Commerce Container SDK](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/sitecore-commerce-container-sdk.html "Sitecore Commerce Container SDK")の内容や提供されるスクリプトファイルに慣れておくことを必ず確認してください。

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

-   [カスタム画像タグを設定に追加してください](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html#UUID-7d3f3c9d-d352-6e8d-348f-60ee1ee2a5a6_section-idm23193476876763 "Add your custom image tags to the configuration")
-   [カスタマイズをSitecore Commerce Container SDKに追加してください](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html#UUID-7d3f3c9d-d352-6e8d-348f-60ee1ee2a5a6_section-idm2319343218384 "Add your customization to the Sitecore Commerce Container SDK")
-   [環境変数を画像タグの値で更新してください](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html#UUID-7d3f3c9d-d352-6e8d-348f-60ee1ee2a5a6_section-idm231934766201352 "Update the environment variables with image tag values")
-   [コンテナ画像のコンテンツを入手](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html#UUID-7d3f3c9d-d352-6e8d-348f-60ee1ee2a5a6_section-idm231933242031533 "Get content for container images")
-   [コンテナイメージを構築しましょう](https://doc.sitecore.com/xp/ja/developers/102/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html#UUID-7d3f3c9d-d352-6e8d-348f-60ee1ee2a5a6_section-idm253206233152888 "Build your container images")

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

デフォルトでは、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](https://dev.sitecore.net/Downloads/Sitecore_Commerce.aspx)サイトからダウンロードしてください:
    
    -   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