次の方法で共有

課金アダプターのサンプルをビルドして実行する方法

  • [アーティクル]

 

適用対象: Windows Azure Pack

課金アダプターのサンプルは、 で https://www.microsoft.com/en-us/download/details.aspx?id=41146入手できる Windows Azure Pack Developer Kit サンプルの一部として提供されています。 次のトピックでは、コンソール アプリケーションまたは Windows サービスとしてサンプルをビルドして実行する方法を示します。 サンプルを Windows サービスとして実行する方法を示すスクリプトも用意されています。

注意

課金アダプターが最初に開始されると、Windows Azure Pack Usage API のすべての履歴データを使用するまでに時間がかかる場合があります。 使用するイベントが多数ある場合は、同期の問題を回避するためにテナント機能を一時的に無効にする必要があります。 これが行われなければ、依存イベントが購入時に課金システムに処理されていない場合、ユーザーは購入操作の一部をブロックする可能性があります。 これを行うには、TenantSite、TenantAPI、TenantPublicAPI のアプリケーション プールまたはサイト サービスを停止します。

課金アダプターのサンプルの構築

課金アダプターのサンプルをビルドするには

  1. Windows Azure Pack 開発者キットの zip ファイルをフォルダーに抽出します。

  2. 抽出したフォルダーで、BillingAdapter フォルダーに Microsoft.WindowsAzurePack.Samples.Billing.sln課金 アダプター Visual Studio ソリューションを見つけます。

  3. Visual Studio でソリューション (.sln) ファイルを開きます。

  4. [ツール] メニュー オプションを選択し、[拡張機能と更新] を選択して、最新の NuGet パッケージ インストーラーがインストールされていることを確認します。 表示されたダイアログ ボックスで、[ オンライン ] を選択し、[ Visual Studio ギャラリー ] を選択して、NuGet パッケージ マネージャーの更新プログラムがあるかどうかを確認します。 ある場合は、インストールします。

    NuGet パッケージ マネージャーがインストールされていない場合は、「」を参照してください https://www.nuget.org/。

  5. [NuGet パッケージ インストーラー オプション] ダイアログ ボックスを開いて、必要なパッケージが自動的にダウンロードされるようにします。 これを行うには、[ ツール ] メニューの [ ライブラリ パッケージ マネージャー]、[ ソリューションの Nuget パッケージの管理...] の順に選択します。 [ NuGet パッケージの管理 ] ダイアログ ボックスが表示されます。 [ 設定] をクリックして、[ オプション ] ダイアログ ボックスを開きます。

  6. [ パッケージ マネージャー ] を選択し、[ 全般] を選択します。

  7. [パッケージの復元] セクションで、[Nuget で不足しているパッケージのダウンロードを許可する] と [Visual Studio でのビルド中に不足しているパッケージのチェックが自動的に行われる] チェック ボックスがオンになっていることを確認します。

  8. [ OK] を クリックして設定ダイアログを閉じ、[ 閉じる ] をクリックして [ NuGet パッケージの管理 ] ダイアログ ボックスを閉じます。

  9. Visual Studio でソリューションをビルドします。

課金アダプターのサンプルの実行

課金アダプターのサンプルは、コンソール アプリケーションまたは Windows サービスとして実行できます。

ビルド出力ディレクトリ (通常はプロジェクト フォルダーの bin\Debug または bin\Release の下) を別の場所にコピーし、運用環境の設定に従ってこの場所の app.config を編集することをお勧めします。 ビルド出力を別の場所にコピーすると、将来のビルドで app.config の変更が上書きされるのを防ぐことができます。 また、課金アダプター システム固有のアセンブリが、すべての依存関係 (またはグローバル アセンブリ キャッシュに登録) を含む同じフォルダーに配置されていることを確認します。 app.config ファイルの詳細については、「 Billing Adapter Core Engine サンプル ファイルについて」を参照してください。

課金アダプターは、Windows イベント ログ チャネルにトレース メッセージを出力します。 このチャネルは、使用する前に登録する必要があります。 チャネルを登録するには、registerlog 引数を使用して課金アダプター実行可能ファイルを呼び出します。 たとえば、registerlog Microsoft.WindowsAzurePack.Samples.Billing.exe します。

コンソール アプリケーションとして課金アダプターを実行するには

  1. コマンド プロンプトを開きます。

  2. 出力フォルダーの registerlog 引数を使用して Microsoft.WindowsAzurePack.Samples.Billing.exe を実行します (通常は、プロジェクト フォルダーの bin\Debug または bin\Release の下)。

課金アダプターを Windows サービスとして実行するには

  1. コマンド プロンプトを開きます。

  2. registerlog パラメーターを使用して Microsoft.WindowsAzurePack.Samples.Billing.exe を実行します。

  3. 課金アダプター フォルダーで、サービスの実行に使用するアカウントに読み取り & 実行アクセス許可を付与します。

  4. 課金アダプターを Windows サービスとして登録します。 課金アダプターの実行可能ファイルを Windows サービスとして登録する場合は、"service" 引数 (Microsoft.WindowsAzurePack.Samples.Billing.exe サービス) を指定する必要があります。

  5. Windows サービスを起動します。

Windows サービスとして課金アダプター サンプルを実行するためのスクリプト

次のスクリプトは、Windows サービスとして課金アダプター サンプルを実行する方法を示しています

# \"Install\" the billing adapter (creates the event log channel where the service will log events)
<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog

# Give permissions to the account running the service to access the folder where it is installed and run the executable
icacls <Path to Sample Build Location>/T /grant "NT AUTHORITY\NETWORK SERVICE:(RX)"

# Create (register) the service to be run on startup using the account given access above.
sc create wapbill start= auto binPath= "<Path to Sample Build Location>\Microsoft.WindowsAzurePack.Samples.Billing.exe service" obj= "NT AUTHORITY\NetworkService" DisplayName= "Azure Pack Billing Adapter"

# start the service
sc start wapbill

参照

課金アダプターコア エンジンのサンプル ファイルについて
Windows Azure Pack 課金アダプターのサンプル