ローカル開発環境の設定

この記事では、Microsoft Dynamics 365 Commerce でコマーススケールユニット (CSU) および POS (POS) 開発用のローカル開発環境を設定する方法について説明します。

重要

この記事で説明されている環境設定は、拡張機能開発にのみ使用できます。運用には使用できません。

注意

Commerce バージョン 10.0.38 以降、事前展開されたチャネル側の Commerce コンポーネントは、Retail ソフトウェア開発キット (SDK) が廃止されたため、更新されません。仮想マシン (VM) 上の残りのコンポーネントのバージョンに関係なく、事前展開されたコンポーネントの最終バージョンはバージョン 10.0.37 です。 VM でチャネル側の Commerce コンポーネントを開発する必要がある場合は、Retail SDK 拡張機能を Commerce SDK に移行するで説明するように、シールされたインストーラーに依存する Commerce SDK を使用します。事前に展開されたチャネル側の Commerce コンポーネントは、今後のリリースで削除されます。

サポートされる開発環境タイプ

Commerce は、クラウドベース環境とローカル環境の両方をサポートします。

Cloud ベース:Microsoft Dynamics Lifecycle Service (LCS) を使用してクラウドベースの開発環境をデプロイします。
ローカル: 自分のコンピューターで開発環境を設定するには、次の 2 つのオプションがあります:
- 自己ホスト CSU – この環境タイプは、CSU をローカルに展開します (実行可能ファイルとしての自己ホスト)。リアルタイム呼び出し用のInternet Information Services (IIS)、コマースデータ同期、またはコマース本社の接続はありません。このオプションを使用した場合、Commerce Headquarters と CSU チャネルのデータベース間でデータの同期は行われません。チャネルデータベースには、開発目的で使用される既定のデモデータが入力されています。ギフトカードを発行するための呼び出しなど、Commerce Headquarters へのすべての要求および呼び出しは、ローカル CSU によって阻止されます。
- IIS ホスト CSU: – この環境タイプは、IIS に CSU を展開し、Commerce Headquarters と CSU チャネルデータベースの間でデータを同期する Async Client を設定します。また、Commerce Headquarters とのリアルタイム接続のサポートも設定します。この設定には、追加のコンフィギュレーションがいくつか必要です。たとえば、Microsoft Entraアプリを設定し、証明書を展開する必要があります。 IIS ホスト CSU をインストールする方法の詳細については、IIS ホストされた Commerce Scale Unit の構成およびインストールを参照してください。

ハードウェア要件

16 GB の RAM と少なくとも 2 つの CPU コアを備えたWindows マシンを使用することをお勧めします。財務と運用アプリ、Retail Server、eコマース開発、その他の同時プロセスを実行している場合は、24 GB のRAM と 4 つの CPU コアをお勧めします。

ローカルの自己ホスト CSU

このバージョンのスケールユニットは、非常に軽量です。他のシステムおよびサービスへの最小限または全く依存関係を必要としない、さまざまな Commerce runtime (CRT)/RTS 拡張機能を開発する迅速な方法を提供します。

長所:

Commerce Headquarters は必須ではありません。
IIS は必須ではありません。 Retail Server はコンソールアプリでホストされます。
トランスポート層セキュリティ (TLS) のコンフィギュレーションは必須ではありません。
リアルタイムサービス (RTS) 通信は、一連のデモモード CRT ハンドラーによって阻止されます。
Async Client は必須ではありません。チャネルデータベースには自動的にデモデータが入力されます。
スケールユニットの展開を開始するのに必要なパラメーターはわずかしかありません。したがって、展開の前提条件は最小限に抑えられています。たとえば、証明書を明示的に作成してインストーラーに提供する必要はありません。
このバージョンでは、CRT/Retail Server の開発およびランタイム機能を迅速かつ簡単に紹介しています。

短所:

Cloud POS (CPOS)、Async Client、HTTPS は存在せず、RTS 呼び出しがないため、このバージョンは実際の運用環境で使用されるトポロジとは一致しません。
リアルタイム操作を完全にテストすることはできません。阻止されるためです。

ローカルの IIS ホスト CSU

IIS モードは完全なオンプレミスのスケールユニットであり、すべてのコンポーネントが実際の稼働展開と一致し、何も阻止されません。

長所:

このバージョンは、IIS で Retail Server をホストするオンプレミスのスケールユニットとして十分な機能を備えています。
これは、Commerce Headquarters との実際の (阻止されない) RTS 対話を使用します。
これには、通常のスケールユニットと同様に、Commerce headquarters データベースのデータに基づいて、チャネルデータベースを埋める Async Client が含まれます。したがって、デモデータは関係ありません。

短所:

証明書とMicrosoft Entra登録を作成し、コマース本社から構成ファイルをダウンロードするには、追加の手順が必要です。

ローカル開発環境を設定するための前提条件

自己ホスト環境または IIS ホスト環境を設定する前に、次の前提条件をこの順序で完了します:

Download .NET Core 8.0 から Windows x64 用 .NET Core SDK 8.0 をインストールします。 .NET Core SDK は、拡張機能の開発にのみ必要です。
ASP.NET Core ランタイム 8.0.x ホスティングバンドルを Windows 用にインストールするには、ASP.NET Core ランタイム 8.0 をダウンロードから入手してください。 x64 または x86 ではなく、ホスティングバンドル を選択します。
SQL Server の任意のエディションをインストールし、全文検索を有効にします。詳細については、「フィーチャーを SQL Server のインスタンスに追加する (セットアップ)を参照してください。サポートされる最小バージョンは、13.0.5026.0 SqlServer 2016 SP2 です。
- 混合 (SQL + Windows/統合) 認証を有効にします。
- SQL Serverの既定のインスタンスがインストールされていない場合、CSU のデプロイは失敗します。エラーメッセージは、インスタンスが見つからなかったことを示します。代わりに名前付きインスタンスを使用する場合は、行 71 の後に次の行を挿入して Install.ps1 ファイルを編集します。 (このスクリプトは、Dynamics365Commerce.ScaleUnit/src/ScaleUnitSample/Scripts フォルダーで検索できます。)
```
$installerArgs += $("--sqlservername", "PutYourSqlServerSeenInSSMSHere")
```
  (この行を挿入するときは、PutYourSqlServerSeenInSSMSHere を実際のSQL Server名に置き換えます)。
利用可能な NuGet 配布バージョンから NuGet.exe をインストールします。ある場所にコピーしてから、PATH 環境変数を追加更新して、その場所を指すようにします。
MSBuild がインストールされていない場合は、Download Visual Studio Tools から Visual Studio ツールをインストールしてください。 Tools for Visual Studio セクションを展開し、Build Tools for Visual Studio をダウンロードして実行します。どのコンポーネントも指定しないでください。 インストールを選択して、既定のインストールを行います。
- Visual Studioツールがインストールされたら、コマンドプロンプトウィンドウを開き、コマンド where msbuild を実行します。 msbuild.exe が見つからない場合には、Visual Studio 開発者コマンドプロンプトからコマンドを実行します。
- msbuild.exe を見つけた後、PATH 環境変数が、パスの先頭に "msbuild" を含むフォルダーを指していることを確認します。パスには、少なくともバージョン 15 の msbuild.exe のバージョンが含まれている必要があります。バージョン番号を確認するには、コマンド msbuild /version を実行します。
- PATH 変数が正しく設定されていることを確認するには、通常のコマンドプロンプトからコマンド msbuild/version を実行します。開発者コマンドプロンプトは使用しないでください。コマンドでは、少なくとも 15 のバージョン番号を出力する必要があります。 MSBuild の設定が完了したら、Visual Studio Code再起動します。
以前にダウンロードしたVisual Studio ツールを使用して、Microsoft.NET.Sdkをインストールします。 individual components に移動し、「.NET SDK」と入力し、.NET SDK のチェックボックスをオンにして、Install を選択します。
Node をダウンロードしてインストールするから、Node.js の 64-ビットバージョンをインストールします。 PATH 環境変数がその場所を指していることを確認します。メッセージが表示されたら、必要なツールの自動インストール チェックボックスをオンにします。
Download Visual Studio Code。
Extension Marketplace の手順に従って、Visual Studio Code用の C# for Visual Studio Code (OmniSharp を使用) 拡張機能をインストール>。
Scale Unit GitHub リポジトリ (リポジトリ)を複製またはダウンロードします。
LCS で、共有アセットライブラリに移動し、Retail セルフサービスパッケージをアセットタイプとして選択し、Commerce Scale Unit (SEALED) で終わるファイルを検索します。必要なリリースのバージョン (バージョン 10.0.22 または 10.0.23 など) を選択してください。ファイルをダウンロードし、前の手順 (Dynamics365Commerce.ScaleUnit/src/ScaleUnitSample/Download/) で複製またはダウンロードした Scale Unit GitHub リポジトリの Download フォルダーに配置します。

IIS ホスト CSU におけるその他の前提条件

IIS が必須であり、複数の機能を有効にする必要があります。インストーラーは必要な任意の機能を報告しますが、その機能はまだ有効になっていません。
システムで、TLS 1.2 を有効にする必要があります。 (TLS 1.0 または 1.1 は使用しないでください。) この前提条件に関してはインストーラーに確認させます。コンピューターで TLS 1.2 の変更が必要な場合、インストーラーには操作可能な指示が表示されます。
.vscode/tasks.json ファイルで次の変更を加えることにより、TLS の強力な暗号化を積極的に設定できます:
- baseProduct_Port – 既定のポート (446) を保持するか、または変更したい任意の値に変更できます。指定したポートが別のアプリケーションで使用される場合は、基本インストーラー展開で、別のポートを指定するように求めるメッセージが表示されます。
- baseProduct_SslCertFullPath – このパスは、CSU Web サイトが HTTPS 通信に使用する Secure Sockets Layer (SSL) 証明書を指す必要があります。この非実稼働設定の場合、証明書は自己署名ができます。この証明書は LocalMachine/Personal 証明書ストアに格納される必要があります。証明書を生成するには、次の手順に従います:
  1. IIS を開き、コンピュータ名のアイコンをダブルタップ (またはダブルクリック) します。
  2. サーバー証明書をダブルタップ (またはダブルクリック) します。
  3. 右側で、自己署名証明書を作成するを選択します。
  4. 証明書のフレンドリ名を指定するようにメッセージが表示されたら、コンピューターの完全修飾ドメイン名 (FQDN) を指定します。コンピューターがドメインと結合している場合、FQDN にはそのコンピューター名自体とドメインが含まれます。 FQDN を見つけるには、Windows PowerShell コマンド [System.Net.Dns]::GetHostEntry("") を実行します。また、Windows のコントロールパネル項目 System の Full computer name フィールドから FQDN を取得することもできます。
  5. 証明書ストア (個人) の規定値をそのまま使用します。
  6. [OK] を選択.
  7. 新しい証明書を一覧で検索し、ダブルタップ (またはダブルクリック) します。
  8. 詳細タブで、拇印の値を検索します。
  9. 拇印をテキストエディターにコピーして貼り付け、すべての文字を大文字に変換します。次に、baseProduct_SslCertFullPath オプションの定義済テンプレートの末尾に変換された値を追加して、テンプレートが store:///My/LocalMachine?FindByThumbprint=YourThumbprintGoesHere に類似するようにします。
  注意
  - 基本インストーラーには、さらに 2 つの証明書が必要で、合計 3 つの証明書が必要となります。セキュリティ上の理由から、すべての実稼働展開に対して、3 つの異なる証明書を作成する必要があります。ただし、この展開設定では、この方法がポリシーに違反しない限り、3 つのコンフィギュレーションオプションすべてで同じ証明書を使用することで時間を節約できます。この場合、次の 2 つのパラメーターに対して同じ拇印を指定できます。
  - すべてに同じSSL証明書を使用する場合、次の keyUsage プロパティ値が含まれている必要があります: digitalSignature、keyEncipherment、dataEncipherment.
- baseProduct_RetailServerCertFullPath – 作成した証明書の拇印を使用して、このパラメーターを更新します。この証明書は、Retail Server の ID を表します。 CSU が POS シナリオのセキュリティトークンを発行する場合などに、ID が使用されます。この証明書を作成するには、SSL 証明書に使用したのと同じ手順に従いますが、指定したい任意のフレンドリ名 (たとえば、RsTestIdentity) を指定します。この証明書は、後で Microsoft Entra アプリケーションを設定するときに必要になります。
- baseProduct_AsyncClientCertFullPath – Async Client は、コマース本社との通信のためにMicrosoft Entraからセキュリティトークンを取得するときに、この証明書を使用します。この証明書を作成するには、SSL 証明書に使用したのと同じ手順に従いますが、指定したい任意のフレンドリ名 (たとえば、AsyncClientTestIdentity) を指定します。
- baseProduct_RetailServerAadClientId – 値は、リテールサーバーの ID を表すMicrosoft Entra アプリケーションクライアント ID です。 CSU が POS シナリオのセキュリティトークンを発行する場合などに、この値が使用されます。アプリケーションを作成してそのアプリケーション (クライアント) ID を取得するには、独自のMicrosoft Entra アプリケーションを使用するように CPOS を構成する方法。
- baseProduct_RetailServerAadResourceId – 値は、登録済みのMicrosoft Entra アプリケーションのリソース ID です。「独自のMicrosoft Entraアプリケーションを使用するようにCPOSを構成する方法」の手順3cで説明されている「アプリケーションID URI」という値を使用します。
- baseProduct_CposAadClientId – 値は CPOS を表すMicrosoft Entra アプリケーションクライアント ID です。アプリケーションを作成し、そのアプリケーション (クライアント) ID を取得するには、独自のMicrosoft Entra アプリケーションを使用するように CPOS を構成する方法の手順 4 に従います。この手順では、Microsoft Entra IDで CSU/CPOS のセットアップを完了します。コマース本社で必要なセットアップを完了するには、独自のMicrosoft Entra アプリケーションを使用するように CPOS を構成する方法。
- baseProduct_AsyncClientAadClientId – 値は、Async Client が Commerce 本社で認証する必要がある場合に使用するMicrosoft Entra アプリケーションクライアント ID です。このアプリケーションを作成するには、独自のMicrosoft Entra アプリケーションを使用するように CPOS を構成する方法。 Commerce Headquarters を使用して作成済アプリケーションのみを登録するには、AX7 のサービスからサービスへの認証の手順 2 に従います。
- baseProduct_Config – Commerce Scale Unit チャネル構成ファイルをダウンロードするで説明されているように、Commerce headquarters からダウンロードできるチャネルデータベース構成に対応するファイル名のみ (完全なパスではない) を指定します。 Commerce Headquarters からファイルをダウンロードした後、ダウンロードフォルダーに保存します。
- baseProduct_UseSelfHost – この値を false に設定します。

自己ホスト CSU を使用した拡張機能のデバッグ

管理者としてVisual Studio Codeを開きます。
前に複製またはダウンロードしたスケールユニット GitHub リポジトリで、src\ScaleUnitSample フォルダーを開きます。
.vscode/tasks.json ファイルを開き、baseProduct_UseSelfHost を true に設定します。
ターミナル メニューで、タスクの実行を選択し、ビルド拡張機能を入力します。

このシステムで実行スクリプトが無効になっているというエラーメッセージが表示された場合は、管理者としてコマンドプロンプトウィンドウを開き、powershell Set-ExecutionPolicy RemoteSigned を実行します。次に、Visual Studio Codeを閉じてから再度開きます。セキュリティポリシーを変更する影響を理解していない限り、実稼働機械の実行ポリシーを変更しないでください。
拡張メソッドにブレークポイントを配置し、F5 キーを選択して拡張機能をデバッグします。

F5 を選択すると、次のアクションが自動的に実行されます。 (これらのアクションは、Visual Studio Codeでのみサポートされます)。

スケールユニットのサンプルコードがコンパイルされます。コンパイルにより、シールドされた CSU 拡張機能インストーラーを含むパッケージが生成されます。
基本シールドされたスケールユニットインストーラーは、まだ展開されていない場合に展開されます。
デモデータを含むパッケージは、SDK のフィードからダウンロードされ、チャネルデータベースに適用されます。
シールドされたスケールユニット拡張機能インストーラーが展開されます。
CSU の正常性チェックエンドポイントへの呼び出しの結果を示す Web ブラウザーウィンドウが開きます。
デバッガーは CSU をホストするプロセスに関連付けられ、CSU は URL http://localhost:12345 で受信要求を処理する準備ができています。

ローカルスケールユニットが要求に対応している間は、デバッグコンソールを使用してスケールユニットの内部診断のログをリアルタイムで監視します。ログは、デバッグしているときにに役立ちます。

IIS ホスト CSU を使用した拡張機能のデバッグ

Visual Studio Codeで、Run と Debug を選択します (または Ctrl + Shift + D を選択します)。上部ナビゲーションバーの下に、緑の矢印でドロップダウンメニューが表示されます。 IIS を使用したデバッグを選択します。
F5 キーを選択します。自己ホスト CSU モードでデバッグする場合と同様に、基本インストーラーが最初に展開されます。次に、拡張機能インストーラーが展開されます。
基本インストーラーは前提条件チェックを実行し、必要なアクションを報告します。前提条件には、SQL Server、IIS、TLS、.NET Core ホスティングバンドルが含まれます。
基本パッケージと拡張機能パッケージをデプロイした後、Visual Studio Codeは、正常性チェックの呼び出しの結果を示す Web ブラウザーウィンドウを開きます。 Visual Studio Codeは、またデバッガーをアタッチするよう求めるダイアログボックスを開きます。この手順はオプションです。デバッガーを関連付ける場合は、プロセスの一覧に w3wp と入力し、RssuCore を含む行を選択します。 RssuCore は、CSU Web サイトの実行に使用される IIS アプリケーションプールの名前です。

これで、次の要素を含む、完全に機能するオンプレミスの展開済スケールユニットとなりました:

チャネルデータベース
非同期クライアント
ASP.NET Core RTS 経由でコマース本社と対話できる 8 ベースのリテールサーバー
CPOS

展開した CPOS と CSU に対応する URL を検索するには、インストーラーのコンソール出力を確認します。 URL はプロセスの最後の方に表示され、CSU と CPOS の正常性チェックが行われます。チャネルデータベースに Commerce headquarters からデータを入力するには、その記事の前の手順を完了した後、新しいチャンネルのプロファイルを作成するの手順に従ってください。

IIS モードから自己ホストモードへの切り替え

IIS モードとセルフホステッドモードを切り替える場合は、必ず次の手順に従ってください (この実行が最初の実行である場合は、次の手順をスキップできます。ここで説明する値は既定値であるためです)。

Visual Studio Codeで、Run と Debug を選択します (または Ctrl + Shift + D を選択します)。上部ナビゲーションバーの下に、緑の矢印でドロップダウンメニューが表示されます。 自己ホストを使用したデバッグを選択します。
.vscode/tasks.json ファイルを開き、baseProduct_UseSelfHost が false に設定されるよう確認します。

F5 を選択すると、次のアクションが自動的に実行されます。 (これらのアクションは、Visual Studio Codeでのみサポートされます)。

スケールユニットのサンプルコードがコンパイルされます。コンパイルにより、シールドされた CSU 拡張機能インストーラーを含むパッケージが生成されます。
基本シールドされたスケールユニットインストーラーは、まだ展開されていない場合に展開されます。
デモデータを含むパッケージは、SDK のフィードからダウンロードされ、チャネルデータベースに適用されます。
シールドされたスケールユニット拡張機能インストーラーが展開されます。
CSU の正常性チェックエンドポイントへの呼び出しの結果を示す Web ブラウザーウィンドウが開きます。
デバッガーは CSU をホストするプロセスに関連付けられ、CSU は URL http://localhost:12345 で受信要求を処理する準備ができています。

拡張パッケージを実稼働に展開する

ビルドがエラーなく完了した場合、出力を使用して拡張機能を展開できます:

Cloud Scale Unit 拡張機能パッケージ – このパッケージは、ScaleUnit\bin\Debug\netstandard2.0 フォルダーにあり、クラウド展開用に使用されます。
スケールユニット拡張機能インストーラー – このインストーラーは、Installer\bin\Debug\net461 フォルダーにあり、オンプレミスの (店舗内) インストールに使用されます。

ビルドパイプラインを設定してパッケージを生成してから、それを展開する必要があります。詳細については、独立したパッケージ SDK のビルドパイプラインの設定およびパッケージを CSU に展開するを参照してください。

デバッグ

デプロイの問題をデバッグするには、Visual Studio Codeの Terminal タブでログと関連するメッセージの詳細セットを確認します。ご自身で問題点を特定できない場合は、Microsoft にお問い合わせください。 Microsoft にお問い合わせの際は、次のデータを提供してください:

実行したアクションの詳細な説明
基本のスケールユニットの展開プロセスの出力の最初と最後に参照されるログファイル
警告やエラーを含むVisual Studio Codeターミナルの出力

リテールサーバーと非同期クライアント (IIS ホストの場合) に対応するランタイムログは、Event Viewerの Windows Logs > Application にあります。ログをフィルター処理するには、次のソースを使用します:

Microsoft Dynamics - 非同期クライアントサービス
Microsoft Dynamics - Retail Server

セルフホステッド CSU では、ランタイムログもVisual Studio Codeターミナルに直接出力されます。

Visual Studio Code での既成のタスク

Visual Studio Codeの Terminal メニューで Run Task コマンドを選択すると、次の一連のタスクを使用できます。

ビルド拡張機能 – 拡張機能を構築します。
check-msbuild – Visual Studio Codeで使用できる MSBuild のバージョンを表示します。
check-ps-bitness – Visual Studio Codeで使用できる Windows PowerShell のバージョンが必要な 64 ビットバージョンかどうかを判断します。
clean-extension – 拡張機能の構築中に生成されたビルド出力を取り除きます。
インストール – 展開時のすべての前提条件を確認してから、選択したモード (自己ホストまたは IIS) に対して必要なすべてのアクションを実行します。このタスクには、基本のスケールユニットおよび拡張機能インストーラーのインストールが含まれます。
アンインストール – 拡張機能と基本のスケールユニットをアンインストールします。
uninstall-base-product – 基本のスケールユニットをアンインストールします。インストールされた拡張機能が検出された場合、このタスクは失敗します。
uninstall-extension – 拡張機能をアンインストールします。

サポート

セットアップが期待通りに機能しない、またはヘルプが必要な場合は、次のリンクを使用してサポートを利用してください:

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-03-10