Walidowanie stanu systemu usługi Azure Stack Hub
Jako operator usługi Azure Stack Hub możliwość określenia kondycji i stanu systemu na żądanie jest niezbędna. 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, jeśli są obecne. Zazwyczaj podczas kontaktowania się z działem obsługi klienta firmy Microsoft (pomoc techniczna firmy Microsoft) w przypadku wystąpienia problemu jest wyświetlany monit o uruchomienie tego narzędzia 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, skupić 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 sprawdzania poprawności, możesz użyć pep. Uruchomienie narzędzia może trochę potrwać. Czas 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 z podwyższonym poziomem uprawnień Windows PowerShell, 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 pep. Uruchom następujące polecenia, aby ustanowić sesję PEP:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcredPorada
Aby uzyskać dostęp do pep na komputerze hosta zestawu Azure Stack Development Kit (ASDK), użyj polecenia AzS-ERCS01 dla parametru -ComputerName.
Po wejś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 test zgłasza niepowodzenie, 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 wygenerowane 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 w chmurze, 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ą informacji na temat różnych składników i funkcji systemowych. Obecnie testy są grupowane 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 zapasowej usługi Azure Stack Hub | AzsBackupShareAccessibility |
| Podsumowanie płaszczyzny sterowania usługi Azure Stack Hub | AzsControlPlane |
| Weryfikacja dcB w usłudze 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ętu usługi Azure Stack Hub | AzsGpuConfigurationSummary |
| Podsumowanie oprogramowania układowego infrastruktury hostingu usługi Azure Stack Hub | AzsHostingInfraFWSummary |
| Podsumowanie infrastruktury hostingu usługi Azure Stack Hub | AzsHostingInfraSummary |
| Wykorzystanie infrastruktury hostingu usługi Azure Stack Hub | AzsHostingInfraU module |
| Łą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 w usłudze 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 maszyny wirtualnej 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 sygnatury usługi Azure Stack Hub BMC | AzsStampBMCSummary |
| Płaszczyzna danych magazynu usługi Azure Stack Hub | AzsStorageDataPlane |
| Podsumowanie usług Magazynu w usłudze Azure Stack Hub | 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 w celu sprawdzenia funkcjonalności 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 Include and Ignore 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żawcy jest wdrażana w ramach testów scenariuszy w chmurze. 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 .
Elementy BackupSharePath i BackupShareCredential są używane podczas testowania ustawień kopii zapasowej infrastruktury, jak pokazano w sekcji Przykłady przypadków użycia .
Parametr DetailedResults może służyć do uzyskiwania informacji o powodzeniu/niepomyślnym/ostrzeżeniu 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 w przypadku wystąpienia awarii.
Limity czasuSeconds mogą służyć do ustawiania określonej godziny 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 przypadków użycia
Uruchamianie walidacji bez scenariuszy w chmurze
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 w chmurze
Podanie narzędzia do sprawdzania poprawności przy użyciu 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 (Tożsamość Microsoft Entra). 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 w tym samym czasie. Obecnie zdefiniowano trzy grupy: Default, UpdateReadiness i SecretRotationReadiness.
Wartość domyślna: uważa się za standardowy przebieg platformy Test-AzureStack. Ta grupa jest uruchamiana domyślnie, jeśli nie wybrano żadnych innych grup.
UpdateReadiness: Sprawdzanie, 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 blokady dla rotacji 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 polecenia Group. 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 przetestowania ustawień kopii zapasowej infrastruktury
Przed skonfigurowaniem kopii zapasowej infrastruktury możesz 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żesz uruchomić polecenie AzsBackupShareAccessibility , aby sprawdzić, czy udział jest dostępny z poziomu usługi 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 do sprawdzania poprawności w celu przetestowania infrastruktury sieciowej
Ten test sprawdza łączność infrastruktury sieciowej, pomijając sieć zdefiniowaną przez oprogramowanie usługi Azure Stack Hub (SDN). Demonstruje łączność z publicznym adresem 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 używania Tożsamość Microsoft Entra 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.