Partilhar 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 (visualização)

Este artigo descreve as etapas de solução de problemas para problemas e erros conhecidos que podem ocorrer ao implantar o AKS habilitado pelo Azure Arc na visualização do VMware. Você também pode revisar 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 é continuamente atualizada, por isso volte aqui para novas informações. À medida que identificamos problemas críticos que exigem soluções alternativas, adicionamo-los. Por favor, revise essas informações cuidadosamente antes de implantar seu AKS Arc na visualização VMware.

Ponte de recursos do arco

Problemas da 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 de implantações com falha do Arc Resource Bridge

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 de ponte <de recursos associado a este vCenter está indisponível no momento. As operações realizadas 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 estes passos:

  • Se o Arc Resource Bridge for excluído, implante-o novamente.
  • Se o Arc Resource Bridge estiver inativo (offline), execute as etapas de recuperação de desastres listadas em Executar operações de recuperação de desastres - Azure Arc.

Recolher registos

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 do Arc Resource Bridge

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

Problemas durante a implantação do Arc Resource Bridge

Para coletar os logs, execute os seguintes comandos da máquina que você usou anteriormente para tentar a implantação da ponte de recursos Arc. A partir da CLI versão 1.0.0, você deve primeiro executar o comando az arcappliance get-credentials. Isso garante que todas as credenciais necessárias para a coleta de logs sejam puxadas para a máquina. 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 continuar 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 de dispositivo, o az arcappliance logs vmware comando não é útil e o arquivo de chave de log não é gerado.

Problemas quando o Arc Resource Bridge está em funcionamento

Para coletar os logs, execute o comando da mesma máquina usada para implantar o az arcappliance logs vmware Arc Resource Bridge:

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

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

  • Se você não tiver o kubeconfig ou se o servidor de API estiver inacessível, o comando a seguir coletará logs usando o endereço IP da VM do dispositivo especificado (verifique sua malha de virtualização; por exemplo, Gerenciador do Hyper-V, para localizar o endereço IP da VM do 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 CLI

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

az extension show --name arcappliance -o table

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

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

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: este erro ocorre porque o ambiente não foi limpo da implantação anterior antes de tentar implantar novamente.
  • Resolução: para resolver esse problema, desinstale o Arc Resource Bridge 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: este erro ocorre quando os certificados expiram devido a uma incompatibilidade de tempo entre a máquina cliente e a VM (ou servidor ESXi). Um deles não é habilitado para NTP.
  • Resolução:
    1. Verifique se o tempo na VM corresponde ao tempo na máquina que você usou para a implantação do ARB.
    2. Conecte o servidor ESXi a um servidor NTP para sincronizar seu tempo e resolver 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: Az CLI não é reconhecida porque a janela anterior do PowerShell foi fechada e não sincronizou com a instalação da CLI do Azure.
  • Resolução:
    1. Abra uma nova janela do PowerShell e navegue até a pasta onde você armazenou o script de integração do Arc Resource Bridge.
    2. Execute .temp\.env\Scripts\Activate.ps1 para instalar o Python venv.

Próximos passos