Compartilhar via

Como criar e executar o exemplo do adaptador de cobrança

  • Artigo

 

Aplica-se a: Pacote do Windows Azure

O exemplo do adaptador de cobrança é fornecido como parte dos exemplos do Kit de Desenvolvedores do Windows Azure Pack disponíveis em https://www.microsoft.com/en-us/download/details.aspx?id=41146. O tópico a seguir demonstra como criar e executar o exemplo como um aplicativo de console ou como um Serviço do Windows. Um script também é fornecido mostrando como executar o exemplo como um Serviço windows.

Observação

Quando o Adaptador de Cobrança é iniciado pela primeira vez, pode demorar um pouco para consumir todos os dados históricos na API de Uso do Pacote do Azure do Windows. Se houver muitos eventos a serem consumidos, os recursos do locatário deverão ser temporariamente desabilitados para evitar problemas de sincronização. Se isso não for feito, os usuários poderão ter algumas de suas operações de compra bloqueadas se os eventos dependentes não tiverem sido processados no sistema de cobrança no momento da compra. Isso pode ser feito interrompendo os pools de aplicativos ou serviços de site do TenantSite, TenantAPI e TenantPublicAPI.

Compilando o exemplo do adaptador de cobrança

Para criar o exemplo do Adaptador de Cobrança

  1. Extraia o arquivo zip do kit de desenvolvedores do Windows Azure Pack para uma pasta.

  2. Na pasta extraída, localize a solução do Visual Studio do Adaptador de Cobrança Microsoft.WindowsAzurePack.Samples.Billing.sln na pasta BillingAdapter.

  3. Abra o arquivo de solução (.sln) no Visual Studio.

  4. Verifique se o Instalador de Pacote NuGet mais recente está instalado selecionando a opção de menu Ferramentas e, em seguida, Extensões e Atualizações. Na caixa de diálogo exibida, selecione Online e Galeria do Visual Studio para ver se há uma atualização para o Gerenciador de Pacotes NuGet. Se houver, instale-o.

    Se o Gerenciador de Pacotes NuGet não estiver instalado, consulte https://www.nuget.org/.

  5. Abra a caixa de diálogo Opções do instalador do Pacote NuGet para garantir que os pacotes necessários sejam baixados automaticamente. Faça isso selecionando o menu Ferramentas , Gerenciador de Pacotes de Biblioteca, Gerenciar Pacotes Nuget para Solução.... A caixa de diálogo Gerenciar Pacotes NuGet será exibida. Clique em Configurações para abrir a caixa de diálogo Opções .

  6. Selecione Gerenciador de Pacotes e, em seguida, Geral.

  7. Na seção Restauração de Pacote, verifique se Permitir que o Nuget baixe pacotes ausentes e Marcar automaticamente para pacotes ausentes durante a compilação no Visual Studio.

  8. Clique em OK para fechar a caixa de diálogo de configurações e clique em Fechar para fechar a caixa de diálogo Gerenciar Pacotes NuGet .

  9. Compile a solução no Visual Studio.

Executando o exemplo do adaptador de cobrança

O exemplo do adaptador de cobrança pode ser executado como um aplicativo de console ou como um Serviço windows.

É recomendável copiar o diretório de saída de build (geralmente em bin\Debug ou bin\Release na pasta do projeto) para um local diferente e editar o app.config nesse local de acordo com as configurações do ambiente de produção. Copiar as saídas de build para um local diferente impedirá que builds futuros substituam suas alterações de app.config. Verifique também se o assembly específico do sistema do adaptador de cobrança está localizado na mesma pasta, incluindo todas as suas dependências (ou registrado no Cache de Assembly Global). Para obter mais informações sobre o arquivo app.config, consulte Sobre os arquivos de exemplo do mecanismo principal do adaptador de cobrança.

O adaptador de cobrança emite mensagens de rastreamento para um canal do Log de Eventos do Windows. Esse canal deve ser registrado antes de ser usado. Para registrar o canal, invoque o executável do adaptador de cobrança com o argumento registerlog. Por exemplo, Microsoft.WindowsAzurePack.Samples.Billing.exe registerlog.

Para executar o adaptador de cobrança como um aplicativo de console

  1. Abra um prompt de comando

  2. Execute Microsoft.WindowsAzurePack.Samples.Billing.exe com o argumento registerlog da pasta de saída (geralmente em bin\Debug ou bin\Release na pasta do projeto).

Para executar o adaptador de cobrança como um serviço windows

  1. Abra um prompt de comando.

  2. Execute Microsoft.WindowsAzurePack.Samples.Billing.exe com o parâmetro registerlog.

  3. Na pasta do adaptador de cobrança, conceda permissões de Leitura & Executar à conta que será usada para executar o serviço.

  4. Registre o adaptador de cobrança como um serviço do Windows. Ao registrar o executável do adaptador de cobrança como um serviço windows, é necessário fornecer o argumento "serviço": Microsoft.WindowsAzurePack.Samples.Billing.exe serviço.

  5. Inicie o Serviço windows.

Script para executar o exemplo do adaptador de cobrança como um serviço windows

O script a seguir demonstra como executar o Exemplo do Adaptador de Cobrança como um Serviço 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

Consulte Também

Sobre os arquivos de exemplo do mecanismo principal do adaptador de cobrança
O exemplo do Adaptador de Cobrança do Pacote do Windows Azure