How to Build and Run the Billing Adapter Sample
Aplica-se a: Windows Azure Pack
O exemplo do adaptador de faturação é fornecido como parte dos exemplos do Windows Azure Pack Developer Kit disponíveis em https://www.microsoft.com/en-us/download/details.aspx?id=41146. O tópico seguinte demonstra como criar e executar o exemplo como uma aplicação de consola ou como um Serviço Windows. Também é fornecido um script que mostra como executar o exemplo como um Serviço Windows.
Nota
Quando o Adaptador de Faturação é iniciado pela primeira vez, pode demorar algum tempo a consumir todos os dados históricos na API de Utilização do Windows Azure Pack. Se existirem muitos eventos a consumir, as funcionalidades do inquilino devem ser temporariamente desativadas para evitar problemas de sincronização. Se isto não for feito, os utilizadores poderão ter algumas das operações de compra bloqueadas se os eventos dependentes não tiverem sido processados no sistema de faturação no momento da compra. Isto pode ser feito ao parar os conjuntos aplicacionais ou os serviços de site do TenantSite, TenantAPI e TenantPublicAPI.
Criar o Exemplo do Adaptador de Faturação
Para criar o Exemplo do Adaptador de Faturação
Extraia o ficheiro zip do kit de programador do Windows Azure Pack para uma pasta.
Na pasta extraída, localize a solução do Visual Studio do Adaptador de Faturação Microsoft.WindowsAzurePack.Samples.Billing.sln na pasta BillingAdapter.
Abra o ficheiro de solução (.sln) no Visual Studio.
Certifique-se de que o Instalador de Pacotes NuGet mais recente está instalado ao selecionar a opção de menu Ferramentas e, em seguida, Extensões e Atualizações. Na caixa de diálogo apresentada, selecione Online e, em seguida, Galeria do Visual Studio para ver se existe uma atualização para o Gestor de Pacotes NuGet. Se existir, instale-o.
Se o Gestor de Pacotes NuGet não estiver instalado, consulte https://www.nuget.org/.
Abra a caixa de diálogo Opções do instalador do Pacote NuGet para garantir que os pacotes necessários são transferidos automaticamente. Para tal, selecione o menu Ferramentas , Gestor de Pacotes de Bibliotecas, Gerir Pacotes Nuget para Solução.... Será apresentada a caixa de diálogo Gerir Pacotes NuGet . Clique em Definições para abrir a caixa de Diálogo Opções .
Selecione Gestor de Pacotes e, em seguida , Geral.
Na secção Restauro do Pacote , certifique-se de que a opção Permitir que o Nuget transfira pacotes em falta e Verifique automaticamente se existem pacotes em falta durante a compilação no Visual Studio .
Clique em OK para fechar a caixa de diálogo de definições e, em seguida, clique em Fechar para fechar a caixa de diálogo Gerir Pacotes NuGet .
Crie a solução no Visual Studio.
Executar o Exemplo do Adaptador de Faturação
O exemplo do adaptador de faturação pode ser executado como uma aplicação de consola ou como um Serviço Windows.
Recomenda-se que copie o diretório de saída da compilação (normalmente em bin\Debug or bin\Release na pasta do projeto) para uma localização diferente e edite o app.config nesta localização de acordo com as definições do ambiente de produção. Copiar as saídas da compilação para uma localização diferente impedirá que as compilações futuras substituam as suas alterações app.config. Certifique-se também de que a assemblagem específica do sistema do adaptador de faturação está localizada na mesma pasta, incluindo todas as respetivas dependências (ou registadas na Cache de Assemblagem Global). Para obter mais informações sobre o ficheiro app.config, veja About the Billing Adapter Core Engine Sample Files (Acerca dos Ficheiros de Exemplo do Motor Core do Adaptador de Faturação).
O adaptador de faturação emite mensagens de rastreio para um canal de Registo de Eventos do Windows. Este canal tem de ser registado antes de poder ser utilizado. Para registar o canal, invoque o executável do adaptador de faturação com o argumento registerlog. Por exemplo, Microsoft.WindowsAzurePack.Samples.Billing.exe registo.
Para Executar o Adaptador de Faturação como uma Aplicação de Consola
Abrir uma Linha de Comandos
Execute Microsoft.WindowsAzurePack.Samples.Billing.exe com o argumento registerlog da pasta de saída (normalmente, em bin\Debug ou bin\Release na pasta do projeto).
Para Executar o Adaptador de Faturação como um Serviço Windows
Abra uma Linha de Comandos.
Execute Microsoft.WindowsAzurePack.Samples.Billing.exe com o parâmetro registerlog.
Na pasta da placa de faturação, conceda permissões de Leitura & Executar à conta que será utilizada para executar o serviço.
Registe o adaptador de faturação como um serviço Windows. Ao registar o executável do adaptador de faturação como um serviço Windows, é necessário fornecer o argumento "serviço": Microsoft.WindowsAzurePack.Samples.Billing.exe serviço.
Inicie o Serviço Windows.
Script para Executar o Exemplo do Adaptador de Faturação como um Serviço Windows
O script seguinte demonstra como executar o Exemplo do Adaptador de Faturação 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
Acerca dos Ficheiros de Exemplo do Motor Principal do Adaptador de Faturação
Exemplo do Adaptador de Faturação do Windows Azure Pack