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) またはアプリケーション リリースの正しいリリース ブランチ バージョンを選択します。 プロジェクトを複製する方法の詳細については、GitHub と NuGet から Retail SDK サンプルと参照パッケージをダウンロードするを参照してください。

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 Lifecycle Services (LCS) にアップロードし、CSU にデプロイできます。 Visual Studio NuGet パッケージ マネージャーで、SDK またはアプリケーションのバージョンに適した Microsoft.Dynamics.Commerce.Sdk.ScaleUnit NuGet バージョンを選択します。

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

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

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

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 (クラウド) への更新プログラムと拡張機能の適用の手順に従ってください。