Jak skompilować i uruchomić przykład karty rozliczeniowej
Dotyczy: Pakiet Windows Azure Pack
Przykład karty rozliczeniowej jest dostarczany jako część przykładów zestawu Windows Azure Pack Developer Kit dostępnych pod adresem https://www.microsoft.com/en-us/download/details.aspx?id=41146. W poniższym temacie pokazano, jak skompilować i uruchomić przykład jako aplikację konsolową lub usługę systemu Windows. Udostępniono również skrypt pokazujący sposób uruchamiania przykładu jako usługa systemu Windows.
Uwaga
Po pierwszym uruchomieniu karty rozliczeniowej może upłynąć trochę czasu, aby korzystać ze wszystkich danych historycznych w interfejsie API użycia pakietu Windows Azure Pack. Jeśli istnieje wiele zdarzeń do korzystania, funkcje dzierżawy powinny być tymczasowo wyłączone, aby uniknąć problemów z synchronizacją. Jeśli nie zostanie to zrobione, użytkownicy mogą zablokować niektóre operacje zakupu, jeśli zdarzenia zależne nie zostały przetworzone w systemie rozliczeniowym w momencie zakupu. Można to zrobić, zatrzymując pule aplikacji lub usługi lokacji w witrynie TenantSite, TenantAPI i TenantPublicAPI.
Tworzenie przykładu karty rozliczeniowej
Aby utworzyć przykład karty rozliczeniowej
Wyodrębnij plik zip zestawu deweloperów pakietu Windows Azure Pack do folderu.
W wyodrębnionym folderze znajdź rozwiązanie Visual Studio adaptera rozliczeniowego Microsoft.WindowsAzurePack.Samples.Billing.sln w folderze BillingAdapter.
Otwórz plik rozwiązania (.sln) w programie Visual Studio.
Upewnij się, że zainstalowano najnowszą wersję Instalatora pakietów NuGet, wybierając opcję menu Narzędzia, a następnie pozycję Rozszerzenia i Aktualizacje. W wyświetlonym oknie dialogowym wybierz pozycję Online , a następnie pozycję Galeria programu Visual Studio , aby sprawdzić, czy istnieje aktualizacja Menedżera pakietów NuGet. Jeśli tak jest, zainstaluj ją.
Jeśli menedżer pakietów NuGet nie jest zainstalowany, zobacz https://www.nuget.org/.
Otwórz okno dialogowe Opcje instalatora pakietu NuGet, aby upewnić się, że wymagane pakiety są pobierane automatycznie. W tym celu wybierz menu Narzędzia , Menedżer pakietów biblioteki, Zarządzaj pakietami Nuget dla rozwiązania.... Zostanie wyświetlone okno dialogowe Zarządzanie pakietami NuGet . Kliknij pozycję Ustawienia , aby otworzyć okno dialogowe Opcje .
Wybierz pozycję Menedżer pakietów , a następnie pozycję Ogólne.
W sekcji Przywracanie pakietów upewnij się, że opcja Zezwalaj nuget na pobieranie brakujących pakietów i sprawdź, czy nie ma brakujących pakietów podczas kompilacji w programie Visual Studio , jest zaznaczona.
Kliknij przycisk OK , aby zamknąć okno dialogowe ustawień, a następnie kliknij przycisk Zamknij , aby zamknąć okno dialogowe Zarządzanie pakietami NuGet .
Skompiluj rozwiązanie w programie Visual Studio.
Uruchamianie przykładu karty rozliczeniowej
Przykład karty rozliczeniowej można uruchomić jako aplikację konsolową lub jako usługę systemu Windows.
Zaleca się skopiowanie katalogu wyjściowego kompilacji (zazwyczaj w obszarze bin\Debug lub bin\Release w folderze projektu) do innej lokalizacji i edytowanie app.config w tej lokalizacji zgodnie z ustawieniami środowiska produkcyjnego. Kopiowanie danych wyjściowych kompilacji do innej lokalizacji uniemożliwi przyszłym kompilacjom zastąpienie zmian app.config. Upewnij się również, że zestaw specyficzny dla systemu kart rozliczeniowych znajduje się w tym samym folderze, w tym we wszystkich jego zależnościach (lub zarejestrowanych w globalnej pamięci podręcznej zestawów). Aby uzyskać więcej informacji na temat pliku app.config, zobacz About the Billing Adapter Core Engine Sample Files (Informacje o plikach przykładowych aparatu karty sieciowej karty rozliczeniowej).
Karta rozliczeniowa emituje komunikaty śledzenia do kanału dziennika zdarzeń systemu Windows. Ten kanał należy zarejestrować, aby można było go użyć. Aby zarejestrować kanał, wywołaj plik wykonywalny adaptera rozliczeniowego za pomocą argumentu registerlog. Na przykład Microsoft.WindowsAzurePack.Samples.Billing.exe rejestrowanie.
Aby uruchomić kartę rozliczeń jako aplikację konsolową
Otwieranie wiersza polecenia
Uruchom Microsoft.WindowsAzurePack.Samples.Billing.exe z argumentem registerlog z folderu wyjściowego (zazwyczaj w folderze bin\Debug lub bin\Release).
Aby uruchomić kartę rozliczeń jako usługę systemu Windows
Otwórz wiersz polecenia.
Uruchom Microsoft.WindowsAzurePack.Samples.Billing.exe z parametrem registerlog.
W folderze karty rozliczeniowej przyznaj uprawnienia Odczyt & Wykonywanie na koncie, które będzie używane do uruchamiania usługi.
Zarejestruj kartę rozliczeń jako usługę systemu Windows. Podczas rejestrowania pliku wykonywalnego adaptera rozliczeniowego jako usługi systemu Windows należy podać argument "usługa": Microsoft.WindowsAzurePack.Samples.Billing.exe usługi.
Uruchom usługę systemu Windows.
Skrypt uruchamiania przykładu karty rozliczeniowej jako usługa systemu Windows
Poniższy skrypt pokazuje, jak uruchomić przykład karty rozliczeniowej jako usługa systemu 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
Zobacz też
Informacje o przykładowych plikach aparatu core adaptera rozliczeniowego
Przykład karty rozliczeniowej pakietu Windows Azure Pack