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

  • [アーティクル]

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

メモ

返信 URLやサービス プリンシパルを削除すると、ブラウザの Store Commerce の Microsoft Entra に関連する操作が中断されます。

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

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

CSU パッケージを作成する

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

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

  1. Dynamics365 Commerce ScaleUnit サンプルからスケール ユニット パッケージ プロジェクトを複製またはダウンロードします。 ソフトウェア開発キット/アプリケーション リリースのバージョンに適切なリリース ブランチ バージョンを選択します。 プロジェクトを複製する方法の詳細については、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. https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/nuget/v3/index.json から、Microsoft.Dynamics.Commerce.Sdk.ScaleUnit パッケージを使用します。 次の例にあるとおり、パッケージのソースの場所を拡張機能プロジェクト ファイルの 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 (クラウド) への更新プログラムと拡張機能の適用の手順に従ってください。