Partilhar via

Guia de resolução de problemas no AKS ativado pelo Azure Arc no VMware

  • Artigo

Aplica-se a: AKS ativado pelo Azure Arc no VMware (pré-visualização)

Este artigo descreve os passos de resolução de problemas para problemas conhecidos e erros que podem ocorrer ao implementar o AKS ativado pelo Azure Arc na pré-visualização do VMware. Também pode rever os problemas conhecidos aqui ou seguir a descrição geral da resolução de problemas para comunicar erros ou fornecer comentários sobre produtos.

Esta página é continuamente atualizada, por isso, volte aqui para obter novas informações. À medida que identificamos problemas críticos que requerem soluções, adicionamo-los. Reveja estas informações cuidadosamente antes de implementar a pré-visualização do AKS Arc no VMware.

Ponte de Recursos do Arc

Problemas da bridge de recursos do Azure Arc

Para problemas com a bridge de recursos do Azure Arc, veja o guia de resolução de problemas aqui.

Recuperar de implementações falhadas da Bridge de Recursos do Arc

Veja o guia de resolução de problemas aqui.

Ligação do vCenter ao Azure

Se existir uma mensagem de erro a indicar "O nome> da bridge de recursos da bridge <de recursos associado a este vCenter está atualmente indisponível. As operações realizadas neste vCenter podem falhar como resultado", indica que a bridge de recursos utilizada para ligar o vCenter está inativa ou eliminada.

Para resolver o problema, siga estes passos:

Recolher registos

Se encontrar problemas, pode partilhar os ficheiros de registo e a versão da CLI com os engenheiros de suporte para fins de depuração.

Problemas antes da implementação da Bridge de Recursos do Arc

Obtenha o ficheiro kva.log do sistema em c:\programdata\kva\kva.log para obter mais informações verbosas.

Problemas durante a implementação da Bridge de Recursos do Arc

Para recolher os registos, execute os seguintes comandos a partir do computador que utilizou anteriormente para tentar a implementação da bridge de recursos do Arc. A partir da versão 1.0.0 da CLI, primeiro tem de executar o comando az arcappliance get-credentials. Isto garante que todas as credenciais necessárias para a recolha de registos são puxadas para o computador. Para obter mais informações sobre este comando, veja 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, pode prosseguir com a recolha de registos com 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 ainda não criou uma VM da aplicação, o az arcappliance logs vmware comando não é útil e o ficheiro de chave de registo não é gerado.

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

Para recolher os registos, execute o comando aaz arcappliance logs vmware partir do mesmo computador que utilizou para implementar a Bridge de Recursos do Arc:

  • Se tiver o kubeconfig para a aplicação e a VM da aplicação estiver em execução com um servidor de API acessível, o comando seguinte recolhe registos da aplicação e produz um ficheiro de .zip no diretório de trabalho atual:

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

  • Se não tiver o kubeconfig ou o servidor de API estiver inacessível, o comando seguinte recolhe registos com o endereço IP da VM da aplicação especificada (verifique os recursos de infraestrutura de virtualização; por exemplo, o gestor de Hyper-V, para localizar o endereço IP da VM da aplicação). Tenha em atenção que o kubeconfig parâmetro ainda é necessário, mas pode ser transmitido como uma cadeia vazia se também for fornecido um IP:

    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

Pode devolver a versão da extensão da CLI da aplicação ao executar o seguinte comando:

az extension show --name arcappliance -o table

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

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

Mensagens de erro e passos de resolução de problemas

Esta secção fornece uma lista de mensagens de erro comuns e os respetivos passos de resolução de problemas.

Erro: "AlreadyDeployedError"

  • Causa: este erro ocorre porque o ambiente não foi limpo da implementação anterior antes de tentar implementar novamente.
  • Resolução: para resolver este problema, desinstale a Bridge de Recursos do Arc e, em seguida, tente implementar 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 um erro de correspondência de tempo entre o computador cliente e a VM (ou servidor ESXi). Um deles não está ativado para NTP.
  • Resolução:
    1. Verifique se a hora na VM corresponde à hora no computador que utilizou para a implementação do ARB.
    2. Ligue o servidor ESXi a um servidor NTP para sincronizar a hora e resolver o problema.

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

  • Causa principal: 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 para a pasta onde armazenou o script de inclusão da Bridge de Recursos do Arc.
    2. Execute .temp\.env\Scripts\Activate.ps1 para instalar o Python venv.

Passos seguintes