Walidowanie stanu systemu usługi Azure Stack Hub
Jako operator usługi Azure Stack Hub niezbędne jest określenie kondycji i stanu systemu na żądanie. Narzędzie do sprawdzania poprawności usługi Azure Stack Hub (Test-AzureStack)) to polecenie cmdlet programu PowerShell, które umożliwia uruchamianie serii testów w systemie w celu zidentyfikowania błędów w razie wystąpienia. Zazwyczaj podczas kontaktowania się z pomocą działu obsługi klienta firmy Microsoft (pomoc techniczna firmy Microsoft) skontaktujesz się z działem pomocy technicznej firmy Microsoft za pośrednictwem uprzywilejowanego punktu końcowego (PEP). Mając pod ręką informacje o kondycji i stanie całego systemu, pomoc techniczna firmy Microsoft mogą zbierać i analizować szczegółowe dzienniki, skoncentrować się na obszarze, w którym wystąpił błąd, i pracować z Tobą, aby rozwiązać ten problem.
Uruchamianie narzędzia walidacji i uzyskiwanie dostępu do wyników
Aby uruchomić narzędzie do walidacji, możesz użyć pep. Uruchomienie narzędzia może trochę potrwać. Długość czasu zależy od liczby maszyn wirtualnych w systemie. Każdy test zwraca stan PASS/FAIL w oknie programu PowerShell.
Oto konspekt kompleksowego procesu testowania poprawności:
Ustanów relację zaufania. W zintegrowanym systemie uruchom następujące polecenie z sesji programu Windows PowerShell z podwyższonym poziomem uprawnień, aby dodać pep jako zaufany host na maszynie wirtualnej ze wzmocnionymi zabezpieczeniami uruchomionymi na hoście cyklu życia sprzętu lub stacji roboczej z dostępem uprzywilejowanym.
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'Jeśli używasz zestawu Azure Stack Development Kit (ASDK), zaloguj się do hosta zestawu deweloperskiego.
Uzyskaj dostęp do pepu. Uruchom następujące polecenia, aby ustanowić sesję PEP:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcredNapiwek
Aby uzyskać dostęp do pep na komputerze hosta zestawu Azure Stack Development Kit (ASDK), użyj polecenia AzS-ERCS01 dla parametru -ComputerName.
Po przejściu do pepu uruchom polecenie:
Test-AzureStackAby uzyskać więcej informacji, zobacz Zagadnienia dotyczące parametrów i Przykłady przypadków użycia.
Jeśli jakikolwiek raport testów kończy się niepowodzeniem, uruchom polecenie
Get-AzureStackLog. Aby uzyskać instrukcje dotyczące zintegrowanego systemu, zobacz, jak uruchomić polecenie Get-AzureStackLog w zintegrowanych systemach usługi Azure Stack Hub.Polecenie cmdlet zbiera dzienniki generowane przez narzędzie Test-AzureStack. Zalecamy, aby nie zbierać dzienników i kontaktować się z pomoc techniczna firmy Microsoft zamiast tego, jeśli raport testów OSTRZEGA.
Jeśli poinstruujesz uruchomienie narzędzia sprawdzania poprawności przez pomoc techniczna firmy Microsoft, przedstawiciel pomoc techniczna firmy Microsoft zażąda zebranych dzienników, aby kontynuować rozwiązywanie problemu.
Dostępne testy
Narzędzie do sprawdzania poprawności umożliwia uruchamianie serii testów na poziomie systemu i podstawowych scenariuszy chmury, które zapewniają wgląd w bieżący stan, umożliwiając rozwiązywanie problemów w systemie.
Testy infrastruktury chmury
Te testy o niskim wpływie działają na poziomie infrastruktury i dostarczają informacje na temat różnych składników i funkcji systemowych. Obecnie testy są pogrupowane w następujące kategorie:
| Kategoria testu | Argument dla -Include i -Ignore |
|---|---|
| Podsumowanie usługi Azure Stack Hub ACS | AzsAcsSummary |
| Stan planu działania usługi Azure Stack Hub | AzsActionPlanStatus |
| Kondycja agenta usługi Azure Stack Hub | AzsAgentHealth |
| Podsumowanie wersji zapoznawczej usługi Azure Stack AKS Arc | AzsAksArcPreviewSummary |
| Podsumowanie usługi Active Directory w usłudze Azure Stack Hub | AzsAdSummary |
| Podsumowanie alertów usługi Azure Stack Hub | AzsAlertSummary |
| Podsumowanie awarii aplikacji usługi Azure Stack Hub | AzsApplicationCrashSummary |
| Podsumowanie ułatwień dostępu udziału kopii zapasowych usługi Azure Stack Hub | AzsBackupShareAccessibility |
| Podsumowanie płaszczyzny sterowania usługi Azure Stack Hub | AzsControlPlane |
| Walidacja dcB usługi Azure Stack Hub | AzsDCBValidation |
| Podsumowanie usługi Azure Stack Hub Defender | AzsDefenderSummary |
| Stan aprowizacji usługi Azure Stack Hub ECE | AzsEceProvisioningStatus |
| Podsumowanie certyfikatów zewnętrznych usługi Azure Stack Hub | AzsExternalCertificates |
| Podsumowanie konfiguracji procesora GPU usługi Azure Stack Hub | AzsGpuConfigurationSummary |
| Włączanie monitora sprzętowego usługi Azure Stack Hub | AzsGpuConfigurationSummary |
| Podsumowanie oprogramowania układowego infrastruktury hostingowej usługi Azure Stack Hub | AzsHostingInfraFWSummary |
| Podsumowanie infrastruktury hostingu usługi Azure Stack Hub | AzsHostingInfraSummary |
| Wykorzystanie infrastruktury hostingu w usłudze Azure Stack Hub | AzsHostingInfraUfile |
| Łączność dostawcy tożsamości usługi Azure Stack Hub | AzsIdentityProviderConnectivity |
| Stan dostawcy tożsamości usługi Azure Stack Hub | AzsIdentityProviderStatus |
| Pojemność infrastruktury usługi Azure Stack Hub | AzsInfraCapacity |
| Walidacja pliku infrastruktury usługi Azure Stack Hub | AzsInfraFileValidation |
| Wydajność infrastruktury usługi Azure Stack Hub | AzsInfraPerformance |
| Podsumowanie roli infrastruktury usługi Azure Stack Hub | AzsInfraRoleSummary |
| Pamięć aktualizacji infrastruktury usługi Azure Stack Hub | AzsInfraUpdateMemory |
| Podsumowanie aktualizacji infrastruktury usługi Azure Stack Hub | AzsInfraUpdateSummary |
| Walidacja NCImos w usłudze Azure Stack Hub | AzsNCImosValidation |
| Infrastruktura sieci usługi Azure Stack Hub | AzsNetworkInfra |
| Sprzęt OEM usługi Azure Stack Hub | AzsOemHardware |
| Wymagania wstępne aktualizacji producenta OEM usługi Azure Stack Hub | AzsOemUpdatePrereqs |
| Portal usługi Azure Stack Hub i podsumowanie interfejsu API | AzsPortalAPISummary |
| Stan operacyjny RDMA usługi Azure Stack Hub | AzsRdmaOperationalStatus |
| Stan uwierzytelniania dostawcy zasobów usługi Azure Stack Hub | AzsResourceProviderAuthStatus |
| Zdarzenia maszyny wirtualnej jednostki skalowania usługi Azure Stack Hub | AzsScaleUnitEvents |
| Zasoby maszyn wirtualnych jednostki skalowania usługi Azure Stack Hub | AzsScaleUnitResources |
| Scenariusze usługi Azure Stack Hub | AzsScenarios |
| Podsumowanie roli usługi Service Fabric w usłudze Azure Stack Hub | AzsSFRoleSummary |
| Diagnostyka SQL usługi Azure Stack Hub | AzsSQLDiagnostics |
| Podsumowanie SQL usługi Azure Stack Hub | AzsSQLSummary |
| Podsumowanie kontrolera BMC sygnatury usługi Azure Stack Hub | AzsStampBMCSummary |
| Płaszczyzna danych magazynu usługi Azure Stack Hub | AzsStorageDataPlane |
| Podsumowanie usług Azure Stack Hub Storage | AzsStorageSvcsSummary |
| Podsumowanie magazynu SQL usługi Azure Stack Hub | AzsStoreSummary |
| Podsumowanie użycia usługi Azure Stack Hub | AzsUsage |
| Podsumowanie mostka użycia usługi Azure Stack Hub | AzsUsageBridgeSummary |
| Podsumowanie umieszczania maszyn wirtualnych w usłudze Azure Stack Hub | AzsVmPlacement |
Testy scenariuszy w chmurze
Oprócz testów infrastruktury w poprzedniej sekcji można również uruchamiać testy scenariuszy w chmurze, aby sprawdzić funkcje między składnikami infrastruktury. Poświadczenia administratora chmury są wymagane do uruchomienia tych testów, ponieważ obejmują one wdrożenie zasobów.
Uwaga
Obecnie nie można uruchamiać testów scenariuszy w chmurze przy użyciu poświadczeń usług Federacyjnych Active Directory (AD FS).
Następujące scenariusze w chmurze są testowane przez narzędzie do sprawdzania poprawności:
- Tworzenie grupy zasobów
- Tworzenie planu
- Tworzenie oferty
- Tworzenie konta magazynu
- Tworzenie maszyny wirtualnej
- Operacja magazynu obiektów blob
- Operacja magazynu kolejek
- Operacja magazynu tabel
Zagadnienia dotyczące parametrów
Lista parametrów może służyć do wyświetlania wszystkich dostępnych kategorii testów.
Parametry Uwzględnij i Ignoruj mogą służyć do dołączania lub wykluczania kategorii testów. Aby uzyskać więcej informacji na temat tych argumentów, zobacz następującą sekcję.
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformanceMaszyna wirtualna dzierżawy jest wdrażana w ramach testów scenariusza chmury. Aby wyłączyć to wdrożenie maszyny wirtualnej, możesz użyć polecenia DoNotDeployTenantVm .
Należy podać parametr ServiceAdminCredential, aby uruchomić testy scenariuszy w chmurze zgodnie z opisem w sekcji Przykłady przypadków użycia.
Funkcja BackupSharePath i BackupShareCredential są używane podczas testowania ustawień kopii zapasowej infrastruktury, jak pokazano w sekcji Przykłady przypadków użycia.
Funkcja DetailedResults może służyć do uzyskiwania informacji o powodzeniu/niepomyślnym/ostrzegawczym dla każdego testu, a także ogólnego przebiegu. Jeśli nie zostanie określony, funkcja Test-AzureStack zwraca $true , jeśli nie występują błędy, i $false , jeśli występują błędy.
Limity czasuSeconds mogą służyć do ustawiania określonego czasu dla każdej grupy do ukończenia.
Narzędzie sprawdzania poprawności obsługuje również typowe parametry programu PowerShell: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable i OutVariable. Aby uzyskać więcej informacji, zobacz About Common Parameters (Informacje o typowych parametrach).
Przykłady zastosowania
Uruchamianie walidacji bez scenariuszy chmury
Uruchom narzędzie sprawdzania poprawności bez parametru ServiceAdminCredential , aby pominąć uruchamianie testów scenariuszy w chmurze:
New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack
Uruchamianie walidacji przy użyciu scenariuszy chmury
Podanie narzędzia do sprawdzania poprawności za pomocą parametru ServiceAdminCredentials domyślnie uruchamia testy scenariusza w chmurze:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"
Jeśli chcesz uruchamiać tylko scenariusze w chmurze bez uruchamiania pozostałych testów, możesz użyć parametru Include , aby to zrobić:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios
Nazwa użytkownika administratora chmury musi być wpisana w formacie UPN: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID). Po wyświetleniu monitu wpisz hasło do konta administratora chmury.
Grupy
Aby poprawić środowisko operatora, parametr Grupy został włączony do uruchamiania wielu kategorii testów jednocześnie. Obecnie zdefiniowano trzy grupy: Default, UpdateReadiness i SecretRotationReadiness.
Ustawienie domyślne: uważane za standardowy przebieg test-AzureStack. Ta grupa jest domyślnie uruchamiana, jeśli nie wybrano żadnych innych grup.
UpdateReadiness: Sprawdź, czy można zaktualizować wystąpienie usługi Azure Stack Hub. Po uruchomieniu grupy UpdateReadiness ostrzeżenia są wyświetlane jako błędy w danych wyjściowych konsoli i powinny być traktowane jako blokady aktualizacji. Następujące kategorie są częścią grupy UpdateReadiness :
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: Sprawdzanie, czy wystąpienie usługi Azure Stack Hub jest w stanie, w którym można uruchomić rotację wpisów tajnych. Po uruchomieniu grupy SecretRotationReadiness ostrzeżenia są wyświetlane jako błędy w danych wyjściowych konsoli i powinny być traktowane jako elementy blokujące rotację wpisów tajnych. Następujące kategorie są częścią grupy SecretRotationReadiness:
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary
Przykład parametru grupy
Poniższy przykład uruchamia narzędzie Test-AzureStack, aby przetestować gotowość systemu przed zainstalowaniem aktualizacji lub poprawki przy użyciu grupy. Przed rozpoczęciem instalacji aktualizacji lub poprawki uruchom polecenie Test-AzureStack , aby sprawdzić stan usługi Azure Stack Hub:
Test-AzureStack -Group UpdateReadiness
Uruchamianie narzędzia do sprawdzania poprawności w celu testowania ustawień kopii zapasowej infrastruktury
Przed skonfigurowaniem kopii zapasowej infrastruktury można przetestować ścieżkę i poświadczenia udziału kopii zapasowej przy użyciu testu AzsBackupShareAccessibility :
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred
Po skonfigurowaniu kopii zapasowej można uruchomić polecenie AzsBackupShareAccessibility , aby sprawdzić, czy udział jest dostępny z poziomu ERCS:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility
Aby przetestować nowe poświadczenia za pomocą skonfigurowanego udziału kopii zapasowej, uruchom polecenie:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"
Uruchamianie narzędzia sprawdzania poprawności w celu testowania infrastruktury sieciowej
Ten test sprawdza łączność infrastruktury sieciowej, pomijając sieć zdefiniowaną przez oprogramowanie usługi Azure Stack Hub (SDN). Demonstruje łączność z publicznego adresu VIP do skonfigurowanych usług przesyłania dalej DNS, serwerów NTP i punktów końcowych uwierzytelniania. Obejmuje to łączność z platformą Azure w przypadku korzystania z identyfikatora Entra firmy Microsoft jako dostawcy tożsamości lub serwera federacyjnego w przypadku korzystania z usług AD FS jako dostawcy tożsamości.
Dołącz parametr debugowania, aby uzyskać szczegółowe dane wyjściowe polecenia:
Test-AzureStack -Include AzsNetworkInfra -Debug
Następne kroki
Aby dowiedzieć się więcej na temat narzędzi diagnostycznych usługi Azure Stack Hub i rejestrowania problemów, zobacz Zbieranie dzienników diagnostycznych usługi Azure Stack Hub.
Aby dowiedzieć się więcej na temat rozwiązywania problemów, zobacz Rozwiązywanie problemów z usługą Microsoft Azure Stack Hub.