Sitecore OrderCloud Headstart - Part 3 ローカルでの展開

これまで OrderCloud Headstart として提供されているサンプルを立ち上げるために、２回に分けて、環境の準備、設定と進めていきました。今回はすでにダウンロードしていたソースコードを利用して、ローカルでの展開手続きを進めていきます。

Middleware をローカルで実行する

Visual Studio で手元にあるプロジェクトを開いてください。画面のようになっていれば、準備が完了です。

今回は設定に関してすべて Azure の App Configuration にアップロードをしたので、その値を利用して動かしたいと思います。そこで、Visual Studio のプロファイルを追加して、設定を読み込みするような手順を進めます。

ソリューションエクスプローラーにて、 Headstart.API のプロパティを開く
デバッグを選択する
プロファイルを追加する
起動方法はプロジェクトを選択
環境変数として APP_CONFIG_CONNECTION を追加します。

環境変数の値としては、Azure Portal から App Configuration のリソースを開き、設定 - アクセスキーを選択したあと接続文字列をコピーして取得してください。

続いてソリューションのビルドを実行します。

ビルドエラーが出ないことを確認して、実行をします。Visual Studio のメニューにある ▷ Test （先ほど作成したプロファイル）を指定して実行をします。

しばらくするとコンソールが立ち上がり、プログラムが動いている状況の確認ができます。

1 つめの URL にアクセスをすると、以下のように Headstart Middleware API の画面が表示されます。

OrderCloud データのシード

上記の画面が起動している状況で、Postman を利用して初期化用のデータを投入していきます。Postman がアクセスする URL はローカルのサーバーに対して /seed のパスを指定して Post を実行することになります。その際のサンプルのデータは以下のようになります。

{
  "PortalUsername": "",
  "PortalPassword": "",
  "InitialAdminUsername": "",
  "InitialAdminPassword": "",
  "MiddlewareBaseUrl": "",
  "MarketplaceID": "",
  "OrderCloudSettings": {
    "Environment": "sandbox",
    "WebhookHashKey": ""
  },
  "StorageAccountSettings": {
    "ConnectionString": ""
  }
}

それぞれには以下の項目を設定します。下記の MarketplaceID はすでに Part 1 の最後に作成していると思いますが、まだであれば最初のステップを確認しながら作成をします。

項目	入力	例
PortalUsername	ordercloud.io のログイン名	sitecoredemo
PortalPassword	ordercloud.io のパスワード	Hell0wor!d
InitialAdminUsername	初期管理者のユーザー名	admin
InitialAdminPassword	初期管理者のパスワード	p@ssw0rd!
MiddlewareBaseUrl	Middleware の URL	https://localhost:5001/
MarketplaceID	ordercloud.io で作成している ID
Environment	sandbox
WebhookHashKey	WebHook のキー	demo-Headstart
ConnectionString	Blob ストレージの接続文字列