Compartir a través de

Guía de solución de problemas de problemas en AKS habilitados por Azure Arc en VMware

  • Artículo

Se aplica a: AKS habilitado por Azure Arc en VMware (versión preliminar)

En este artículo se describen los pasos de solución de problemas conocidos y errores que pueden producirse al implementar AKS habilitado por Azure Arc en la versión preliminar de VMware. También puede revisar los problemas conocidos aquí o seguir la información general de solución de problemas para notificar errores o proporcionar comentarios sobre el producto.

Esta página se actualiza continuamente, así que vuelva aquí para obtener información nueva. A medida que identificamos problemas críticos que requieren soluciones alternativas, los agregamos. Revise detenidamente esta información antes de implementar AKS Arc en la versión preliminar de VMware.

Puente de recursos de Arc

Problemas de puente de recursos de Azure Arc

Para ver los problemas de puente de recursos de Azure Arc, consulte la guía de solución de problemas aquí.

Recuperación de implementaciones con errores de Arc Resource Bridge

Consulte la guía de solución de problemas aquí.

Conexión de vCenter a Azure

Si hay un mensaje de error que indica que el nombre> del puente de recursos del puente <de recursos asociado a este vCenter no está disponible actualmente. Las operaciones realizadas en este vCenter pueden producir un error como resultado", indica que el puente de recursos usado para conectar vCenter está inactivo o eliminado.

Para solucionar el problema, siga estos pasos:

Recopilación de registros

Si tiene problemas, puede compartir los archivos de registro y la versión de la CLI con ingenieros de soporte técnico con fines de depuración.

Problemas antes de la implementación de Arc Resource Bridge

Recupere el archivo kva.log del sistema en c:\programdata\kva\kva.log para obtener información más detallada.

Problemas durante la implementación de Arc Resource Bridge

Para recopilar los registros, ejecute los siguientes comandos de la máquina que usó anteriormente para intentar la implementación del puente de recursos de Arc. A partir de la versión 1.0.0 de la CLI, primero debe ejecutar el comando az arcappliance get-credentials. Esto garantiza que todas las credenciales necesarias para la recopilación de registros se extraen en la máquina. Para obtener más información sobre este comando, consulte la documentación de la CLI:

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

Después de ejecutar el az arcappliance get-credentials comando, puede continuar con la recopilación de registros mediante el 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>

Si aún no ha creado una máquina virtual del dispositivo, el az arcappliance logs vmware comando no es útil y el archivo de clave de registro no se genera.

Problemas cuando Arc Resource Bridge está en funcionamiento

Para recopilar los registros, ejecute el az arcappliance logs vmware comando desde la misma máquina que usó para implementar Arc Resource Bridge:

  • Si tiene kubeconfig para el dispositivo y la máquina virtual del dispositivo se ejecuta con un servidor de API accesible, el siguiente comando recopila registros del dispositivo y genera un archivo .zip en el directorio de trabajo actual:

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

  • Si no tiene kubeconfig o el servidor de API no es accesible, el siguiente comando recopila registros mediante la dirección IP de la máquina virtual del dispositivo especificada (compruebe el tejido de virtualización; por ejemplo, el administrador de Hyper-V, para buscar la dirección IP de la máquina virtual del dispositivo). Tenga en cuenta que el kubeconfig parámetro sigue siendo necesario, pero se puede pasar como una cadena vacía si también se proporciona una dirección IP:

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

Ejemplos con valores rellenados

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

Obtención de la versión de la extensión de la CLI

Para devolver la versión de la extensión de la CLI del dispositivo, ejecute el siguiente comando:

az extension show --name arcappliance -o table

Debe tener instalada una versión reciente de la CLI de Az en todos los nodos del clúster físico.

  • Para comprobar que tiene la CLI de Az, ejecute az -v.
  • Actualice a la versión más reciente ejecutando az upgrade.

Mensajes de error y pasos de solución de problemas

En esta sección se proporciona una lista de mensajes de error comunes y sus pasos de solución de problemas.

Error: "AlreadyDeployedError"

  • Causa principal: este error se produce porque el entorno no se ha limpiado de la implementación anterior antes de intentar realizar la implementación de nuevo.
  • Solución: para resolver este problema, desinstale Arc Resource Bridge e intente implementar de nuevo.

Error: x509: el certificado ha expirado o aún no es válido: la hora <actual1> es anterior a <la hora 2>. Error de comprobación

  • Causa principal: este error se produce cuando los certificados expiran debido a una discrepancia de tiempo entre la máquina cliente y la máquina virtual (o el servidor ESXi). Uno de ellos no está habilitado para NTP.
  • Solución:
    1. Compruebe si la hora de la máquina virtual coincide con la hora en la máquina que usó para la implementación de ARB.
    2. Conecte el servidor ESXi a un servidor NTP para sincronizar su hora y resolver el problema.

Error: El término "az" no se reconoce como el nombre de un cmdlet, una función, un archivo de script o un programa operable. Compruebe la ortografía del nombre, o si se ha incluido una ruta de acceso, compruebe que la ruta de acceso es correcta e inténtelo de nuevo.

  • Causa principal: la CLI de Az no se reconoce porque se cerró la ventana anterior de PowerShell y no se sincronizó con la instalación de la CLI de Azure.
  • Solución:
    1. Abra una nueva ventana de PowerShell y vaya a la carpeta donde almacenó el script de incorporación de Arc Resource Bridge.
    2. Ejecute .temp\.env\Scripts\Activate.ps1 para instalar Python venv.

Pasos siguientes