Validar o estado do sistema do Azure Stack Hub

Artigo
10/30/2024

Enquanto operador do Azure Stack Hub, ser capaz de determinar o estado de funcionamento e o estado do seu sistema a pedido é essencial. A ferramenta de validação do Azure Stack Hub (Test-AzureStack)) é um cmdlet do PowerShell que lhe permite executar uma série de testes no seu sistema para identificar falhas, se existirem. Normalmente, ser-lhe-á pedido para executar esta ferramenta através do ponto final privilegiado (PEP) quando contactar o Suporte ao Cliente da Microsoft (Suporte da Microsoft) com um problema. Com as informações de estado de funcionamento e estado em todo o sistema disponíveis, Suporte da Microsoft podem recolher e analisar registos detalhados, concentrar-se na área onde ocorreu o erro e trabalhar consigo para corrigir o problema.

Executar a ferramenta de validação e aceder aos resultados

Pode utilizar o PEP para executar a ferramenta de validação. A ferramenta pode demorar algum tempo a ser executada. O período de tempo depende do número de máquinas virtuais no seu sistema. Cada teste devolve um estado PASS/FAIL na janela do PowerShell.

Eis um resumo do processo de teste de validação ponto a ponto:

Estabeleça a confiança. Num sistema integrado, execute o seguinte comando a partir de uma sessão de Windows PowerShell elevada para adicionar o PEP como um anfitrião fidedigno na VM protegida em execução no anfitrião do ciclo de vida do hardware ou na Estação de Trabalho de Acesso Privilegiado.
```
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'
```
Se estiver a executar o Development Kit (ASDK) do Azure Stack, inicie sessão no anfitrião do development kit.
Aceda ao PEP. Execute os seguintes comandos para estabelecer uma sessão PEP:
```
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
```
Dica

Para aceder ao PEP num computador anfitrião do Azure Stack Development Kit (ASDK), utilize AzS-ERCS01 para -ComputerName.
Assim que estiver no PEP, execute:
```
Test-AzureStack
```
Para obter mais informações, veja Considerações sobre parâmetros e Exemplos de casos de utilização.
Se algum dos testes comunicar FAIL, execute Get-AzureStackLog. Para obter instruções sobre um sistema integrado, veja como executar Get-AzureStackLog em sistemas integrados do Azure Stack Hub.

O cmdlet recolhe registos gerados pelo Test-AzureStack. Recomendamos que não recolha registos e contacte Suporte da Microsoft se os testes comunicam AVISO.
Se lhe for pedido para executar a ferramenta de validação pela Suporte da Microsoft, o representante Suporte da Microsoft pedirá os registos que recolheu para continuar a resolver o problema.

Testes disponíveis

A ferramenta de validação permite-lhe executar uma série de testes ao nível do sistema e cenários básicos da cloud que lhe fornecem informações sobre o estado atual, permitindo-lhe corrigir problemas no seu sistema.

Testes de infraestrutura de cloud

Estes testes de baixo impacto funcionam ao nível da infraestrutura e fornecem-lhe informações sobre vários componentes e funções do sistema. Atualmente, os testes são agrupados nas seguintes categorias:

Categoria de Teste	Argumento para -Include e -Ignore
Resumo dos ACS do Azure Stack Hub	AzsAcsSummary
Estado do Plano de Ação do Azure Stack Hub	AzsActionPlanStatus
Estado de Funcionamento do Agente do Azure Stack Hub	AzsAgentHealth
Resumo da Pré-visualização do Azure Stack AKS Arc	AzsAksArcPreviewSummary
Resumo do Active Directory do Azure Stack Hub	AzsAdSummary
Resumo de Alertas do Azure Stack Hub	AzsAlertSummary
Resumo da Falha da Aplicação do Azure Stack Hub	AzsApplicationCrashSummary
Resumo da Acessibilidade da Partilha de Cópias de Segurança do Azure Stack Hub	AzsBackupShareAccessibility
Resumo do Plano de Controlo do Azure Stack Hub	AzsControlPlane
Validação do DCB do Azure Stack Hub	AzsDCBValidation
Resumo do Defender do Azure Stack Hub	AzsDefenderSummary
Estado de Aprovisionamento da ECE do Azure Stack Hub	AzsEceProvisioningStatus
Resumo de Certificados Externos do Azure Stack Hub	AzsExternalCertificates
Resumo de Configuração da GPU do Azure Stack Hub	AzsGpuConfigurationSummary
Ativar o Monitor de Hardware do Azure Stack Hub	AzsGpuConfigurationSummary
Resumo do Firmware da Infraestrutura de Alojamento do Azure Stack Hub	AzsHostingInfraFWSummary
Resumo da Infraestrutura de Alojamento do Azure Stack Hub	AzsHostingInfraSummary
Utilização da Infraestrutura de Alojamento do Azure Stack Hub	AzsHostingInfraUtilization
Conectividade do Fornecedor de Identidade do Azure Stack Hub	AzsIdentityProviderConnectivity
Estado do Fornecedor de Identidade do Azure Stack Hub	AzsIdentityProviderStatus
Capacidade de Infraestrutura do Azure Stack Hub	AzsInfraCapacity
Validação de Ficheiros da Infraestrutura do Azure Stack Hub	AzsInfraFileValidation
Desempenho da Infraestrutura do Azure Stack Hub	AzsInfraPerformance
Resumo da Função de Infraestrutura do Azure Stack Hub	AzsInfraRoleSummary
Memória de Atualização da Infraestrutura do Azure Stack Hub	AzsInfraUpdateMemory
Resumo da Atualização da Infraestrutura do Azure Stack Hub	AzsInfraUpdateSummary
Validação ncImos do Azure Stack Hub	AzsNCImosValidation
Infraestrutura de Rede do Azure Stack Hub	AzsNetworkInfra
Azure Stack Hub OEM Hardware	AzsOemHardware
Pré-requisitos de Atualização do OEM do Azure Stack Hub	AzsOemUpdatePrereqs
Portal do Azure Stack Hub e Resumo da API	AzsPortalAPISummary
Estado Operacional do RDMA do Azure Stack Hub	AzsRdmaOperationalStatus
Estado de Autenticação do Fornecedor de Recursos do Azure Stack Hub	AzsResourceProviderAuthStatus
Eventos de VM da Unidade de Escala do Azure Stack Hub	AzsScaleUnitEvents
Recursos da VM da Unidade de Escala do Azure Stack Hub	AzsScaleUnitResources
Cenários do Azure Stack Hub	AzsScenarios
Resumo da Função do Service Fabric do Azure Stack Hub	AzsSFRoleSummary
Diagnóstico do SQL do Azure Stack Hub	AzsSQLDiagnostics
Resumo do SQL do Azure Stack Hub	AzsSQLSummary
Resumo BMC do Carimbo de Selo do Azure Stack Hub	AzsStampBMCSummary
Plano de Dados de Armazenamento do Azure Stack Hub	AzsStorageDataPlane
Resumo dos Serviços de Armazenamento do Azure Stack Hub	AzsStorageSvcsSummary
Resumo do Arquivo SQL do Azure Stack Hub	AzsStoreSummary
Resumo de Utilização do Azure Stack Hub	AzsUsage
Resumo da Ponte de Utilização do Azure Stack Hub	AzsUsageBridgeSummary
Resumo do Posicionamento da VM do Azure Stack Hub	AzsVmPlacement

Testes de cenários na cloud

Além dos testes de infraestrutura na secção anterior, também pode executar testes de cenários na cloud para verificar a funcionalidade em componentes de infraestrutura. As credenciais de administrador da cloud são necessárias para executar estes testes porque envolvem a implementação de recursos.

Nota

Atualmente, não pode executar testes de cenários na cloud com credenciais dos Serviços Federados do Active Directory (AD FS).

Os seguintes cenários de cloud são testados pela ferramenta de validação:

Criação de grupos de recursos
Criação de planos
Criação de ofertas
Criação da conta de armazenamento
Criação de máquinas virtuais (VM)
Operação de armazenamento de blobs
Operação de armazenamento de filas
Operação de armazenamento de tabelas

Considerações sobre parâmetros

A Lista de parâmetros pode ser utilizada para apresentar todas as categorias de teste disponíveis.
Os parâmetros Incluir e Ignorar podem ser utilizados para incluir ou excluir categorias de teste. Para obter mais informações sobre estes argumentos, consulte a secção seguinte.
```
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity
```
```
Test-AzureStack -Ignore AzsInfraPerformance
```
Uma VM de inquilino é implementada como parte dos testes de cenário da cloud. Pode utilizar DoNotDeployTenantVm para desativar esta implementação de VM.
Tem de fornecer o parâmetro ServiceAdminCredential para executar testes de cenários na cloud, conforme descrito na secção Exemplos de casos de utilização .
O BackupSharePath e o BackupShareCredential são utilizados ao testar as definições de cópia de segurança da infraestrutura, conforme mostrado na secção Exemplos de casos de utilização.
DetailedResults pode ser utilizado para obter informações de passagem/falha/aviso para cada teste, bem como para a execução geral. Quando não for especificado, Test-AzureStack devolve $true se não existirem falhas e $false se existirem falhas.
TimeoutSeconds pode ser utilizado para definir uma hora específica para cada grupo ser concluído.
A ferramenta de validação também suporta parâmetros comuns do PowerShell: Verboso, Depurar, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Para obter mais informações, veja Acerca dos Parâmetros Comuns.

Exemplos de casos de utilização

Executar a validação sem cenários de cloud

Execute a ferramenta de validação sem o parâmetro ServiceAdminCredential para ignorar a execução de testes de cenários na cloud:

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

Executar a validação com cenários na cloud

Fornecer a ferramenta de validação com o parâmetro ServiceAdminCredentials executa os testes de cenário da cloud por predefinição:

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

Se quiser executar apenas cenários na cloud sem executar os restantes testes, pode utilizar o parâmetro Incluir para o fazer:

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

O nome de utilizador do administrador da cloud tem de ser escrito no formato UPN: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID). Quando lhe for pedido, escreva a palavra-passe para a conta de administrador da cloud.

Grupos

Para melhorar a experiência do operador, foi ativado um parâmetro de Grupo para executar múltiplas categorias de teste ao mesmo tempo. Atualmente, existem três grupos definidos: Predefinição, UpdateReadiness e SecretRotationReadiness.

Predefinição: considerada uma execução padrão do Test-AzureStack. Este grupo é executado por predefinição se não estiverem selecionados outros grupos.
UpdateReadiness: uma verificação para ver se a instância do Azure Stack Hub pode ser atualizada. Quando o grupo UpdateReadiness é executado, os avisos são apresentados como erros na saída da consola e devem ser considerados bloqueadores para a atualização. As seguintes categorias fazem parte do grupo UpdateReadiness :
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: uma verificação para ver se a instância do Azure Stack Hub está num estado em que a rotação de segredos pode ser executada. Quando o grupo SecretRotationReadiness é executado, os avisos são apresentados como erros na saída da consola e devem ser considerados bloqueadores para rotação de segredos. As categorias seguintes fazem parte do Grupo SecretRotationReadiness:
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary

Exemplo de parâmetro de grupo

O exemplo seguinte executa Test-AzureStack para testar a preparação do sistema antes de instalar uma atualização ou correção com o Grupo. Antes de iniciar a instalação de uma atualização ou correção, execute Test-AzureStack para verificar o estado do Azure Stack Hub:

Test-AzureStack -Group UpdateReadiness

Executar a ferramenta de validação para testar as definições de cópia de segurança da infraestrutura

Antes de configurar a cópia de segurança da infraestrutura, pode testar o caminho e a credencial da partilha de cópias de segurança com o teste AzsBackupShareAccessibility :

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

Depois de configurar a cópia de segurança, pode executar a AzsBackupShareAccessibility para validar que a partilha está acessível a partir do ERCS:

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

Para testar novas credenciais com a partilha de cópias de segurança configurada, execute:

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

Executar a ferramenta de validação para testar a infraestrutura de rede

Este teste verifica a conectividade da infraestrutura de rede ao ignorar a rede definida pelo software (SDN) do Azure Stack Hub. Demonstra a conectividade de um VIP Público aos reencaminhadores DNS configurados, servidores NTP e pontos finais de autenticação. Isto inclui conectividade ao Azure ao utilizar Microsoft Entra ID como fornecedor de identidade ou servidor federado ao utilizar o AD FS como fornecedor de identidade.

Inclua o parâmetro de depuração para obter uma saída detalhada do comando:

Test-AzureStack -Include AzsNetworkInfra -Debug

Passos seguintes

Para saber mais sobre as ferramentas de diagnóstico e o registo de problemas do Azure Stack Hub, veja Recolha de registos de diagnósticos do Azure Stack Hub.

Para saber mais sobre a resolução de problemas, veja Resolução de problemas do Microsoft Azure Stack Hub.

Partilhar via