Partilhar via


Avaliar a prontidão de implantação do seu ambiente para o Azure Local, versão 23H2

Aplica-se a: Azure Local, versão 23H2

Este artigo descreve como usar o Verificador de Ambiente Local do Azure em um modo autônomo para avaliar o quão pronto seu ambiente está para implantar a solução Local do Azure.

Para uma implantação suave da solução Local do Azure, seu ambiente de TI deve atender a determinados requisitos de conectividade, hardware, rede e Ative Directory. O Verificador de Ambiente Local do Azure é uma ferramenta de avaliação de prontidão que verifica esses requisitos mínimos e ajuda a determinar se seu ambiente de TI está pronto para implantação.

Sobre a ferramenta Verificador de Ambiente

A ferramenta Verificador de Ambiente executa uma série de testes em cada máquina em sua instância Local do Azure, relata o resultado de cada teste, fornece orientação de correção quando disponível e salva um arquivo de log e um arquivo de relatório detalhado.

A ferramenta Verificador de Ambiente consiste nos seguintes validadores:

  • Validador de conectividade. Verifica se cada máquina no sistema atende aos requisitos de conectividade. Por exemplo, cada máquina no sistema tem conexão com a Internet e pode se conectar via tráfego de saída HTTPS a pontos de extremidade do Azure conhecidos por meio de todos os firewalls e servidores proxy.
  • Validador de hardware. Verifica se o hardware atende aos requisitos do sistema. Por exemplo, todas as máquinas do sistema têm o mesmo fabricante e modelo.
  • Validador do Ative Directory. Verifica se a ferramenta de preparação do Ative Directory é executada antes de executar a implantação.
  • Validador de rede. Valida sua infraestrutura de rede para intervalos de IP válidos fornecidos pelos clientes para implantação. Por exemplo, ele verifica se não há hosts ativos na rede usando o intervalo de IP reservado.
  • Validador de integração Arc. Verifica se o Azure Local atende a todos os pré-requisitos para uma integração bem-sucedida do Arc.

Porquê utilizar o Verificador de Ambiente?

Você pode executar o Verificador de Ambiente para:

  • Certifique-se de que sua infraestrutura Local do Azure esteja pronta antes de implantar quaisquer atualizações ou upgrades futuros.
  • Identifique os problemas que podem potencialmente bloquear a implantação, como não executar um script do Ative Directory pré-implantação.
  • Confirme se os requisitos mínimos foram cumpridos.
  • Identifique e corrija pequenos problemas com antecedência e rapidez, como um URL de firewall mal configurado ou um DNS errado.
  • Identifique e corrija discrepâncias por conta própria e certifique-se de que sua configuração de ambiente atual esteja em conformidade com os requisitos de sistema do Azure Local.
  • Colete logs de diagnóstico e obtenha suporte remoto para solucionar problemas de validação.

Modos do Verificador de Ambiente

Você pode executar o Verificador de Ambiente em dois modos:

  • Ferramenta integrada: A funcionalidade Verificador de Ambiente está integrada no processo de implementação. Por padrão, todos os validadores são executados durante a implantação para executar verificações de preparação pré-implantação.

  • Ferramenta autônoma: essa ferramenta leve do PowerShell está disponível para download gratuito na galeria do Windows PowerShell. Você pode executar a ferramenta autônoma a qualquer momento, fora do processo de implantação. Por exemplo, você pode executá-lo antes mesmo de receber o hardware real para verificar se todos os requisitos de conectividade são atendidos.

Este artigo descreve como executar o Verificador de Ambiente em um modo autônomo.

Pré-requisitos

Antes de começar, conclua as seguintes tarefas:

  • Analise os requisitos de sistema do Azure Local.
  • Analise os requisitos de firewall para o Azure Local.
  • Certifique-se de que tem acesso a um computador cliente em execução na rede onde irá implementar a instância Local do Azure.
  • Verifique se o computador cliente usado está executando o PowerShell 5.1 ou posterior.
  • Verifique se você tem permissão para verificar se a ferramenta de preparação do Ative Directory está em execução.

Instalar o Verificador de Ambiente

O Verificador de Ambiente funciona com o PowerShell 5.1, que é incorporado no Windows.

Você pode instalar o Verificador de Ambiente em um computador cliente, servidor de preparo ou máquina Local do Azure. No entanto, se instalado em uma máquina local do Azure, certifique-se de desinstalá-lo antes de iniciar a implantação para evitar possíveis conflitos.

Para instalar o Verificador de ambiente, siga estes passos:

  1. Execute o PowerShell como administrador (5.1 ou posterior). Se você precisar instalar o PowerShell, consulte Instalando o PowerShell no Windows.

  2. Insira o seguinte cmdlet para instalar a versão mais recente do módulo PowerShellGet:

    Install-Module PowerShellGet -AllowClobber -Force
    
  3. Após a conclusão da instalação, feche a janela do PowerShell e abra uma nova sessão do PowerShell como administrador.

  4. Na nova sessão do PowerShell, registre a galeria do PowerShell como um repositório confiável:

    Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
    
  5. Insira o seguinte cmdlet para instalar o módulo Verificador de Ambiente:

    Install-Module -Name AzStackHci.EnvironmentChecker
    
  6. Se solicitado, pressione Y (Sim) ou A (Sim para todos) para instalar o módulo.

Executar verificações de prontidão

Cada validador na ferramenta Verificador de Ambiente verifica configurações e requisitos específicos. Você pode executar esses validadores invocando seus respetivos cmdlets do PowerShell em cada máquina em seu sistema Local do Azure ou de qualquer computador na rede onde implantará o Azure Local.

Você pode executar os validadores dos seguintes locais:

  • Remotamente via sessão do PowerShell.

  • Localmente a partir de uma estação de trabalho ou de um servidor de preparação.

  • Localmente a partir da máquina Local do Azure. No entanto, certifique-se de desinstalar o Verificador de Ambiente antes de iniciar a implantação para evitar possíveis conflitos.

Selecione cada uma das guias a seguir para saber mais sobre o validador correspondente.

Use o validador de conectividade para verificar se todas as máquinas do seu sistema têm conectividade com a Internet e atendem aos requisitos mínimos de conectividade. Para obter os pré-requisitos de conectividade, consulte Requisitos de firewall para o Azure Local.

Você pode usar o validador de conectividade para:

  • Verifique a conectividade das suas máquinas antes de receber o hardware real. Pode executar o validador de conectividade a partir de qualquer computador cliente na rede onde irá implementar o sistema Local do Azure.
  • Verifique a conectividade de todas as máquinas do seu sistema depois de ter implantado o sistema. Você pode verificar a conectividade de cada máquina executando o cmdlet validador localmente em cada máquina. Ou, você pode se conectar remotamente a partir de um servidor de preparo para verificar a conectividade de uma ou mais máquinas.

Execute o validador de conectividade

Para executar o validador de conectividade, siga estas etapas.

  1. Abra o PowerShell localmente na estação de trabalho, no servidor de preparo ou na máquina local do Azure.

  2. Execute uma validação de conectividade inserindo o seguinte cmdlet:

    Invoke-AzStackHciConnectivityValidation 
    

    Nota

    O uso do cmdlet sem qualquer parâmetro verifica a Invoke-AzStackHciConnectivityValidation conectividade de todos os pontos de extremidade de serviço habilitados no seu dispositivo. Você também pode passar parâmetros para executar verificações de preparação para cenários específicos. Veja exemplos, abaixo.

Aqui estão alguns exemplos de execução do cmdlet validador de conectividade com parâmetros.

Exemplo 1: Verificar a conectividade de um computador remoto

Neste exemplo, você se conecta remotamente a partir de sua estação de trabalho ou de um servidor de preparo para verificar a conectividade de um ou mais sistemas remotos.

$session = New-PSSession -ComputerName remotesystem.contoso.com -Credential $credential
Invoke-AzStackHciConnectivityValidation -PsSession $Session

Exemplo 2: Verificar a conectividade de um serviço específico

Você pode verificar a conectividade para um ponto de extremidade de serviço específico passando o Service parâmetro. No exemplo a seguir, o validador verifica a conectividade dos pontos de extremidade do serviço Azure Arc.

Invoke-AzStackHciConnectivityValidation -Service "Arc For Servers"

Exemplo 3: Verificar a conectividade se estiver a utilizar um proxy

Se você estiver usando um servidor proxy, poderá especificar o validador de conectividade para percorrer o proxy e as credenciais especificados, conforme mostrado no exemplo a seguir:

Invoke-AzStackHciConnectivityValidation -Proxy http://proxy.contoso.com:8080 -ProxyCredential $proxyCredential 

Nota

O validador de conectividade valida o proxy geral, ele não verifica se seu sistema Local do Azure está configurado corretamente para usar um proxy. Para obter informações sobre como configurar firewalls para o Azure Local, consulte Requisitos de firewall para o Azure Local.

Exemplo 4: Verificar a conectividade e criar o objeto de saída do PowerShell

Você pode exibir a saída do verificador de conectividade como um objeto usando o –PassThru parâmetro:

Invoke-AzStackHciConnectivityValidation –PassThru

Aqui está uma captura de tela de exemplo da saída:

Captura de tela de um relatório de validador de conectividade passado para o parâmetro PassThru.

Atributos do validador de conectividade

Você pode filtrar qualquer um dos seguintes atributos e exibir o resultado do validador de conectividade no formato desejado:

Attribute name Description
Ponto Final O ponto de extremidade que está sendo validado.
Protocolo Protocolo utilizado – exemplo https.
Serviço O ponto de extremidade do serviço que está sendo validado.
Tipo de Operação Tipo de operação – implantação, atualização.
Agrupar Verificações de prontidão.
Sistema Para utilização interna.
Nome Nome do serviço individual.
Título Título de serviço; nome voltado para o usuário.
Gravidade Crítico, Aviso, Informativo, Oculto.
Description Descrição do nome do serviço.
Etiquetas Pares chave-valor internos para agrupar ou filtrar testes.
Status Conseguiu, falhou, em andamento.
Remediação Link de URL para documentação para remediação.
TargetResourceID Identificador exclusivo do recurso afetado (nó ou unidade).
TargetResourceName Nome do recurso afetado.
TargetResourceType Tipo do recurso afetado.
Carimbo de Data/Hora A hora em que o teste foi chamado.
Dados adicionais Saco de propriedades de pares de valores chave para obter informações adicionais.
HealthCheckSource O nome dos serviços chamados para o exame de saúde.

Saída do validador de conectividade

Os exemplos a seguir são a saída de execuções bem-sucedidas e malsucedidas do validador de conectividade.

Para saber mais sobre as diferentes seções no relatório de verificação de prontidão, consulte Compreender o relatório de verificação de prontidão.

Saída da amostra: teste bem-sucedido

A saída de exemplo a seguir é de uma execução bem-sucedida do validador de conectividade. A saída indica uma conexão íntegra com todos os pontos de extremidade, incluindo serviços conhecidos do Azure e serviços de observabilidade. Em Diagnóstico, você pode ver que o validador verifica se um servidor DNS está presente e íntegro. Ele coleta WinHttp, proxy IE e configurações de proxy variável de ambiente para diagnóstico e coleta de dados. Ele também verifica se um proxy transparente é usado no caminho de saída e exibe a saída.

Captura de tela de um relatório aprovado depois de executar o validador de conectividade.

Saída de exemplo: Teste reprovado

Se um teste falhar, o validador de conectividade retornará informações para ajudá-lo a resolver o problema, conforme mostrado na saída de exemplo abaixo. A seção Precisa de remediação exibe o problema que causou a falha. A seção Remediação lista o artigo relevante para ajudar a remediar o problema.

Captura de ecrã de um relatório com falha depois de executar o validador de conectividade.

Cenário de falha potencial para o validador de conectividade

O validador de conectividade verifica a inspeção SSL antes de testar a conectividade de quaisquer pontos de extremidade necessários. Se a inspeção SSL estiver ativada em seu sistema Local do Azure, você receberá o seguinte erro:

Captura de tela do erro quando a validação de conectividade falha.

Solução

Trabalhe com sua equipe de rede para desativar a inspeção SSL para seu sistema Local do Azure. Para confirmar se a inspeção SSL está desativada, você pode usar os exemplos a seguir. Depois que a inspeção SSL estiver desativada, você poderá executar a ferramenta novamente para verificar a conectividade com todos os pontos de extremidade.

Se você receber a mensagem de erro de validação de certificado, execute os seguintes comandos individualmente para cada ponto de extremidade para verificar manualmente as informações do certificado:

C:\> Import-Module AzStackHci.EnvironmentChecker 
C:\> Get-SigningRootChain -Uri <Endpoint-URI> | ft subject 

Por exemplo, se você quiser verificar as informações do certificado para dois pontos de extremidade, digamos https://login.microsoftonline.com e https://portal.azure.com, execute os seguintes comandos individualmente para cada ponto de extremidade:

  • Para o https://login.microsoftonline.com:

    C:\> Import-Module AzStackHci.EnvironmentChecker 
    C:\> Get-SigningRootChain -Uri https://login.microsoftonline.com | ft subject
    

    Aqui está um exemplo de saída:

    Subject
    -------
    CN=portal.office.com, O=Microsoft Corporation, L=Redmond, S=WA, C=US
    CN=Microsoft Azure TLS Issuing CA 02, O=Microsoft Corporation, C=US
    CN=DigiCert Global Root G2, OU=www.digicert.com, O=DigiCert Inc, C=US
    
  • Para o https://portal.azure.com:

    C:\> Import-Module AzStackHci.EnvironmentChecker
    C:\> Get-SigningRootChain -Uri https://portal.azure.com | ft Subject 
    
    

    Aqui está um exemplo de saída:

    Subject
    -------
    CN=portal.azure.com, O=Microsoft Corporation, L=Redmond, S=WA, C=US
    CN=Microsoft Azure TLS Issuing CA 01, O=Microsoft Corporation, C=US
    CN=DigiCert Global Root G2, OU=www.digicert.com, O=DigiCert Inc, C=US
    

Compreender o relatório de verificação de prontidão

Cada validador gera um relatório de verificação de prontidão após concluir a verificação. Certifique-se de revisar o relatório e corrigir quaisquer problemas antes de iniciar a implantação real.

As informações exibidas em cada relatório de verificação de prontidão variam dependendo das verificações realizadas pelos validadores. A tabela a seguir resume as diferentes seções nos relatórios de verificação de prontidão para cada validador:

Secção Descrição Disponível em
Serviços Exibe o status de integridade de cada ponto de extremidade de serviço verificado pelo validador de conectividade. Qualquer ponto de extremidade de serviço que falhar na verificação é realçado com a tag Needs Remedia. Relatório do validador de conectividade
Diagnóstico Exibe o resultado dos testes de diagnóstico. Por exemplo, a integridade e a disponibilidade de um servidor DNS. Ele também mostra quais informações o validador coleta para fins de diagnóstico, como WinHttp, proxy do IE e configurações de proxy de variável de ambiente. Relatório do validador de conectividade
Hardware Exibe o status de integridade de todas as máquinas físicas e seus componentes de hardware. Para obter informações sobre os testes realizados em cada hardware, consulte a tabela na guia "Hardware" na seção Executar verificações de preparação. Relatório do validador de hardware
Diagnóstico da UO do AD Exibe o resultado do teste de unidade organizacional do Ative Directory. Exibe se a unidade organizacional especificada existe e contém unidades suborganizacionais adequadas. Relatório do validador do Ative Directory
Teste de rede Exibe o resultado do teste de rede. Se o teste falhar, ele exibe os resultados e as correções correspondentes. Relatório do validador de rede
Resumo Lista a contagem de testes bem-sucedidos e reprovados. Os resultados do teste com falha são expandidos para mostrar os detalhes da falha em Precisa de remediação. Todos os relatórios
Remediação Exibe somente se um teste falhar. Fornece um link para o artigo que fornece orientação sobre como corrigir o problema. Todos os relatórios
Local do log (contém PII) Fornece o caminho onde o arquivo de log é salvo. O caminho padrão é:

- $HOME\.AzStackHci\AzStackHciEnvironmentChecker.log quando você executa o Verificador de ambiente em um modo autônomo.
- C:\CloudDeployment\Logs quando o Verificador de Ambiente é executado como parte do processo de implantação.

Cada execução do validador substitui o arquivo existente.
Todos os relatórios
Localização do relatório (contém PII) Fornece o caminho onde o relatório de verificação de preparação concluído é salvo no formato JSON. O caminho padrão é:

- $HOME\.AzStackHci\AzStackHciEnvironmentReport.json quando você executa o Verificador de ambiente em um modo autônomo.
- C:\CloudDeployment\Logs quando o Verificador de Ambiente é executado como parte do processo de implantação.

O relatório fornece diagnósticos detalhados que são coletados durante cada teste. Essas informações podem ser úteis para integradores de sistemas ou quando você precisa entrar em contato com a equipe de suporte para solucionar o problema. Cada execução do validador substitui o arquivo existente.
Todos os relatórios
Mensagem de conclusão No final do relatório, exibe uma mensagem informando que a verificação de validação foi concluída. Todos os relatórios

Resultados do Verificador de Ambiente

Nota

Os resultados relatados pela ferramenta Verificador de Ambiente refletem o status de suas configurações somente no momento em que você a executou. Se você fizer alterações posteriormente, por exemplo, nas configurações do Ative Directory ou da rede, os itens aprovados anteriormente podem se tornar problemas críticos.

Para cada teste, o validador fornece um resumo dos problemas exclusivos e os classifica em: sucesso, problemas críticos, problemas de aviso e problemas informativos. Problemas críticos são os problemas de bloqueio que você deve corrigir antes de prosseguir com a implantação.

Desinstalar o verificador de ambiente

O verificador de ambiente é fornecido com o Azure Local, certifique-se de desinstalá-lo de todas as máquinas do Azure Local antes de iniciar a implantação para evitar possíveis conflitos.

Remove-Module AzStackHci.EnvironmentChecker -Force
Get-Module AzStackHci.EnvironmentChecker -ListAvailable | Where-Object {$_.Path -like "*$($_.Version)*"} | Uninstall-Module -force

Solucionar problemas de validação de ambiente

Para obter informações sobre como obter suporte da Microsoft para solucionar quaisquer problemas de validação que possam surgir durante a implantação do sistema ou o pré-registro, consulte Obter suporte para problemas de implantação.

Próximos passos