Поделиться через

Создание и запуск примера адаптера выставления счетов

  • Статья

 

Область применения: Windows Azure Pack

Пример адаптера выставления счетов предоставляется в составе комплекта средств разработчика для Windows Azure Pack, доступных по адресу https://www.microsoft.com/en-us/download/details.aspx?id=41146. В следующем разделе показано, как выполнить сборку и запуск примера в качестве консольного приложения или службы Windows. Также предоставляется скрипт, показывающий, как запустить пример в качестве службы Windows.

Примечание

При первом запуске адаптера выставления счетов может потребоваться некоторое время, чтобы использовать все исторические данные в API использования пакета Windows Azure. Если требуется использовать много событий, функции клиента должны быть временно отключены, чтобы избежать проблем с синхронизацией. Если этого не сделать, некоторые операции покупки могут быть заблокированы пользователями, если зависимые события не были обработаны в системе выставления счетов во время покупки. Это можно сделать, остановив пулы приложений или службы сайта TenantSite, TenantAPI и TenantPublicAPI.

Создание примера адаптера выставления счетов

Создание примера адаптера выставления счетов

  1. Извлеките ZIP-файл пакета разработчика Windows Azure Pack в папку.

  2. В извлеченной папке найдите решение Адаптера выставления счетов Visual Studio Microsoft.WindowsAzurePack.Samples.Billing.sln в папке BillingAdapter.

  3. Откройте файл решения (.sln) в Visual Studio.

  4. Убедитесь, что установлена последняя версия установщика пакетов NuGet, выбрав пункт меню Сервис, а затем Расширения и Обновления. В появившемся диалоговом окне выберите Online и Visual Studio Gallery , чтобы узнать, есть ли обновление для диспетчера пакетов NuGet. Если он есть, установите его.

    Если диспетчер пакетов NuGet не установлен, см. раздел https://www.nuget.org/.

  5. Откройте диалоговое окно параметров установщика пакетов NuGet, чтобы убедиться, что необходимые пакеты скачиваются автоматически. Для этого выберите меню Сервис , Диспетчер пакетов библиотеки, Управление пакетами NuGet для решения.... Откроется диалоговое окно Управление пакетами NuGet . Щелкните Параметры, чтобы открыть диалоговое окно Параметры .

  6. Выберите Диспетчер пакетов , а затем — Общие.

  7. В разделе Восстановление пакетов установите флажок Разрешить NuGet скачивать отсутствующие пакеты и Автоматически проверка отсутствующих пакетов во время сборки в Visual Studio.

  8. Нажмите кнопку ОК , чтобы закрыть диалоговое окно параметров, а затем нажмите кнопку Закрыть , чтобы закрыть диалоговое окно Управление пакетами NuGet .

  9. Постройте решение в Visual Studio.

Запуск примера адаптера выставления счетов

Пример адаптера выставления счетов можно запускать как консольное приложение, так и как служба Windows.

Рекомендуется скопировать выходной каталог сборки (обычно в папке bin\Debug или bin\Release в папке проекта) в другое расположение и изменить app.config в этом расположении в соответствии с параметрами рабочей среды. Копирование выходных данных сборки в другое расположение не позволит будущим сборкам перезаписывать изменения app.config. Кроме того, убедитесь, что сборка конкретной системы адаптера выставления счетов находится в той же папке, включая все ее зависимости (или зарегистрированную в глобальном кэше сборок). Дополнительные сведения о файле app.config см. в разделе О примерах файлов ядра адаптера выставления счетов.

Адаптер выставления счетов отправляет сообщения трассировки в канал журнала событий Windows. Этот канал необходимо зарегистрировать, прежде чем его можно будет использовать. Чтобы зарегистрировать канал, вызовите исполняемый файл адаптера выставления счетов с аргументом registerlog. Например, Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog.

Запуск адаптера выставления счетов в качестве консольного приложения

  1. Откройте командную строку.

  2. Запустите Microsoft.WindowsAzurePack.Samples.Billing.exe с аргументом registerlog из выходной папки (обычно в папке проекта bin\Debug или bin\Release).

Запуск адаптера выставления счетов в качестве службы Windows

  1. Откройте окно командной строки.

  2. Выполните Microsoft.WindowsAzurePack.Samples.Billing.exe с параметром registerlog.

  3. В папке адаптера выставления счетов предоставьте разрешения на чтение & выполнение учетной записи, которая будет использоваться для запуска службы.

  4. Зарегистрируйте адаптер выставления счетов в качестве службы Windows. При регистрации исполняемого файла адаптера выставления счетов в качестве службы Windows необходимо указать аргумент "служба": 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