Solucionar problemas de ponte de recursos do Azure Arc

Este artigo fornece informações sobre solução de problemas e resolução de problemas que podem ocorrer ao tentar implantar, usar ou remover a ponte de recursos Azure Arc. A ponte de recursos é uma máquina virtual pré-configurada que hospeda um cluster Kubernetes de gerenciamento. Para obter informações gerais, consulte a visão geral da ponte de recursos do Azure Arc.

Observação

Problemas gerais

Coleta de logs

Para problemas encontrados com o Arc Resource Bridge, colete os logs para investigação adicional usando o comando da CLI do Azure az arcappliance logs. Execute este comando no computador de gerenciamento que você usa para implantar a ponte de recursos do Arc. Se você estiver usando um computador diferente, o computador deverá atender aos requisitos do computador de gerenciamento.

Se você não puder coletar logs, o computador de gerenciamento provavelmente não poderá acessar a VM do dispositivo. Entre em contato com o administrador da rede para permitir a comunicação SSH da máquina de gerenciamento com a VM do dispositivo na porta TCP 22.

Você pode coletar os logs da ponte de recursos do Arc transmitindo o IP da VM do dispositivo ou o kubeconfig no comando logs.

Para coletar logs de ponte de recursos do Arc no VMware usando o endereço IP da VM do dispositivo:

az arcappliance logs vmware \
  --ip <appliance VM IP> \
  --username <vSphere username> \
  --password <vSphere password> \
  --address <vCenter address> \
  --out-dir <path to output directory>

Para coletar logs do Arc Resource Bridge para o Azure Local, consulte Coletar logs.

Se você não tiver certeza do IP da VM do dispositivo, use o kubeconfig. Recupere o kubeconfig executando o comando get-credentials e execute o comando logs.

Para recuperar o kubeconfig e a chave de log e, em seguida, coletar os logs do VMware habilitado para Arc em um computador diferente daquele que você usou para implantar a ponte de recursos do Arc para o VMware habilitado para Arc:

az account set -s <subscription id>
az arcappliance get-credentials -n <Arc resource bridge name> -g <resource group name>
az arcappliance logs vmware --kubeconfig kubeconfig --out-dir <path to specified output directory>

Não há suporte para restauração a partir de backup ou instantâneo

Em geral, não é possível restaurar a ponte de recursos do Arc a partir de instantâneos ou de backups de VM. Se você reverter o dispositivo ao usar um backup ou um instantâneo da VM porque uma atualização falhou, o estado poderá não corresponder mais ao estado registrado no Azure. Essa incompatibilidade é irreversível. Evite executar operações de instantâneo ou de restauração no nível do hipervisor ou da VM no dispositivo. Essas operações interrompem a integridade da atualização, bloqueiam atualizações futuras ou impedem que o recurso retorne a um estado íntegro. Se você restaurar a ponte de recursos usando esses métodos sem suporte, o único caminho de recuperação com suporte será uma operação de recuperação.

Siga as diretrizes de recuperação para sua nuvem privada do Arc:

Obter erro de credenciais de autenticação no CLI do Azure v2.70.0

Você pode encontrar um erro ao executar az arcappliance comandos semelhantes a este:

`File "C:\Program Files\Common Files\AzureCliExtensionDirectory\arcappliance\azext_arcappliance\helpers.py", line 103, in get_tenant_id_and_cloud`

_, _, tenant = profile.get_login_credentials(resource=cmd.cli_ctx.cloud.endpoints.active_directory_graph_resource_id)

TypeError: get_login_credentials() got an unexpected keyword argument 'resource'

A CLI do Azure v2.70.0 lançou uma alteração significativa que dispara esse erro em arcappliance extensão da CLI v1.4.0 e inferior. Uma correção está disponível na arcappliance extensão 1.4.1 da CLI para compatibilidade com CLI do Azure v2.70.0. Você pode obter a extensão da CLI mais recente arcappliance executando o seguinte comando:

az extension add --upgrade --name arcappliance

Se você estiver com a extensão az arcappliance na versão 1.4.0 ou anterior, precisará fazer downgrade da CLI do Azure para v2.69.0.

Se você usou o instalador da CLI do Azure, poderá desinstalar a versão atual e instalar a CLI do Azure v2.69.0 do CLI do Azure installation page. Se você usou o pip instalador, poderá executar o seguinte comando para fazer downgrade: pip install azure-cli==2.69.0.

Além disso, para o script de integração do VMware habilitado para Arc, talvez seja necessário comentar o seguinte código no script para impedir a atualização da CLI do Azure para a versão mais recente:

if (shouldInstallAzCli) {
   installAzCli64Bit
}

Erro ao baixar informações do arquivo de versão

Aviso

Para o Azure Local, use a ferramenta LCM interna para atualizar a ponte de recursos do Arc. Se você tentar atualizar manualmente usando o comando CLI do Azure, seu ambiente será interrompido e não poderá ser recuperado. Se você precisar de assistência com uma atualização da ponte de recursos do Arc, entre em contato com Suporte da Microsoft.

Ao atualizar a ponte de recursos do Arc usando CLI do Azure, você poderá receber o seguinte erro:

az arcappliance upgrade vmware' failed: (DownloadError) "{\n\"message\": \"Error downloading file release information.: Unable to find file release: ^mariner-2-0-(.*)-vhdx-rpm-(.*)$ with version:  in product release: arc-appliance-stable-releases\"\n}

Se você estiver usando uma az arcappliance versão de extensão CLI do Azure anterior à 1.4.0 e tentar atualizar para o dispositivo versão 1.4.0, atualize a extensão CLI do Azure para a versão mais recente:

az extension add --upgrade --name arcappliance

Quando a versão da extensão az arcappliance for 1.4.0, tente atualizar novamente para a versão 1.4.0 do dispositivo. Ao atualizar uma ponte de recursos do Arc, você atualiza para a próxima versão, que pode não ser a versão mais recente. Para obter mais informações, consulte as notas de versão do Arc resource bridge.

A conectividade de download/upload não foi bem-sucedida

Se a velocidade da rede for lenta, talvez você não consiga baixar com êxito a imagem da VM da ponte de recursos do Arc, resultando neste erro:

ErrorCode: ValidateKvaError, Error: Pre-deployment validation of your download/upload connectivity was not successful. Timeout error occurred during download and preparation of appliance image to the on-premises fabric storage. Common causes of this timeout error are slow network download/upload speeds, a proxy limiting the network speed or slow storage performance.

Como solução alternativa, tente criar uma VM diretamente na nuvem privada local e execute o script de implantação da ponte de recursos do Arc dessa VM. Essa abordagem deve resultar em um upload mais rápido da imagem para o armazenamento de dados.

Sobreposição inválida com o Serviço Kubernetes ou Pod CIDR

Quando você implanta ou atualiza Azure Arc ponte de recursos, a operação falha com um erro semelhante a:

"code": "InvalidOverlapWithServiceCIDR",
"message": "Network overlap validation failed: IP: <IP_ADDRESS> overlaps with K8s Default Service CIDR: 10.96.0.0/12. Please reconfigure the network to resolve this conflict."

A ponte de recursos do Azure Arc reserva intervalos de IP específicos, conforme definido nos requisitos de rede. Esse erro ocorre quando o endereço IP ou sub-rede configurado para a ponte de recursos do Arc se sobrepõe a uma CIDR reservada do Kubernetes. Não há suporte para CIDRs sobrepostos, e a validação da simulação os bloqueia. Qualquer sobreposição com esses intervalos resulta em falha de implantação ou atualização.

Os seguintes CIDRs são reservados pela ponte de recursos do Arc:

  • CIDR do Serviço Kubernetes: 10.96.0.0/12
  • CIDR do pod do Kubernetes: 10.244.0.0/16

A resolução depende se esse erro ocorre durante a implantação inicial ou pós-implantação. Se você estiver implantando pela primeira vez, escolha um endereço IP ou sub-rede diferente que não se sobreponha ao CIDR do Serviço kubernetes ou a quaisquer outros CIDRs reservados. Em seguida, tente novamente a implantação.

Se você já implantou o Arc resource bridge e encontrar esse erro durante uma atualização ou alteração de configuração, execute uma operação de recuperação. Durante a recuperação, especifique um endereço IP ou sub-rede não sobreposto que atenda aos requisitos de rede. Siga as diretrizes de recuperação para sua nuvem privada do Arc:

O contexto atingiu o tempo limite durante a fase ApplyingKvaImageOperator

Ao implantar a ponte de recursos do Arc, você poderá ver este erro:

Deployment of the Arc resource bridge appliance VM timed out. Collect logs with _az arcappliance logs_ and create a support ticket for help. To troubleshoot the error, refer to aka.ms/arc-rb-error   { _errorCode_: _ContextError_, _errorResponse_: _{\n\_message\_: \_Context timed out during phase _ApplyingKvaImageOperator_\_\n}_ }

Esse erro geralmente ocorre quando se tenta fazer o download da imagem KVAIO (400 MB compactada) em uma rede lenta ou com conectividade intermitente. O gerenciador do controlador KVAIO aguarda a conclusão do download da imagem e atinge o tempo limite.

Verifique se a velocidade da rede entre a VM da ponte de recursos do Arc e o Registro de Contêiner da Microsoft (mcr.microsoft.com) está estável e com pelo menos 2 Mbps. Se a conectividade e a velocidade da sua rede estiverem estáveis, e você ainda estiver recebendo esse erro, aguarde pelo menos 30 minutos antes de tentar novamente, pois isso pode ser devido ao Microsoft Container Registry estar recebendo um alto volume de tráfego.

O contexto atingiu o tempo limite durante a fase WaitingForAPIServer

Ao implantar a ponte de recursos do Arc, você poderá ver este erro:

Deployment of the Arc resource bridge appliance VM timed out. Collect logs with _az arcappliance logs_ and create a support ticket for help. To troubleshoot the error, refer to aka.ms/arc-rb-error   { _errorCode_: _ContextError_, _errorResponse_: _{\n\_message\_: \_Context timed out during phase _WaitingForAPIServer

Esse erro indica que o computador de implantação não pode entrar em contato com o IP do painel de controle da ponte de recursos do Arc dentro do limite de tempo. As causas comuns do erro geralmente estão relacionadas à rede, como a comunicação entre o computador de implantação e o IP do painel de controle que está sendo roteado por meio de um proxy. O tráfego do computador de implantação para o painel de controle e os IPs de VM do dispositivo não devem passar pelo proxy. Se o tráfego estiver sendo solicitado, defina as configurações de proxy na rede ou no computador de implantação para não fazer o proxy de tráfego entre o computador de implantação para o IP do painel de controle e os IPs da VM do dispositivo. Outra causa para esse erro é se um firewall estiver fechando o acesso à porta 6443 e à porta 22 entre o computador de implantação e o IP do painel de controle ou entre a máquina de implementação e os IPs da VM do dispositivo.

O contexto atingiu o tempo limite durante a fase WaitingForAdditionalComponents

Ao implantar o Arc Resource Bridge, você pode encontrar o seguinte erro:

Deployment of the Arc resource bridge appliance VM timed out. Please collect logs with _az arcappliance logs_ and create a support ticket for help. To troubleshoot the error, refer to aka.ms/arc-rb-error   { _errorCode_: _ContextError_, _errorResponse_: _{\n\_message\_: \_Context timed out during phase _WaitingForAdditionalComponents_\_\n}_

Esse erro normalmente indica que o processo de implantação parou enquanto esperava que componentes críticos, como os gráficos clusterconnect-agent ou Helm, sejam inicializados. Abaixo estão as causas mais comuns e as ações recomendadas:

  • Limitações de largura de banda de rede: conexões de rede lentas ou instáveis podem atrasar downloads de imagem de contêiner, especialmente para componentes-chave. Verifique se a appliance VM possui uma conexão estável com os endpoints necessários. A menor largura de banda de rede validada para implantação da ponte de recursos arc é de 100 Mbps. Velocidades mais baixas podem resultar em falhas de implantação.

  • Configuração incorreta de rede: a interferência de proxy ou as restrições de firewall podem bloquear o acesso aos pontos de extremidade necessários, por exemplo mcr.microsoft.com, time.windows.com ou APIs do Azure. Configurações de proxy incorretas, como listas malformadas no_proxy , como vírgulas duplas (,,), podem interromper a análise de gráfico do Helm e causar erros falsos. Você pode revisar as configurações de proxy, validar as entradas no_proxy em busca de erros de sintaxe e garantir que endpoints críticos sejam excluídos do roteamento pelo proxy.

  • Desempenho do armazenamento: a configuração de armazenamento subótima na VM de appliance pode impedir a descompactação e inicialização bem-sucedidas de componentes. Isso inclui espaço em disco insuficiente, memória inadequada ou IOPS lenta. Para atenuar isso, verifique se a VM do dispositivo atende à linha de base mínima recomendada: 200 GB de espaço em disco, 4 vCPUs e 8 GB de memória, com suporte de armazenamento híbrido (flash e HDD) ou armazenamento all-flash (SSDs ou NVMe). Dependendo de seu ambiente específico e carga de trabalho, especificações mais altas podem ser necessárias.

O contexto atingiu o tempo limite durante a fase WaitingForProviderSpecifics

Ao implantar a ponte de recursos do Arc, você poderá ver este erro:

Deployment of the Arc resource bridge appliance VM timed out. Please collect logs with _az arcappliance logs_ and create a support ticket for help. To troubleshoot the error, refer to aka.ms/arc-rb-error   { _errorCode_: _ContextError_, _errorResponse_: _{\n\_message\_: \_Context timed out during phase _WaitingForProviderSpecifics_\_\n}_, _errorMetadata_: { _errorCategory_: __, _errorAdditionalInfos_: null } }

Esse erro indica que o processo de implantação ficou travado enquanto aguardava que pods específicos do provedor, como o vSphere, ficassem prontos e acabou atingindo o tempo limite. O problema geralmente está relacionado a algum fator no ambiente ou à configuração de rede ou de armazenamento. Na maioria dos casos, as conexões necessárias estão sendo encerradas, e você não consegue avançar no download de imagens de contêiner.

O erro também pode ser causado pela velocidade de rede lenta, causando um tempo limite durante o download do contêiner. Verifique se a appliance VM possui uma conexão estável com os endpoints necessários. A menor largura de banda de rede validada para implantação da ponte de recursos arc é de 100 Mbps. Velocidades mais baixas podem resultar em falhas de implantação. Você pode tentar uma repetição caso a velocidade lenta seja intermitente.

O contexto atingiu o tempo limite durante a fase WaitingForCluster

Ao implantar a ponte de recursos do Arc, você poderá ver este erro:

Context timed out during phase 'WaitingForCluster'

Esse erro indica que o processo de implantação parou enquanto aguardava a inicialização dos componentes do cluster do Kubernetes. Normalmente, ele ocorre durante os estágios iniciais da configuração do dispositivo e geralmente está vinculado a problemas ambientais ou de configuração.

A causa mais frequente é a incapacidade da VM do appliance de acessar o endpoint da sua nuvem privada, como o servidor vSphere ou vCenter. Verifique se você atende a todos os requisitos de rede e tente a implantação novamente.

Tempo limite de preparação do dispositivo

Problema: O seguinte erro ocorre durante a implantação no comando az arcappliance prepare:

Appliance Prepare timed out

Causa: Esse erro é genérico. Isso significa que o fluxo de trabalho geral de preparação da imagem do appliance excedeu seu limite de tempo, mas não identifica qual operação excedeu o tempo limite. O fluxo de trabalho baixa e valida a imagem do sistema operacional do appliance e, em seguida, a transfere e a provisiona no hipervisor local ou no repositório de imagens da malha. Atrasos ou falhas no download, validação, extração, upload, importação de imagem, armazenamento local ou provisionamento de hipervisor podem causar esse erro.

Solução:

  1. Colete os registros da máquina de gerenciamento.

    az arcappliance logs

  2. Revise kva.log e os logs de implantação em busca de um erro aninhado. Use o erro aninhado para identificar as diretrizes de solução de problemas apropriadas.

Exemplo de erro aninhado Área possível para investigar
Pxx: Stopping: Max retries ou DisruptedDownloadError ... Max retries Interrupção no download da imagem ou falhas repetidas nas novas tentativas
size mismatch, falha de hash ou 5700 Validação de imagem baixada ou falha de integridade
CreateFile ... file not found Falha de processamento de arquivo, extração ou armazenamento local
UploadError ou tempo limite do armazenamento de dados Fazer upload para ou importar para o datastore do hipervisor
use of closed network connection Conexão de rede interrompida durante a transferência
upgrade deadline is before image download timeout O prazo do fluxo de trabalho foi atingido antes que o download da imagem fosse concluído.

Esses erros indicam uma área a ser investigada; eles não confirmam por si só a causa raiz.

  1. Para erros relacionados a download, transferência, envio ou importação, trabalhe com sua equipe de redes ou infraestrutura para validar:

    • Largura de banda de rede estável e conectividade do ponto de extremidade. A largura de banda de implantação validada mais baixa é de 100 Mbps.
    • Comportamento de proxy e firewall durante o download e a transferência da imagem.
    • Estabilidade de rede durante toda a operação.
    • Desempenho de armazenamento local e capacidade disponível.
    • Possibilidade de alcance do armazenamento de dados do hipervisor, desempenho e progresso da importação de imagem.

  2. Depois de resolver o erro aninhado ou a condição de infraestrutura subjacente, tente az arcappliance preparenovamente.

  3. Se o erro ocorrer novamente, colete logs e contate Suporte da Microsoft.

403 Proibido ou 404 Site não encontrado

Ao implantar a ponte de recursos do Arc, você poderá ver este erro:

{ _errorCode_: _UploadError_, _errorResponse_: _{\n\_message\_: \_Pre-deployment validation of your download/upload connectivity was not successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_403 Forbidden` or `{ _errorCode_: _UploadError_, _errorResponse_: _{\n\_message\_: \_Pre-deployment validation of your download/upload connectivity was not successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_404 Site Not Found

Esse erro ocorre quando a máquina de implantação precisa baixar imagens dos registros da Microsoft, mas um proxy ou firewall bloqueiam o download. Para obter mais informações, consulte os requisitos de rede e verifique se você pode acessar todas as URLs necessárias. Talvez seja necessário atualizar suas configurações de não usar proxy para garantir que o tráfego da sua máquina de implantação para as URLs exigidas pela Microsoft não passe por um proxy.

Acesso à pasta de SSH negado

A CLI requer permissão para acessar a pasta de SSH durante a implantação ou durante operações que envolvem o acesso a arquivos que estão nessa pasta. A pasta contém arquivos essenciais, como o kubeconfig e a chave de logs da VM do dispositivo. Por exemplo, a CLI precisa acessar a chave de logs armazenada na pasta SSH para coletar logs da VM do dispositivo.

Você poderá ver este erro:

Access to the file in the SSH folder was denied. This may occur if the CLI doesn't have permission to the SSH folder or if another CLI instance is using the file

Duas causas comuns para esse problema são:

  • Permissões insuficientes: a CLI não tem as permissões necessárias para acessar a pasta de SSH. Verifique se a conta de usuário que executa a CLI tem permissões apropriadas para acessar a pasta de SSH.
  • Acesso simultâneo ao arquivo: outra instância da CLI pode estar usando o arquivo na pasta de SSH. Essa condição geralmente ocorre em estações de trabalho com perfis compartilhados. Verifique se outras instâncias da CLI finalizaram ou encerraram as operações antes de prosseguir.

A ponte de recursos do Arc está offline

A ponte de recursos do Arc pode estar offline por vários motivos. Em geral, se a ponte de recursos arc não puder se comunicar com Azure, a VM do dispositivo fica offline. Para o VMware habilitado para Arc e o SCVMM, talvez seja necessário atualizar as credenciais armazenadas na ponte de recursos do Arc. Alterações de rede na infraestrutura, ambiente ou cluster podem afetar a comunicação com Azure. Se você não conseguir determinar o que foi alterado, poderá reinicializar a VM do dispositivo, coletar logs e enviar um tíquete de suporte para investigação. Como melhor prática, crie um alerta do Resource Health para receber informações caso uma ponte de recursos do Arc fique indisponível. A ponte de recursos Arc não pode ficar offline por mais de 45 dias. Após 45 dias, a chave de segurança dentro da VM do dispositivo pode não ser mais válida e não pode ser atualizada. Se você não conseguir colocar a ponte de recursos do Arc novamente online, entre em contato com Suporte da Microsoft.

Não há suporte para o PowerShell remoto

Se você executar comandos az arcappliance da CLI para a ponte de recursos do Arc por meio do PowerShell remoto, poderá ver um erro de falha no handshake de autenticação ao tentar instalar a ponte de recursos em uma instância do Azure Local ou outro tipo de erro.

No momento, não há suporte para o uso de comandos az arcappliance do PowerShell remoto. Em vez disso, entre no nó por meio do protocolo RDP ou use uma sessão de console.

Rede do dispositivo indisponível

Se a ponte de recursos do Arc apresentar problemas de rede, você poderá receber o erro Appliance Network Unavailable. Em geral, qualquer problema de conectividade de rede ou infraestrutura com a VM do dispositivo pode causar esse erro. Esse erro também pode aparecer como Error while dialing dial tcp xx.xx.xxx.xx:55000: connect: no route to host. O problema pode ser que a comunicação do host com a VM da ponte de recursos do Arc precise ser aberta pela porta TCP 22 com a ajuda do administrador de rede. Um problema de rede temporário pode impedir que o host atinja a VM da ponte de recursos do Arc. Quando o problema da rede for resolvido, você poderá tentar novamente a operação. Você também pode verificar se a VM do dispositivo para ponte de recursos do Arc não está parada ou offline. Com o Azure Local, esse erro pode ser causado quando o armazenamento do host está cheio.

Erro de atualização de token

Ao executar comandos CLI do Azure, você poderá ver o seguinte erro:

The refresh token has expired or is invalid due to sign-in frequency checks by conditional access.

Este erro ocorre porque ao entrar no Azure, o token tem um tempo de vida máximo. Quando esse tempo de vida for excedido, você precisará entrar no Azure novamente usando o comando az login.

Pools de recursos de host padrão não estão disponíveis para implantação

Quando você usa o comando az arcappliance run ou az arcappliance createconfig, uma interface interativa exibe a lista de entidades da VMware que você pode selecionar para implantar o appliance virtual. Esta lista mostra todos os pools de recursos criados pelo usuário junto com pools de recursos de cluster padrão, mas não lista os pools de recursos de host padrão. Quando você implanta o dispositivo em um pool de recursos de host, não haverá alta disponibilidade se o hardware do host falhar. Não implante o dispositivo em um pool de recursos de host.

Credenciais expiradas na VM do dispositivo

O Arc resource bridge inclui uma VM de appliance que você implanta em sua infraestrutura on-premises. A VM do appliance usa credenciais armazenadas localmente para manter uma conexão com o endpoint de gerenciamento, como o VMware vCenter, na infraestrutura on-premises. Se você não atualizar essas credenciais, a ponte de recursos não poderá se comunicar com o endpoint de gerenciamento. Essa limitação pode causar problemas quando você tenta atualizar a ponte de recursos ou gerenciar VMs por meio de Azure.

Para corrigir esse problema, atualize as credenciais na VM do dispositivo. Para obter mais informações, consulte Atualizar credenciais na VM do dispositivo.

A ponte de recursos Arc não suporta link privado. As chamadas da VM do appliance não devem passar pela configuração do Private Link. Os IPs de link privado podem entrar em conflito com o intervalo de pool de IP do dispositivo, que você não pode configurar na ponte de recursos. A ponte de recursos do Arc acessa URLs obrigatórias que não devem passar por uma conexão de link privado. Você deve implantar a ponte de recursos do Arc em um segmento de rede separado que não esteja relacionado à configuração do link privado.

Instalação de extensão não aprovada

O Arc resource bridge é um appliance virtual restrito que hospeda somente extensões de nuvem privada habilitadas para Azure Arc aprovadas. Se você tentar instalar qualquer outra extensão na ponte de recursos, receberá um erro:

Extension installation failed. The specified extension is not permitted on Azure Arc Resource Bridge. Only Azure Arc resource bridge approved extensions can be installed.

Erro ao baixar informações de lançamento do arquivo

Ao tentar atualizar a ponte de recursos do Arc, você pode encontrar o seguinte erro:

'az arcappliance upgrade hci' failed: (DownloadError) "{\n\"message\": \"Error downloading file release information.: Unable to find file release: ^mariner-2-0-(.*)-vhdx-rpm-(.*)$ with version:  in product release: arc-appliance-stable-releases\"\n}",

Esse erro ocorre quando você usa uma versão mais antiga da extensão da CLI do Azure arcappliance que não é compatível com versões posteriores da ponte de recursos do Arc. Antes de atualizar, atualize a extensão da CLI do Azure para arcappliance executando o seguinte comando da CLI do Azure:

az extension add --upgrade --name arcappliance

Versão GLIBC não encontrada

Você pode receber o seguinte erro ao implantar a ponte de recursos do Arc:

"error_message": /lib64/libc.so.6: version `GLIBC_2.34_ not found (required by /root/.azure/cliextensions/arcappliance/azext_arcappliance/pkg/providers/kva//../../binaries/arcsdk.so)

Esta mensagem de erro indica que a extensão da CLI do Arc Resource Bridge (arcappliance) tenta carregar uma biblioteca compartilhada (arcsdk.so) que foi compilada no glibc 2.34, mas seu sistema Linux tem uma versão mais antiga do glibc ou não tem a versão glibc necessária. Essa condição poderá acontecer se você estiver executando uma versão antiga do Linux. Você pode verificar a versão glibc atual usando ldd --version. Use uma distribuição Linux com suporte e com a versão necessária da glibc, ou faça a integração por meio de uma jumpbox ou VM cliente que atenda ao requisito da glibc.

Problemas de rede

Erro de imagem de extração de retirada

Ao tentar implantar a ponte de recursos do Arc, você poderá ver um erro que contém back-off pulling image \\\"url"\\\: FailFastPodCondition. Esse erro ocorre quando a VM do dispositivo não consegue alcançar a URL especificada no erro. Para corrigir esse problema, verifique se a VM do dispositivo atende aos requisitos do sistema, incluindo a conectividade de acesso à Internet às URLs de lista de permissões necessárias.

O computador de gerenciamento não pode acessar o dispositivo

Ao tentar implantar a ponte de recursos do Arc, você pode receber uma mensagem de erro semelhante a:

{ _errorCode_: _PostOperationsError_, _errorResponse_: _{\n\_message\_: \_Timeout occurred due to management machine being unable to reach the appliance VM IP, 10.2.196.170.  Ensure that the requirements are met: https://aka.ms/arb-machine-reqs: dial tcp 10.2.196.170:22: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.\_\n}_, _errorMetadata_: { _errorCategory_: __ }

Esse erro ocorre quando o computador de gerenciamento não consegue alcançar o IP da VM da ponte de recursos do Arc por SSH (Porta 22) ou servidor de API (Porta 6443). Isso também pode acontecer se o servidor da API da ponte de recursos do Arc estiver sendo acessado por meio de um proxy. Você precisa adicionar o servidor da API da ponte de recursos do Arc às configurações de no-proxy. Para obter mais informações, consulte os requisitos de rede da ponte de recursos do Azure Arc.

Não é possível se conectar à URL

Se você receber um erro que contenha Not able to connect to https://example.url.com, verifique com o administrador de rede para garantir que sua rede permita que todas as URLs de firewall e proxy necessárias implantem a ponte de recursos do Arc. Para obter mais informações, consulte os requisitos de rede da ponte de recursos do Azure Arc.

Não foi possível se conectar – houve falha na validação de conectividade de rede e internet

Ao implantar a ponte de recursos do Arc, você poderá receber uma mensagem de erro em que errorCode aparece como PostOperationsError, errorResponse aparece como o código GuestInternetConnectivityError, com uma URL que especifica a porta 53 (DNS). Esse erro pode acontecer porque os IPs das VMs do appliance não conseguem acessar os servidores DNS e, por isso, não conseguem resolver o ponto de extremidade especificado no erro.

Exemplos de erro:

{ _errorCode_: _PostOperationsError_, _errorResponse_: _{\n\_message\_: \_{\\n  \\\_code\\\_:\\\_GuestInternetConnectivityError\\\_,\\n\\\_message\\\_:\\\_Not able to connect to http://aszhcitest01.company.org:55000. Error returned: action failed after 5 attempts: Get \\\\\\\_http://aszhcitest01.company.org:55000\\\\\\\_: dial tcp: lookup aszhcitest01.company.org on 127.0.0.53:53: read udp 127.0.0.1:32975-\\u003e127.0.0.53:53: i/o timeout. Arc Resource Bridge network and internet connectivity validation failed: cloud-agent-connectivity-test. 1.  check your networking setup and ensure the URLs mentioned in : https://aka.ms/AAla73m are reachable from the Appliance VM.   2. Check firewall/proxy settings\\\_\\n }\_\n}_ }

{ _errorCode_: _PostOperationsError_, _errorResponse_: _{\n\_message\_: \_{\\n  \\\_code\\\_: \\\_GuestInternetConnectivityError\\\_,\\n  \\\_message\\\_: \\\_Not able to connect to https://linuxgeneva-microsoft.azurecr.io. Error returned: action failed after 5 attempts: Get \\\\\\\_https://linuxgeneva-microsoft.azurecr.io\\\\\\\_: dial tcp: lookup linuxgeneva-microsoft.azurecr.io on 127.0.0.53:53: server misbehaving. Arc Resource Bridge network and internet connectivity validation failed: http-connectivity-test-arc. 1. Please check your networking setup and ensure the URLs mentioned in : https://aka.ms/AAla73m are reachable from the Appliance VM.   2. Check firewall/proxy settings\\\_\\n }\_\n}_ }

Para corrigir esses erros, trabalhe com o administrador de rede para permitir que os IPs da VM do dispositivo cheguem aos servidores DNS. Para obter mais informações, consulte os requisitos de rede da ponte de recursos do Azure Arc.

Servidor HTTP/2 enviou GOAWAY

Ao tentar implantar a ponte de recursos do Arc, você pode receber mensagens de erro semelhantes aos seguintes exemplos:

"errorResponse": "{\n\"message\": \"Post \\\"https://region.dp.kubernetesconfiguration.azure.com/azure-arc-appliance-k8sagents/GetLatestHelmPackagePath?api-version=2019-11-01-preview\\u0026releaseTrain=stable\\\": http2: server sent GOAWAY and closed the connection; LastStreamID=1, ErrCode=NO_ERROR, debug=\\\"\\\"\"\n}"

Post \_https://canadacentral.dp.kubernetesconfiguration.azure.com/azure-arc-appliance-k8sagents/GetLatestHelmPackagePath?api-version=2019-11-01-preview\u0026releaseTrain=stable\_: read tcp 10.128.131.173:52425-\u003e52.228.84.81:443: wsarecv: An existing connection was forcibly closed by the remote host.

Esses erros podem ocorrer quando um firewall ou proxy tiver a inspeção SSL/TLS habilitada e bloquear chamadas HTTP/2 do computador que você usa para implantar a ponte de recursos. Para confirmar o problema, execute o seguinte cmdlet do PowerShell para invocar a solicitação da Web com HTTP/2 (requer o PowerShell versão 7 ou posterior), substituindo a região na URL e api-version (por exemplo, 2019-11-01) por valores do erro:

Invoke-WebRequest -HttpVersion 2.0 -UseBasicParsing -Uri https://region.dp.kubernetesconfiguration.azure.com/azure-arc-appliance-k8sagents/GetLatestHelmPackagePath?api-version=2019-11-01-preview"&"releaseTrain=stable -Method Post -Verbose

Se o resultado for The response ended prematurely while waiting for the next frame from the server, a chamada HTTP/2 será bloqueada e você precisará permitir. Trabalhe com o administrador de rede para desabilitar a inspeção SSL/TLS para permitir chamadas HTTP/2 do computador que você usa para implantar a ponte.

Nenhum host desse tipo – .local não é suportado

Ao tentar definir a configuração para a ponte de recursos do Arc, você pode receber uma mensagem de erro semelhante a:

"message": "Post \"https://esx.lab.local/52c-acac707ce02c/disk-0.vmdk\": dial tcp: lookup esx.lab.local: no such host"

Esse erro ocorre quando você fornece um caminho .local para uma definição de configuração, como proxy, DNS, datastore ou endpoint de gerenciamento (como o vCenter). A VM do dispositivo de ponte de recursos arc usa o sistema operacional Linux do Azure, que não dá suporte a .local por padrão. Uma solução alternativa pode ser fornecer o endereço IP quando aplicável.

A ponte de recursos do Azure Arc está inacessível

A ponte de recursos do Azure Arc executa um cluster Kubernetes e seu plano de controle requer um endereço IP estático. Especifique o endereço IP no infra.yaml arquivo. Se você atribuir o endereço IP de um servidor DHCP, o endereço poderá ser alterado se você não o reservar. A reinicialização da ponte de recursos ou da VM do Azure Arc pode disparar uma alteração de endereço IP e resultar em serviços com falha.

A bridge de recursos do Arc pode, intermitentemente, perder a configuração de IP reservada. Essa perda ocorre devido ao comportamento descrito em perda de VIPs quando se reinicia systemd-networkd. Quando o endereço IP não é atribuído à VM da ponte de recursos do Azure Arc, todas as chamadas para o servidor de API da ponte de recursos falham. As operações principais, como a criação de um novo recurso, a conexão à nuvem privada de Azure ou a criação de um local personalizado, não funcionam conforme o esperado.

Para resolver esse problema, reinicialize a VM da ponte de recursos e ela deve recuperar seu endereço IP. Se o endereço for atribuído de um servidor DHCP, reserve o endereço IP associado à ponte de recursos.

A ponte de recursos do Arc também pode ser inacessível devido ao acesso lento ao disco. A ponte de recursos do Azure Arc usa a ETCD (árvore de configuração estendida) do Kubernetes, que requer latência igual ou inferior a 10 ms. Se o disco subjacente tiver baixo desempenho, as operações serão afetadas e falhas poderão ocorrer.

Problemas de configuração de proxy SSL

Verifique se o servidor proxy em seu computador de gerenciamento confia tanto no certificado SSL para o proxy SSL quanto no certificado SSL dos servidores de download do Microsoft. Para obter mais informações, consulte a configuração do proxy SSL.

Nenhum host encontrado - dp.kubernetesconfiguration.azure.com

Ao implantar a ponte de recursos do Arc, você pode receber uma mensagem de erro semelhante a:

{ _message_: _Post \_https://eastus.dp.kubernetesconfiguration.azure.com/azure-arc-appliance-k8sagents/GetLatestHelmPackagePath?api-version=2019-11-01-preview\u0026releaseTrain=stable\_: dial tcp: lookup eastus.dp.kubernetesconfiguration.azure.com: no such host_ }

A mensagem de erro indica um problema ao acessar a URL indicada na mensagem de erro; neste caso, eastus.dp.kubernetesconfiguration.azure.com. Esse erro pode ocorrer por vários motivos:

  • O plano de dados de configuração pode estar temporariamente indisponível na região especificada.
  • Problema de resolução de DNS para o endpoint *.dp.kubernetesconfiguration.azure.com.
  • Erro de alcance de rede até o ponto de extremidade *.dp.kubernetesconfiguration.azure.com.

Ações recomendadas:

  • Aguarde até que o serviço esteja disponível e tente novamente a implantação.
  • Verifique as configurações do servidor DNS no host.
  • Confirme se o firewall ou o proxy não bloqueia o acesso de saída à Internet para o endpoint.

Certificado assinado por autoridade desconhecida

Você pode encontrar o seguinte erro ao implantar a ponte de recursos do Arc:

"errorResponse": "{\n\"message\": \"{\\n  \\\"code\\\": \\\"GuestInternetConnectivityError\\\",\\n  \\\"message\\\": \\\"Name: http-connectivity-test-arc. Message: Not able to connect to https://msk8s.api.cdp.microsoft.com. Error returned: action failed after 5 attempts: Get \\\\\\\"https://msk8s.api.cdp.microsoft.com\\\\\\\": **tls: failed to verify certificate: x509: certificate signed by unknown authority.** Arc Resource Bridge network and internet connectivity validation failed: http-connectivity-test-arc. 1. Please check your networking setup and ensure the URLs mentioned in : https://aka.ms/AAla73m are reachable from the Appliance VM.   2. Check firewall/proxy settings\\\",\\n  \\\"category\\\": \\\"\\\"\\n }\"\n}",

Esse erro ocorre quando a inspeção SSL ocorre dentro da rede e impede que a confiança HTTPS/SSL seja estabelecida com o ponto de extremidade referenciado no erro. Esse erro ocorre mais comumente com um servidor proxy SSL que realiza inspeção ou terminação SSL, intercepta a conexão com o endpoint e prejudica a conectividade. Se você não configurar um servidor proxy durante a implantação, sua rede poderá ter um proxy transparente ou um dispositivo de segurança de rede que interfira nessa conexão. Trabalhe com sua equipe de rede para depurar a causa usando seus logs de proxy, firewall ou dispositivo de segurança.

Conexão de proxy TCP - nenhum host desse tipo para a URL necessária da ponte de recursos do Arc

Um erro que contenha uma URL obrigatória do Arc Resource Bridge com a mensagem proxyconnect tcp: dial tcp: lookup http: no such host indica que o DNS não consegue resolver a URL. O erro pode ser semelhante a este exemplo, em que a URL necessária é https://msk8s.api.cdp.microsoft.com:

Error:  { _errorCode_: _InvalidEntityError_, _errorResponse_: _{\n\_message\_: \_Post \\\_https://msk8s.api.cdp.microsoft.com/api/v1.1/contents/default/namespaces/default/names/arc-appliance-stable-catalogs-ext/versions/latest?action=select\\\_: POST https://msk8s.api.cdp.microsoft.com/api/v1.1/contents/default/namespaces/default/names/arc-appliance-stable-catalogs-ext/versions/latest?action=select giving up after 6 attempt(s): Post \\\_https://msk8s.api.cdp.microsoft.com/api/v1.1/contents/default/namespaces/default/names/arc-appliance-stable-catalogs-ext/versions/latest?action=select\\\_: proxyconnect tcp: dial tcp: lookup http: no such host\_\n}_ }

Esse erro pode ocorrer se as configurações de DNS de implantação não estiverem corretas ou se houver um problema com os servidores DNS. Verifique se o servidor DNS pode resolver a URL executando o seguinte comando no computador de gerenciamento ou em um computador que tenha acesso aos servidores DNS:

nslookup
> set debug
> <hostname> <DNS server IP>

Para resolver o erro, configure os servidores DNS para resolver todos os URLs necessários para a ponte de recursos do Arc. Forneça os servidores DNS corretamente ao implantar a ponte de recursos do Arc.

Erro de tempo limite de KVA

O erro de tempo limite do KVA é um erro genérico causado por várias configurações de rede incorretas que envolvem a máquina de gerenciamento. Por exemplo, a VM do appliance ou o IP do plano de controle podem não conseguir se comunicar entre si, com a Internet ou com as URLs necessárias. Essas falhas de comunicação geralmente ocorrem devido a problemas com resolução DNS, configurações de proxy, configuração de rede ou acesso à Internet.

Para maior clareza, "computador de gerenciamento" refere-se ao computador em que os comandos da CLI de implantação estão sendo executados. VM do Dispositivo é a VM que hospeda a ponte de recursos do Arc. IP do Painel de Controle é o IP do painel de controle do cluster de gerenciamento do Kubernetes na VM do Dispositivo.

Principais causas do erro de tempo limite de KVA

  • O computador de gerenciamento não consegue se comunicar com o IP do Plano de Controle e o IP da VM do dispositivo.
  • A VM do dispositivo não consegue se comunicar com o computador de gerenciamento, o ponto de extremidade do vCenter (para VMware) ou o ponto de extremidade do agente de nuvem do MOC (para o Azure Local). 
  • A VM do dispositivo não tem acesso à Internet.
  • A VM do dispositivo tem acesso à Internet, mas a conectividade com uma ou mais URLs necessárias está sendo bloqueada, possivelmente devido a um proxy ou firewall.
  • A VM do dispositivo não consegue acessar um servidor DNS que pode resolver nomes internos, como o ponto de extremidade do vCenter para vSphere ou o ponto de extremidade do agente de nuvem para o Azure Local. O servidor DNS também deve ser capaz de resolver endereços externos, como endereços de serviço do Azure e nomes de registro de contêiner. 
  • A configuração do servidor proxy no computador de gerenciamento ou nos arquivos de configuração da ponte de recursos do Arc está incorreta. Isso pode afetar o computador de gerenciamento e a VM do dispositivo. Quando o comando az arcappliance prepare for executado e o proxy do host não está configurado corretamente, o computador de gerenciamento não poderá se conectar e baixar imagens do sistema operacional. O acesso à Internet na VM do dispositivo pode ser interrompido pela configuração de proxy incorreta ou ausente, o que afeta a capacidade da VM de efetuar pull das imagens de contêiner. 

Solucionar erro de tempo limite do KVA

Para resolver o erro, uma ou mais configurações incorretas de rede podem precisar ser resolvidas.

  • A primeira etapa é coletar logs por IP da VM do dispositivo (não por kubeconfig, pois o kubeconfig pode estar vazio se o comando de implantação não tiver sido concluído). Os problemas de coleta de logs provavelmente ocorrem devido ao computador de gerenciamento não conseguir acessar a VM do dispositivo.

    Depois que os logs forem coletados, extraia a pasta e abra kva.log. Examine o log para obter informações que possam ajudar a identificar a causa do erro de tempo limite de KVA.

  • O computador de gerenciamento deve ser capaz de se comunicar com o IP da VM do dispositivo e o IP do plano de controle. Faça ping no IP do plano de controle e no IP da VM do appliance a partir da máquina de gerenciamento e verifique se há uma resposta de ambos os IPs.

    Se uma solicitação atingir o tempo limite, o computador de gerenciamento não poderá se comunicar com os IPs. Esse problema pode ser causado por uma porta fechada, configuração incorreta da rede ou bloco de firewall. Trabalhe com o administrador de rede para permitir a comunicação entre o computador de gerenciamento para o IP do Plano de Controle e o IP da VM do dispositivo.

  • O IP da VM do Dispositivo e o IP do Painel de Controle precisam ter a capacidade de se comunicar com o computador de gerenciamento e o ponto de extremidade do vCenter (para VMware) ou o ponto de extremidade do agente de nuvem do MOC (no caso do Azure Local). Trabalhe com o administrador de rede para garantir que a rede esteja configurada para permitir essa comunicação. Talvez seja necessário adicionar uma regra de firewall para abrir a porta 443 do IP da VM do dispositivo e do IP do plano de controle para o vCenter ou para abrir as 65000 e 55000 para o agente de nuvem MOC do Azure Local. Para obter mais informações, consulte os requisitos de rede para o Azure Local e VMware para a ponte de recursos do Arc.

  • O IP da VM do dispositivo e o IP do painel de controle precisam de acesso à Internet para essas URLs necessárias. O Azure Local requer URLs adicionais. Trabalhe com o administrador de rede para garantir que os IPs possam acessar as URLs necessárias.

  • Em um ambiente não proxy, o computador de gerenciamento deve ter resolução DNS externa e interna. O computador de gerenciamento deve ser capaz de alcançar um servidor DNS que possa resolver nomes internos, como o ponto de extremidade do vCenter para vSphere ou o ponto de extremidade do agente de nuvem para o Azure Local. O servidor DNS também precisa ser capaz de resolver endereços externos, como URLs do Azure e URLs de download de imagem do sistema operacional. Trabalhe com o administrador do sistema para garantir que o computador de gerenciamento tenha resolução DNS interna e externa. Em um ambiente de proxy, a resolução DNS no servidor proxy deve resolver os pontos de extremidade internos e os endereços externos obrigatórios.

    Para testar a resolução de DNS em um endereço interno do computador de gerenciamento em um cenário não proxy, abra um prompt de comando e execute nslookup <vCenter endpoint or HCI MOC cloud agent IP>. Você deverá receber uma resposta se o computador de gerenciamento tiver resolução DNS interna em um cenário não proxy. 

  • A VM do dispositivo precisa ter a capacidade de acessar um servidor DNS que possa resolver nomes internos, como o ponto de extremidade do vCenter para vSphere ou o ponto de extremidade do agente de nuvem para o Azure Local. O servidor DNS também precisa ser capaz de resolver endereços externos e internos, como os endereços dos serviços do Azure e os nomes dos repositórios de contêineres para o download das imagens de contêiner da ponte de recursos do Arc a partir da nuvem.

    Verifique se o IP do servidor DNS usado para criar os arquivos de configuração tem resolução de endereço interno e externo.

Não há suporte para mover a VM do Arc Resource Bridge

A ponte de recursos Arc e suas camadas subjacentes fazem referência ao caminho de implementação original. Atualizar o arquivo YAML de configuração ou realocar manualmente a VM no console de gerenciamento não atualiza essas referências internas. Como resultado, fazer essas alterações pode levar a falhas de atualização ou erros, como não é possível recuperar o recurso.

Se você precisar alterar o local da VM da ponte de recursos, reimplante a ponte de recursos no local desejado. Siga as diretrizes de recuperação para seu ambiente:

Problemas com VMs habilitadas para Azure Arc no Azure Local

Para obter ajuda geral para resolver problemas relacionados a VMs habilitadas para Azure Arc no Azure Local, consulte Solucionar problemas de gerenciamento de VM do Azure Arc para o Azure Local.

Se você estiver executando Azure Local, versão 23H2 ou posterior e o Arc Resource Bridge estiver offline, tente reiniciar a VM do Arc Resource Bridge para colocá-la novamente online. Se o problema persistir, entre em contato com o Suporte da Microsoft para obter assistência. Não exclua a VM do Arc Resource Bridge sem orientação de Suporte da Microsoft.

Houve falha na ação – não há host desse tipo

Ao implantar a ponte de recursos do Arc, você pode receber um erro com errorCode como PostOperationsError, errorResponse como código GuestInternetConnectivityError e no such host. Os IPs da VM do dispositivo podem não conseguir acessar o endpoint especificado no erro.

Exemplo de erro:

{ _errorCode_: _PostOperationsError_, _errorResponse_: _{\n\_message\_: \_{\\n  \\\_code\\\_: \\\_GuestInternetConnectivityError\\\_,\\n  \\\_message\\\_: \\\_Not able to connect to http://aszhcitest01.company.org:55000. Error returned: action failed after 5 attempts: Get \\\\\\\_http://aszhcitest01.company.org:55000\\\\\\\_: dial tcp: lookup aszhcitest01.company.org: on 127.0.0.53:53: no such host. Arc Resource Bridge network and internet connectivity validation failed: cloud-agent-connectivity-test.
1. check your networking setup and ensure the URLs mentioned in : https://aka.ms/AAla73m are reachable from the Appliance VM.
2. Check firewall/proxy settings

No exemplo a seguir, os IPs das VMs do dispositivo virtual não conseguem acessar http://aszhcitest01.company.org:55000, que é o ponto de extremidade do MOC. Trabalhe com o administrador de rede para garantir que o servidor DNS possa resolver as URLs necessárias.

Para testar a conectividade com o servidor DNS, execute:

ping <dns-server.com>

Para verificar se o servidor DNS pode resolver um endereço, execute este comando de um computador que pode acessar os servidores DNS:

Resolve-DnsName -Name "http://aszhcitest01.company.org:55000" -Server "<dns-server.com>"

Autenticação necessária

Você pode receber o seguinte erro ao implantar a ponte de recursos do Arc:

{ _message_: _Post \_https://westeurope.dp.kubernetesconfiguration.azure.com/azure-arc-appliance-k8sagents/GetLatestHelmPackagePath?api-version=2019-11-01-preview\u0026releaseTrain=stable\_: authenticationrequired_ }

Esse erro provavelmente ocorre porque um proxy intercepta a solicitação e requer autenticação. Para executar a CLI do Azure com êxito por trás desse tipo de proxy, certifique-se de que haja suporte adequado a proxy.

Ações recomendadas:

  1. Confirme se um proxy está ativo em seu ambiente.
  2. Nesse caso, configure variáveis de ambiente (HTTPS_PROXY, HTTP_PROXY e, opcionalmente, NO_PROXY) com credenciais de autenticação, se necessário. Consulte os requisitos de rede da ponte de recursos do Azure Arc.
  3. Talvez você também precise garantir que CLI do Azure possa funcionar por trás de um proxy. Para obter instruções detalhadas, consulte CLI do Azure guia de solução de problemas de proxy.

Problemas do VMware vCenter habilitado para Azure Arc

errorResponse: error getting the vsphere sdk client

Você vê erros com errorCode: CreateConfigKvaCustomerError e errorResponse: error getting the vsphere sdk client quando seu computador de implantação tenta estabelecer uma conexão TCP com seu endereço vCenter, mas encontra um problema. Esse problema pode ocorrer se o endereço do vCenter estiver incorreto (erro 403 ou 404) ou se uma configuração de rede, proxy ou firewall bloquear a conexão (falha na tentativa de conexão).

Se você inserir o endereço do vCenter como um nome de host e receber o erro no such host, o computador de implantação não poderá resolver o nome do host do vCenter por meio do DNS do cliente. Esse problema poderá ocorrer se o computador de implantação puder resolver o nome do host do vCenter, mas não conseguir acessar o endereço IP recebido do DNS. Você também poderá ver esse erro se o ponto de extremidade retornado pelo DNS não for seu endereço vCenter ou se um proxy tiver interceptado o tráfego. Se o computador de implantação puder se comunicar com o endereço do vCenter, confirme se o nome de usuário e a senha estão corretos.

Cliente do SDK do vSphere – Falha na tentativa de conexão

Seu computador de gerenciamento não poderá se comunicar com seu servidor vCenter se você receber um erro durante a implantação que afirma:

errorCode_: _CreateConfigKvaCustomerError_, _errorResponse_: _error getting the vsphere sdk client: Post \_https://ip.address/sdk\_: dial tcp ip.address:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond._ }

Para resolver esse problema, verifique se o computador de gerenciamento atende aos requisitos do computador de gerenciamento e se não há nenhuma comunicação de bloqueio de firewall ou proxy.

Cliente do SDK do vSphere – 403 Proibido ou 404 não encontrado

Os erros que incluem a seguinte mensagem de erro ao implantar o Arc Resource Bridge provavelmente ocorrem devido a um endereço incorreto do vCenter. Você fornece esse endereço durante a criação do arquivo de configuração, quando for solicitado que você insira o endereço vCenter como um nome de host ou endereço IP.

errorCode_: _CreateConfigKvaCustomerError_, _errorResponse_: _error getting the vsphere sdk client: POST \_/sdk\_: 403 Forbidden` or `404 not found

Você pode encontrar seu endereço vCenter de maneiras diferentes. Uma opção é acessar o cliente vSphere por meio de sua interface da Web. Normalmente, você usa o nome do host ou o endereço IP do vCenter no navegador para acessar o cliente vSphere. Se você já estiver conectado, poderá exibir a barra de endereços do navegador, em que a URL usada para acessar o vSphere é o nome do host ou o endereço IP do servidor vCenter. Verifique o endereço do vCenter e tente a implantação novamente.

Cliente do SDK do vSphere – Nenhum host desse tipo

Esse erro poderá ocorrer durante a implantação se o computador de implantação não puder resolver o nome do host do vCenter para um endereço IP. Esse problema ocorre porque o processo de implantação está tentando estabelecer uma conexão TCP do computador de implantação com o nome de host do vCenter, mas a conexão falha devido a problemas de resolução de DNS.

{ _errorCode_: _CreateConfigKvaCustomerError_, _errorResponse_: _error getting the vsphere sdk client: Post \_https://your.vcenter.hostname/sdk\_: dial tcp: lookup your.vcenter.hostname: no such host_ }

Para corrigir esse erro, verifique se a configuração de DNS em seu computador de implantação está correta, verifique se o servidor DNS está online e se há uma entrada DNS ausente para o nome de host do vCenter. Você pode testar a resolução de DNS executando nslookup your.vcenter.hostname ou ping your.vcenter.hostname no computador de implantação. Se você especificou o endereço do vCenter como um nome de host, considere usar o endereço IP diretamente.

Erros de validação de pré-implantação

Ao implementar a ponte de recursos do Arc, você poderá ver vários erros pre-deployment validation of your download\upload connectivity wasn't successful, como:

Pre-deployment validation of your download/upload connectivity wasn't successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_Post \\\\\\\_https://vcenter-server.com/nfc/unique-identifier/disk-0.vmdk\\\\\\\_: Service Unavailable

Pre-deployment validation of your download/upload connectivity wasn't successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_Post \\\\\\\_https://vcenter-server.com/nfc/unique-identifier/disk-0.vmdk\\\\\\\_: dial tcp 172.16.60.10:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

Pre-deployment validation of your download/upload connectivity wasn't successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_Post \\\\\\\_https://vcenter-server.com/nfc/unique-identifier/disk-0.vmdk\\\\\\\_: use of closed network connection.

Pre-deployment validation of your download/upload connectivity wasn't successful. {\\n  \\\_code\\\_: \\\_ImageProvisionError\\\_,\\n  \\\_message\\\_: \\\_Post \\\\\\\_https://vcenter-server.com/nfc/unique-identifier/disk-0.vmdk\\\\\\\_: dial tcp: lookup hostname.domain: no such host

Uma combinação desses erros geralmente indica que o computador de gerenciamento perdeu a conexão com o armazenamento de dados ou que um problema de rede faz com que o armazenamento de dados seja inacessível. Você precisa dessa conexão para carregar o OVA do computador de gerenciamento que cria a VM do dispositivo no vCenter.

Para corrigir o problema, restabeleça a conexão entre o computador de gerenciamento e o armazenamento de dados e tente implantar a ponte de recursos do Arc novamente.

Diferença de tempo causando a expiração do certificado x509.

Ao implantar o Arc resource bridge, você pode se deparar com o erro:

Error: { _errorCode_: _PostOperationsError_, _errorResponse_: _{\n\_message\_: \_{\\n  \\\_code\\\_: \\\_GuestInternetConnectivityError\\\_,\\n  \\\_message\\\_: \\\_Not able to connect to https://msk8s.api.cdp.microsoft.com. Error returned: action failed after 3 attempts: Get \\\\\\\_https://msk8s.api.cdp.microsoft.com\\\\\\\_: x509: certificate has expired or isn't yet valid: current time 2022-01-18T11:35:56Z is before 2023-09-07T19:13:21Z. Arc Resource Bridge network and internet connectivity validation failed: http-connectivity-test-arc. 1.  check your networking setup and ensure the URLs mentioned in : https://aka.ms/AAla73m are reachable from the Appliance VM.   2. Check firewall/proxy settings

Esse erro ocorre quando há uma diferença de tempo entre os hosts ESXi e o computador de gerenciamento que executa os comandos de implantação para a ponte de recursos do Arc. Para resolver esse problema, ative a sincronização de tempo NTP nos hosts ESXi, confirme se o computador de gerenciamento também está sincronizado com o NTP e tente a implantação novamente.

Erro de distorção de relógio entre a VM do dispositivo e o computador de gerenciamento

Se você encontrar um erro semelhante ao seguinte:

"ErrorCode": "PostOperationsError", "errorResponse": "{\n\"message\": \"{\\n  \\\"code\\\": \\\"ClockSkewError\\\",\\n  \\\"message\\\": \\\"The time in Appliance VM is too far behind in the past compared to Management Machine : Time in Appliance VM is 2025-02-24T10:59:59Z, time in Management Machine is 2025-02-24T16:49:13Z. Max allowed difference is 30m0s. Recommendation: Please verify that the time of the workstation machine and the appliance VM are in sync.

Esse erro ocorre quando há uma diferença de tempo entre os hosts ESXi e o computador de gerenciamento que executa os comandos de implantação para a ponte de recursos do Arc. Para resolver esse problema, ative a sincronização de tempo NTP nos hosts ESXi, confirme se o computador de gerenciamento também está sincronizado com o NTP e tente a implantação novamente.

Resolvido para várias redes

Ao implantar ou atualizar a ponte de recursos do Arc, você pode encontrar um erro semelhante a:

{ "ErrorCode": "PreflightcheckErrorOnPrem",
"ErrorDetails": "Upgrade Operation Failed with error: \"{\\n \\\"code\\\": \\\"PreflightcheckError\\\",\\n \\\"message\\\": \\\"{\\\\n \\\\\\\"code\\\\\\\": \\\\\\\"InvalidEntityError\\\\\\\",\\\\n \\\\\\\"message\\\\\\\": \\\\\\\"Cannot retrieve vSphere Network 'vmware-azure-arc-01': path 'vmware-azure-arc-01' resolves to multiple networks\\\\\\\",\\\\n \\\\\\\"category\\\\\\\": \\\\\\\"\\\\\\\"\\\\n }\\\",\\n \\\"category\\\": \\\"\\\"\\n }\"" }

Esse erro ocorre quando o segmento de rede vSphere é resolvido em várias redes, devido a diversos segmentos de rede vSphere usando o mesmo nome especificado no erro. Para corrigir esse erro, altere o nome de rede duplicado no vCenter (não na rede com a VM do dispositivo) ou implantar a ponte de recursos do Arc em uma rede diferente.

O status da ponte de recursos do Arc é desconectado

Ao executar o script inicial de integração do VMware habilitado para Arc, é solicitado que você forneça uma conta do vSphere. O script armazena essa conta localmente dentro da ponte de recursos do Arc como um segredo do Kubernetes criptografado. A ponte de recursos do Arc usa a conta para interagir com o vCenter.

Se a conta do vSphere armazenada localmente dentro da ponte de recursos expirar, o status da ponte de recursos do Arc poderá ser desconectado. Atualize as credenciais na ponte de recursos do Arc e no VMware habilitado para Arc seguindo as instruções de atualização de credenciais de conta do vSphere.

Erro durante a configuração do host

Se você estiver usando o mesmo modelo para implantar e excluir a ponte de recursos do Arc várias vezes, poderá encontrar o seguinte erro:

Appliance cluster deployment failed with error: Error: An error occurred during host configuration

Para resolver esse problema, exclua o modelo existente manualmente. Em seguida, execute az arcappliance prepare para baixar um novo modelo para implantação.

Não foi possível localizar pastas

Ao implantar a ponte de recursos arc no VMware, especifique a pasta na qual criar o modelo e a VM. A pasta selecionada deve ser do tipo pasta de VM e modelo. Você não pode usar outros tipos de pasta, como pastas de armazenamento, pastas de rede ou pastas de host e cluster, para a implantação da ponte de recursos.

Não é possível recuperar o recurso – recurso não encontrado ou não existe

Ao implantar a ponte de recursos do Arc, especifique onde implantar a VM do dispositivo como seu caminho de localização. Não é possível mover a VM do dispositivo desse caminho de localização. Se algum componente dentro desse caminho for alterado, como o armazenamento de dados ou o pool de recursos, a VM do dispositivo perderá seu Azure conexão. Se você alterar o local da ponte de recursos do Arc e tentar atualizar, poderá ver erros semelhantes aos seguintes:

{\n  \"code\": \"PreflightcheckError\",\n  \"message\": \"{\\n  \\\"code\\\": \\\"InvalidEntityError\\\",\\n  \\\"message\\\": \\\"Cannot retrieve <resource> 'resource-name': <resource> 'resource-name' not found\\\"\\n }\"\n }"

{\n  \"code\": \"PreflightcheckError\",\n  \"message\": \"{\\n  \\\"code\\\": \\\"InvalidEntityError\\\",\\n  \\\"message\\\": \\\"The specified vSphere Datacenter '/VxRail-Datacenter' does not exist\\\"\\n }\"\n }"

Para corrigir esses erros, use uma destas opções:

  • Mover a VM do dispositivo de volta para o local original dela e garantir que as credenciais do RBAC sejam atualizadas para a alteração de local.
  • Crie um recurso com o mesmo nome e, em seguida, mova a ponte de recursos do Arc para esse novo recurso, garantindo que você recrie o caminho de localização original.
  • Para o VMware habilitado para Arc, execute o script de recuperação de desastre do VMware habilitado para Arc. O script excluirá o dispositivo, implantará um novo dispositivo e reconectará o dispositivo com o local personalizado implantado anteriormente, a extensão de cluster e as VMs habilitadas para Arc.

Conta do vCenter bloqueada – Atualizar credenciais

A ponte de recursos arc usa a conta do vCenter que você fornece durante a implantação inicial para se conectar ao vCenter. Se você atualizar a conta do vCenter, mas não atualizar as informações de conta correspondentes na ponte de recursos do Arc, a conta poderá ser bloqueada. Para atualizar imediatamente as credenciais sem esperar o período de bloqueio expirar, execute o seguinte comando com o --skipWait sinalizador:

az arcappliance update-infracredentials vmware \
  --kubeconfig [REQUIRED] \
  --address [REQUIRED] \
  --username [REQUIRED] \
  --password [REQUIRED] \
  --skipWait

Se você precisar recuperar o kubeconfig, poderá executar o seguinte comando:

az arcappliance get-credentials \
  --resource-group [REQUIRED] \
  --name [REQUIRED] \
  --credentials-dir [OPTIONAL]

Observação

Talvez você também precise atualizar as credenciais do vCenter para a extensão de cluster VMware habilitada para Arc instalada na ponte de recursos do Arc. Para obter mais informações, consulte Atualizar as credenciais da conta do vSphere.

Privilégios insuficientes

Ao implantar ou atualizar a ponte de recursos no VMware vCenter, você poderá visualizar um erro semelhante a:

{  ""code"": ""PreflightcheckError"", ""message"": ""{\n  \""code\"": \""InsufficientPrivilegesError\"",\n  \""message\"": \""The provided vCenter account is missing required vSphere privileges on the resource 'root folder (MoRefId: Folder:group-d1)'. Missing privileges: [Sessions.ValidateSession].  add the privileges to the vCenter account and try again. To review the full list of required privileges, go to https://aka.ms/ARB-vsphere-privilege.\""\n }

Ao implantar a ponte de recursos do Arc, você fornece credenciais do vCenter. A ponte de recursos do Arc armazena essas credenciais do vCenter localmente para interagir com o vCenter. Para resolver o problema de privilégios ausentes, a conta do vCenter usada pela ponte de recursos precisa dos seguintes privilégios no VMware vCenter:

Armazenamento de dados:

  • Alocar espaço
  • Explorar banco de dados
  • Operações de arquivo de baixo nível

Pasta:

  • Criar uma pasta

Marcação do vSphere:

  • Atribuir ou cancelar atribuição de marca do vSphere

Rede:

  • Atribuir rede

Recurso:

  • Atribuir máquina virtual ao pool de recursos
  • Migrar máquina virtual desligada
  • Migrar máquina virtual ligada

Sessões:

  • Validar sessão

vApp:

  • Atribuir pool de recursos
  • Importar

Máquina virtual:

  • Alterar configuração
    • Adquirir concessão de disco
    • Adicionar disco existente
    • Adicionar disco novo
    • Adicionar ou remover dispositivo
    • Configuração avançada
    • Alterar contagem de CPU
    • Alterar memória
    • Alterar Configurações
    • Alterar recurso
    • Configurar o managedBy
    • Exibir configurações de conexão
    • Estender disco virtual
    • Modificar as configurações de dispositivo
    • Consultar compatibilidade de tolerância a falhas
    • Consultar arquivos sem dono
    • Recarregar a partir do caminho
    • Remover disco
    • Renomear
    • Redefinir informações de convidado
    • Definir anotação
    • Alternar o acompanhando de alteração de disco
    • Alternar bifurcação pai
    • Atualizar a compatibilidade da máquina virtual
  • Editar Inventário
    • Criar a partir de algo existente
    • Criar novo
    • Registrar-se
    • Remover
    • Cancelar o registro
  • Operações de convidado
    • Modificação de alias da operação de convidado
    • Modificações de operação de convidado
    • Execução de programa de operação de convidado
    • Consultas de operação de convidado
  • Interação
    • Conectar dispositivos
    • Interação do console
    • Gerenciamento do sistema operacional convidado por VIX API
    • Instalar ferramentas do VMware
    • Desligar
    • Ligar
    • Reiniciar
    • Suspender
  • Provisionamento
    • Permitir acesso ao disco
    • Permitir acesso a arquivos
    • Permitir acesso somente leitura ao disco
    • Permitir download de máquina virtual
    • Permitir upload de arquivos de máquina virtual
    • Clonar máquina virtual
    • Implantar modelo
    • Marcar como modelo
    • Marcar como máquina virtual
    • Personalizar convidado
  • Gerenciamento de instantâneo
    • Criar instantâneo
    • Remover instantâneo
    • Reverter para instantâneo

Próximas etapas

Compreender as operações de recuperação para a ponte de recursos nos cenários de desastre do VMware vSphere habilitado para Azure Arc

Se você não encontrar seu problema aqui ou não conseguir resolvê-lo, visite um dos seguintes canais para obter suporte:

  • Última atualização em