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 para 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 revisar os problemas conhecidos aqui ou seguir a visão geral da solução de problemas para relatar bugs ou fornecer feedback sobre o produto.

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

Ponte de Recursos do Arco

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 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 da ponte <de recursos associado a este vCenter não está disponível no momento. As operações executadas neste vCenter podem falhar como resultado", isso 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 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 do 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 extraídas 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 comando, você pode prosseguir com a az arcappliance get-credentials 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 do dispositivo, o az arcappliance logs vmware comando não será útil e o arquivo de chave de log não será gerado.

Problemas quando o Arc Resource Bridge está em execução

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

  • Se você tiver o kubeconfig para seu dispositivo e a VM do 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 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, o gerenciador do Hyper-V, para localizar o endereço IP da VM do dispositivo). Observe que o parâmetro ainda é necessário, kubeconfig mas pode ser passado como uma string 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 da CLI do 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 do cluster físico.

  • Verifique se você tem a CLI do Az executando az -vo .
  • 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: esse 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 <atual time1> é anterior à <hora2>. Falha na verificação

  • Causa raiz: esse 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 a hora na VM corresponde à hora na máquina usada para a implantação do ARB.
    2. Conecte o servidor ESXi a um servidor NTP para sincronizar seu horário 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: 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 do Arc Resource Bridge.
    2. Execute .temp\.env\Scripts\Activate.ps1 para instalar o Python venv.

Próximas etapas