Compartilhar via

Guia de solução de problemas no AKS habilitado pelo Azure Arc no VMware

  • Artigo

Aplica-se a: AKS habilitado pelo Azure Arc no VMware (versão prévia)

Este artigo descreve as etapas de solução de problemas conhecidos e erros que podem ocorrer ao implantar o AKS habilitado pelo Azure Arc na versão prévia do VMware. Você também pode examinar os problemas conhecidos aqui ou seguir a visão geral da solução de problemas para relatar bugs ou fornecer comentários sobre o produto.

Esta página é atualizada continuamente, portanto, marcar aqui para obter novas informações. À medida que identificamos problemas críticos que exigem soluções alternativas, os adicionamos. Examine essas informações cuidadosamente antes de implantar o AKS Arc na versão prévia do VMware.

Ponte de Recursos do Arc

Problemas de ponte de recursos do Azure Arc

Para problemas de ponte de recursos do Azure Arc, consulte o guia de solução de problemas aqui.

Recuperar-se de implantações com falha da Ponte de Recursos do Arc

Consulte o guia de solução de problemas aqui.

Conexão do vCenter com o Azure

Se houver uma mensagem de erro informando "O nome> da ponte de recursos da ponte <de recursos associado a este vCenter está indisponível no momento. As operações executadas neste vCenter podem falhar como resultado", indica que a ponte de recursos usada para conectar o vCenter está inativa ou excluída.

Para resolver o problema, siga estas etapas:

Coletar logs

Se você encontrar problemas, poderá compartilhar os arquivos de log e a versão da CLI com engenheiros de suporte para fins de depuração.

Problemas antes da implantação da Ponte de Recursos do Arc

Recupere o arquivo de kva.log do sistema em c:\programdata\kva\kva.log para obter informações mais detalhadas.

Problemas durante a implantação da Ponte de Recursos do Arc

Para coletar os logs, execute os comandos a seguir do computador usado anteriormente para tentar a implantação da ponte de recursos do Arc. A partir da CLI versão 1.0.0, primeiro você deve executar o comando az arcappliance get-credentials. Isso garante que todas as credenciais necessárias para a coleta de logs sejam extraídas para o computador. Para obter mais informações sobre esse comando, consulte a documentação da CLI:

az arcappliance get-credentials –name <name of Arc Resource Bridge> --resource-group <name of resource group>

Depois de executar o az arcappliance get-credentials comando, você pode prosseguir com a coleta de logs usando o az arcappliance logs vmware comando :

az arcappliance logs vmware --ip <Arc Resource Bridge VM control plane IP endpoint> --address <vCenter FQDN/IP address, same one used when creating config files> --username <vcenter username> --password <vcenter password>

Se você ainda não criou uma VM dispositivo, o az arcappliance logs vmware comando não será útil e o arquivo de chave de log não será gerado.

Problemas quando a Ponte de Recursos do Arc está em execução

Para coletar os logs, execute o az arcappliance logs vmware comando do mesmo computador usado para implantar a Ponte de Recursos do Arc:

  • Se você tiver o kubeconfig para seu dispositivo e a VM dispositivo estiver em execução com um servidor de API acessível, o comando a seguir coletará logs do dispositivo e gerará um arquivo .zip no diretório de trabalho atual:

    az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'

  • Se você não tiver o kubeconfig ou o servidor de API estiver inacessível, o comando a seguir coletará logs usando o endereço IP da VM dispositivo especificado (marcar sua malha de virtualização; por exemplo, o gerenciador do Hyper-V, para localizar o endereço IP da VM dispositivo). Observe que o kubeconfig parâmetro ainda é necessário, mas pode ser passado como uma cadeia de caracteres vazia se um IP também for fornecido:

    az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'

Exemplos com valores preenchidos

az arcappliance logs vmware --kubeconfig .\resourcebridge\kubeconfig
az arcappliance logs vmware --kubeconfig='kubeconfig'
az arcappliance logs vmware --kubeconfig='' --ip=10.0.1.166

Obter a versão da extensão da CLI

Você pode retornar a versão da extensão da CLI dispositivo executando o seguinte comando:

az extension show --name arcappliance -o table

Você deve ter uma versão recente da CLI do Az instalada em todos os nós no cluster físico.

  • Verifique se você tem a CLI do Az executando az -v.
  • Atualize para a versão mais recente executando az upgrade.

Mensagens de erro e etapas de solução de problemas

Esta seção fornece uma lista de mensagens de erro comuns e suas etapas de solução de problemas.

Erro: "AlreadyDeployedError"

  • Causa raiz: esse erro ocorre porque o ambiente não foi limpo da implantação anterior antes de tentar implantar novamente.
  • Resolução: para resolve esse problema, desinstale a Ponte de Recursos do Arc e tente implantar novamente.

Erro: x509: o certificado expirou ou ainda não é válido: a hora <atual1> é anterior à <hora2>. Falha na verificação

  • Causa raiz: esse erro ocorre quando os certificados expiram devido a uma incompatibilidade de tempo entre o computador cliente e a VM (ou servidor ESXi). Um deles não está habilitado para NTP.
  • Resolução:
    1. Verifique se a hora na VM corresponde à hora no computador usado para implantação do ARB.
    2. Conecte o servidor ESXi a um servidor NTP para sincronizar sua hora e resolve o problema.

Erro: o termo 'az' não é reconhecido como o nome de um cmdlet, função, arquivo de script ou programa operável. Verifique a ortografia do nome ou, se um caminho foi incluído, verifique se o caminho está correto e tente novamente

  • Causa raiz: a CLI do Az não é reconhecida porque a janela anterior do PowerShell foi fechada e não foi sincronizada com a instalação da CLI do Azure.
  • Resolução:
    1. Abra uma nova janela do PowerShell e navegue até a pasta em que você armazenou o script de integração da Ponte de Recursos do Arc.
    2. Execute .temp\.env\Scripts\Activate.ps1 para instalar o Python venv.

Próximas etapas