Validar o estado do sistema do Azure Stack Hub
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 $localcredDica
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-AzureStackPara 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, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformanceUma 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.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários