Cloud Scale Unit 拡張機能パッケージの作成

この記事では、Microsoft Dynamics 365 Commerce Cloud Scale Unit (CSU) 用の拡張機能パッケージを作成する方法について説明します。

CSU 拡張機能パッケージには、次のコンポーネントの拡張機能コードが含まれます:

• Commerce Runtime (CRT) およびヘッドレス コマース アプリケーション プログラミング インターフェイス (API)
• チャネル データベース拡張機能スクリプト
• 決済コネクタ
• Web 向け Store Commerce

CSU パッケージを作成する

CSU パッケージを作成するには、次のいずれかのオプションを選択し、手順に従います。

オプション 1: GitHubからサンプル スケール ユニット パッケージ プロジェクトをダウンロードする

1. スケール ユニット パッケージ プロジェクトを Dynamics 365 Commerce Scale Unit Samples から複製またはダウンロードします。 ソフトウェア開発キット (SDK) またはアプリケーション リリースの正しいリリース ブランチ バージョンを選択します。 プロジェクトを複製する方法の詳細については、「Download Retail SDK サンプルと参照パッケージを GitHub および NuGet からダウンロードする>を参照してください。

2. Web 拡張プロジェクトの、拡張 CRT、Retail Server、チャネル データベース、支払、Store Commerce を、スケール ユニット パッケージ プロジェクトへのプロジェクト参照として追加します。

3. CRT、Retail Server、または支払の拡張機能が、実行するいずれかのアセンブリまたはパッケージに依存する場合は、それらのアセンブリをプロジェクト参照として拡張機能プロジェクトに含めます。 パッケージ化プロセスでは、これらのアセンブリが ext フォルダーに含まれます。 ランタイム エラーが発生する可能性があるため、依存アセンブリを CommerceRuntime.Ext.config ファイルには追加しないでください。

4. コンフィギュレーションまたは設定値を CommerceRuntime.Ext.config ファイルに含める必要がある場合は、次の例に示すように、スケール ユニットのパッケージング プロジェクト ファイルを編集し、CommerceRuntimeExtensionSettings プロパティを追加します。

   <CommerceRuntimeExtensionSettings Include="ext.YourKeyName">
       <Value>samplevalue</Value>
   </CommerceRuntimeExtensionSettings>
   

5. スケール ユニット プロジェクトを構築します。 プロジェクトは、プロジェクト ビンの出力フォルダーに CloudScaleUnitExtensionPackage.zip 出力パッケージを生成します。 その後、CloudScaleUnitExtensionPackage.zip パッケージを Microsoft Dynamics ライフサイクル サービス (LCS) にアップロードし、CSU に展開できます。 Visual Studio NuGet パッケージ マネージャーで、Microsoft.Dynamics.Commerce.Sdk.ScaleUnit の NuGet バージョンを、使用する SDK またはアプリケーションのバージョンに適したものを選択します。

オプション 2: 新しいスケール ユニット パッケージ プロジェクトを作成する

1. ターゲット フレームワークが Standard 2.0 .NETされている新しい C# クラス ライブラリ プロジェクトを作成します。

2. Microsoft.Dynamics.Commerce.Sdk.ScaleUnit NuGet パッケージをプロジェクトの依存関係として追加します。 適切な Microsoft.Dynamics.Commerce.Sdk.ScaleUnit NuGet バージョンを、SDK/アプリケーション バージョンに合わせて選択します。

3. Microsoft.Dynamics.Commerce.Sdk.ScaleUnit パッケージをhttps://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/nuget/v3/index.jsonから消費します。 次の例にあるとおり、パッケージのソースの場所を拡張機能プロジェクト ファイルの nuget.config ファイルに追加できます。

   <packageSources>
       <add key="dynamics365-commerce" value="https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/nuget/v3/index.json" />
       <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
       </packageSources>
   

4. Web 拡張プロジェクトの拡張機能 CRT、Retail Server、チャネル データベース、支払、Store Commerce を、CSU パッケージ プロジェクトへのプロジェクト参照として追加します。

5. CRT、Retail Server、または支払の拡張機能が、実行するいずれかのアセンブリに依存する場合は、それらのアセンブリをプロジェクト参照として拡張機能プロジェクトに含めます。 パッケージ化プロセスでは、これらのアセンブリが ext フォルダーに含まれます。 ランタイム エラーが発生する可能性があるため、依存アセンブリを CommerceRuntime.Ext.config ファイルには追加しないでください。

6. コンフィギュレーションまたは設定の値を CommerceRuntime.Ext.config ファイルに含める必要がある場合は、次の例に示すように、CSU パッケージング プロジェクト ファイルを編集し、CommerceRuntimeExtensionSettings プロパティを追加します。

   <CommerceRuntimeExtensionSettings Include="ext.YourKeyName">
       <Value>samplevalue</Value>
   </CommerceRuntimeExtensionSettings>
   

7. スケール ユニット プロジェクトを構築します。 プロジェクトは、プロジェクト ビンの出力フォルダーに CloudScaleUnitExtensionPackage.zip 出力パッケージを生成します。 その後、 CloudScaleUnitExtensionPackage.zip パッケージを LCS にアップロードし、CSU に展開できます。

スケール ユニット パッケージ プロジェクトは、CRT 拡張構成ファイル (Web.Config) を生成します。 拡張コンフィギュレーション ファイルを手動で作成する必要はありません。

CSU にパッケージを配置する

パッケージを CSU にデプロイするには、次の手順に従います。

1. LCS にサインインして、プロジェクトを開きます。

2. メニュー ボタン (ハンバーガー メニューまたはハンバーガー ボタンと呼ばれる場合もあります) を選択してから、資産ライブラリを選択します。

3. 資産タイプとして Commerce Cloud Scale Unit Extension を選択し、プラス記号 (+) ボタンを選択してパッケージをアップロードします。

4. パッケージの名前と説明を入力し、ファイルの追加を選択してパッケージ ファイルを追加します。

5. アップロードが完了したら、[確認] を選択 します。

   LCS がパッケージを検証します。 この検証には数分かかります。

6. 検証が完了したら、パッケージを リリース候補としてマークします。

7. パッケージをアップロードしたら、環境にデプロイします。 詳細については、Commerce Scale Unit (クラウド) への更新プログラムと拡張機能の適用の手順に従ってください。