Azure Stack Hub 시스템 상태 유효성 검사

아티클
10/30/2024

Azure Stack Hub 운영자는 주문형 시스템의 상태 및 상태 확인할 수 있어야 합니다. Azure Stack Hub 유효성 검사 도구(Test-AzureStack)는 시스템에서 일련의 테스트를 실행하여 오류가 있는 경우 식별할 수 있는 PowerShell cmdlet입니다. 일반적으로 문제가 있는 Microsoft 고객 서비스 지원(Microsoft 지원)에 문의할 때 PEP(권한 있는 엔드포인트)를 통해 이 도구를 실행하라는 메시지가 표시됩니다. 시스템 차원의 상태 정보가 있으면 Microsoft 지원이 자세한 로그를 수집 및 분석하고 오류가 발생한 영역에 집중하여 문제를 해결할 수 있습니다.

유효성 검사 도구 실행 및 결과 액세스

PEP를 사용하여 유효성 검사 도구를 실행할 수 있습니다. 도구를 실행하는 데 시간이 걸릴 수 있습니다. 시간의 길이는 시스템의 가상 머신 수에 따라 달라집니다. 각 테스트는 PowerShell 창에 통과/실패 상태를 반환합니다.

엔드투엔드 유효성 검사 테스트 프로세스의 개요는 다음과 같습니다.

트러스트를 설정합니다. 통합 시스템에서 관리자 권한 Windows PowerShell 세션에서 다음 명령을 실행하여 하드웨어 수명 주기 호스트 또는 Privileged Access Workstation에서 실행되는 강화된 VM에서 PEP를 신뢰할 수 있는 호스트로 추가합니다.
```
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'
```
ASDK(Azure Stack Development Kit)를 실행 중인 경우 개발 키트 호스트에 로그인합니다.
PEP에 액세스합니다. 다음 명령을 실행하여 PEP 세션을 설정합니다.
```
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
```
팁

ASDK(Azure Stack Development Kit) 호스트 컴퓨터에서 PEP에 액세스하려면 -ComputerName에 AzS-ERCS01을 사용합니다.
PEP 세션에서 다음을 실행합니다.
```
Test-AzureStack
```
자세한 내용은 매개 변수 고려 사항 및 사용 사례 예제를 참조하세요.
테스트가 FAIL을 보고하는 경우 를 실행 Get-AzureStackLog합니다. 통합 시스템에 대한 지침은 Azure Stack Hub 통합 시스템에서 Get-AzureStackLog를 실행하는 방법을 참조하세요.

이 cmdlet은 Test-AzureStack에 의해 생성된 로그를 수집합니다. 테스트가 경고를 보고하는 경우 로그를 수집하지 않고 Microsoft 지원에 연락하는 것이 좋습니다.
Microsoft 지원의 요청에 따라 유효성 검사 도구를 실행하면 Microsoft 지원 담당자가 수집된 로그를 요청하여 문제를 계속 해결합니다.

사용 가능한 테스트

유효성 검사 도구를 사용하면 현재 상태에 대한 인사이트를 제공하는 일련의 시스템 수준 테스트 및 기본 클라우드 시나리오를 실행하여 시스템의 문제를 해결할 수 있습니다.

클라우드 인프라 테스트

이러한 낮은 영향 테스트는 인프라 수준에서 작동하며 다양한 시스템 구성 요소 및 기능에 대한 정보를 제공합니다. 현재 테스트는 다음 범주로 그룹화됩니다.

테스트 범주	-Include 및 -Ignore에 대한 인수
Azure Stack Hub ACS 요약	AzsAcsSummary
Azure Stack Hub 작업 계획 상태	AzsActionPlanStatus
Azure Stack Hub 에이전트 상태	AzsAgentHealth
Azure Stack AKS Arc 미리 보기 요약	AzsAksArcPreviewSummary
Azure Stack Hub Active Directory 요약	AzsAdSummary
Azure Stack Hub 경고 요약	AzsAlertSummary
Azure Stack Hub 애플리케이션 충돌 요약	AzsApplicationCrashSummary
Azure Stack Hub Backup 공유 접근성 요약	AzsBackupShareAccessibility
Azure Stack Hub 컨트롤 플레인 요약	AzsControlPlane
Azure Stack Hub DCB 유효성 검사	AzsDCBValidation
Azure Stack Hub Defender 요약	AzsDefenderSummary
Azure Stack Hub ECE 프로비저닝 상태	AzsEceProvisioningStatus
Azure Stack Hub 외부 인증서 요약	AzsExternalCertificates
Azure Stack Hub GPU 구성 요약	AzsGpuConfigurationSummary
Azure Stack Hub 하드웨어 모니터 사용	AzsGpuConfigurationSummary
Azure Stack Hub 호스팅 인프라 펌웨어 요약	AzsHostingInfraFWSummary
Azure Stack Hub 호스팅 인프라 요약	AzsHostingInfraSummary
Azure Stack Hub 호스팅 인프라 사용률	AzsHostingInfraUtilization
Azure Stack Hub ID 공급자 연결	AzsIdentityProviderConnectivity
Azure Stack Hub ID 공급자 상태	AzsIdentityProviderStatus
Azure Stack Hub 인프라 용량	AzsInfraCapacity
Azure Stack Hub 인프라 파일 유효성 검사	AzsInfraFileValidation
Azure Stack Hub 인프라 성능	AzsInfraPerformance
Azure Stack Hub 인프라 역할 요약	AzsInfraRoleSummary
Azure Stack Hub 인프라 업데이트 메모리	AzsInfraUpdateMemory
Azure Stack Hub 인프라 업데이트 요약	AzsInfraUpdateSummary
Azure Stack Hub NCImos 유효성 검사	AzsNCImosValidation
Azure Stack Hub 네트워크 인프라	AzsNetworkInfra
Azure Stack Hub OEM 하드웨어	AzsOemHardware
Azure Stack Hub OEM 업데이트 필수 구성 요소	AzsOemUpdatePrereqs
Azure Stack Hub 포털 및 API 요약	AzsPortalAPISummary
Azure Stack Hub RDMA 작동 상태	AzsRdmaOperationalStatus
Azure Stack Hub 리소스 공급자 인증 상태	AzsResourceProviderAuthStatus
Azure Stack Hub 배율 단위 VM 이벤트	AzsScaleUnitEvents
Azure Stack Hub 배율 단위 VM 리소스	AzsScaleUnitResources
Azure Stack Hub 시나리오	AzsScenarios
Azure Stack Hub Service Fabric 역할 요약	AzsSFRoleSummary
Azure Stack Hub SQL 진단	AzsSQLDiagnostics
Azure Stack Hub SQL 요약	AzsSQLSummary
Azure Stack Hub 스탬프 BMC 요약	AzsStampBMCSummary
Azure Stack Hub Storage 데이터 평면	AzsStorageDataPlane
Azure Stack Hub Storage 서비스 요약	AzsStorageSvcsSummary
Azure Stack Hub SQL Store 요약	AzsStoreSummary
Azure Stack Hub 사용 요약	AzsUsage
Azure Stack Hub 사용 브리지 요약	AzsUsageBridgeSummary
Azure Stack Hub VM 배치 요약	AzsVmPlacement

클라우드 시나리오 테스트

이전 섹션의 인프라 테스트 외에도 클라우드 시나리오 테스트를 실행하여 인프라 구성 요소 간에 기능을 검사 수 있습니다. 이러한 테스트를 실행하려면 리소스 배포가 포함되므로 클라우드 관리자 자격 증명이 필요합니다.

참고

현재 AD FS(Active Directory Federated Services) 자격 증명을 사용하여 클라우드 시나리오 테스트를 실행할 수 없습니다.

다음 클라우드 시나리오는 유효성 검사 도구에서 테스트됩니다.

리소스 그룹 만들기
계획 만들기
제품 만들기
스토리지 계정 만들기
VM(가상 머신 만들기)
Blob Storage 작업
큐 스토리지 작업
테이블 스토리지 작업

매개 변수 고려 사항

매개 변수 목록을 사용하여 사용 가능한 모든 테스트 범주를 표시할 수 있습니다.
Include 및 Ignore 매개 변수를 사용하여 테스트 범주를 포함하거나 제외할 수 있습니다. 이러한 인수에 대한 자세한 내용은 다음 섹션을 참조하세요.
```
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity
```
```
Test-AzureStack -Ignore AzsInfraPerformance
```
테넌트 VM은 클라우드 시나리오 테스트의 일부로 배포됩니다. DoNotDeployTenantVm을 사용하여 이 VM 배포를 사용하지 않도록 설정할 수 있습니다.
사용 사례 예제 섹션에 설명된 대로 클라우드 시나리오 테스트를 실행하려면 ServiceAdminCredential 매개 변수를 제공해야 합니다.
BackupSharePath 및 BackupShareCredential 은 사용 사례 예제 섹션과 같이 인프라 백업 설정을 테스트할 때 사용됩니다.
DetailedResults를 사용하여 전체 실행뿐만 아니라 각 테스트에 대한 통과/실패/경고 정보를 가져올 수 있습니다. 지정하지 않으면 Test-AzureStack 은 오류가 없는 경우 $true 반환하고 오류가 있는 경우 $false .
TimeoutSeconds를 사용하여 각 그룹이 완료될 특정 시간을 설정할 수 있습니다.
유효성 검사 도구는 자세한 정보 표시, 디버그, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable 및 OutVariable과 같은 일반적인 PowerShell 매개 변수도 지원합니다. 자세한 내용은 일반 매개 변수 정보를 참조하세요.

사용 사례 예제

클라우드 시나리오 없이 유효성 검사 실행

ServiceAdminCredential 매개 변수 없이 유효성 검사 도구를 실행하여 클라우드 시나리오 테스트 실행을 건너뜁니다.

New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack

클라우드 시나리오를 사용하여 유효성 검사 실행

유효성 검사 도구에 ServiceAdminCredentials 매개 변수를 제공하면 기본적으로 클라우드 시나리오 테스트가 실행됩니다.

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"

나머지 테스트를 실행하지 않고 클라우드 시나리오만 실행하려는 경우 Include 매개 변수를 사용하여 다음을 수행할 수 있습니다.

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios

클라우드 관리자 사용자 이름은 UPN 형식 serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID)으로 입력해야 합니다. 메시지가 표시되면 클라우드 관리자 계정에 암호를 입력합니다.

그룹

운영자 환경을 개선하기 위해 그룹 매개 변수를 사용하여 여러 테스트 범주를 동시에 실행할 수 있습니다. 현재 세 개의 그룹이 정의되어 있습니다. 기본값, UpdateReadiness 및 SecretRotationReadiness.

기본값: Test-AzureStack의 표준 실행으로 간주됩니다. 다른 그룹이 선택되지 않은 경우 이 그룹은 기본적으로 실행됩니다.
UpdateReadiness: Azure Stack Hub instance 업데이트할 수 있는지 확인하는 검사. UpdateReadiness 그룹을 실행하면 경고가 콘솔 출력에 오류로 표시되며 업데이트의 방해 요소로 간주되어야 합니다. 다음 범주는 UpdateReadiness 그룹의 일부입니다.
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: Azure Stack Hub instance 비밀 회전을 실행할 수 있는 상태에 있는지 확인하는 검사. SecretRotationReadiness 그룹을 실행하면 경고가 콘솔 출력에 오류로 표시되며 비밀 회전의 차단기로 간주되어야 합니다. 다음 범주는 SecretRotationReadiness 그룹의 일부입니다.
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary

그룹 매개 변수 예제

다음 예제에서는 Group을 사용하여 업데이트 또는 핫픽스를 설치하기 전에 Test-AzureStack 을 실행하여 시스템 준비 상태를 테스트 합니다. 업데이트 또는 핫픽스 설치를 시작하기 전에 Test-AzureStack을 실행하여 Azure Stack Hub의 상태 검사.

Test-AzureStack -Group UpdateReadiness

유효성 검사 도구를 실행하여 인프라 백업 설정 테스트

인프라 백업을 구성하기 전에AzsBackupShareAccessibility 테스트를 사용하여 백업 공유 경로 및 자격 증명을 테스트할 수 있습니다.

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred

백업을 구성한 후AzsBackupShareAccessibility를 실행하여 ERCS에서 공유에 액세스할 수 있는지 확인할 수 있습니다.

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility

구성된 백업 공유를 사용하여 새 자격 증명을 테스트하려면 다음을 실행합니다.

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"

유효성 검사 도구를 실행하여 네트워크 인프라 테스트

이 테스트는 Azure Stack Hub SDN(소프트웨어 정의 네트워크)을 우회하는 네트워크 인프라의 연결을 확인합니다. 공용 VIP에서 구성된 DNS 전달자, NTP 서버 및 인증 엔드포인트로의 연결을 보여 줍니다. 여기에는 ID 공급자로 AD FS를 사용할 때 id 공급자 또는 페더레이션된 서버로 Microsoft Entra ID 사용할 때 Azure에 대한 연결이 포함됩니다.

명령의 자세한 출력을 얻으려면 디버그 매개 변수를 포함합니다.

Test-AzureStack -Include AzsNetworkInfra -Debug

다음 단계

Azure Stack Hub 진단 도구 및 문제 로깅에 대한 자세한 내용은 Azure Stack Hub 진단 로그 수집을 참조하세요.

문제 해결에 대한 자세한 내용은 Microsoft Azure Stack Hub 문제 해결을 참조하세요.

다음을 통해 공유