Resolución de errores al habilitar o deshabilitar Azure Arc en los clústeres de cargas de trabajo de AKS en AKS habilitados por Arc

Este error significa que no ha creado el clúster de carga de trabajo o que ha escrito incorrectamente el nombre del clúster de carga de trabajo.

Ejecute Get-AksHciCluster para asegurarse de que tiene el nombre correcto o de que el clúster que desea conectar a Arc existe.

Puede producirse el siguiente error al usar Windows Admin Center para crear un clúster de carga de trabajo y conectarlo a Kubernetes habilitado para Arc:

System.Management.Automation.RemoteException Starting onboarding process Cluster "azure-arc-onboarding" set. User "azure-arc-onboarding" set. Context "azure-arc-onboarding" created. Switched to context "azure-arc-onboarding". Azure login az login: error: argument --password/-p: expected one argument usage: az login [-h] [--verbose] [--debug] [--only-show-errors] [--output {json,jsonc,yaml,yamlc,table,tsv,none}] [--query JMESPATH] [--username USERNAME] [--password PASSWORD] [--service-principal] [--tenant TENANT] [--allow-no-subscriptions] [-i] [--use-device-code] [--use-cert-sn-issuer] : Job Failed Condition]

Para resolver este problema, revise las opciones siguientes:

• Opción 1: Elimine el clúster de carga de trabajo y pruebe a usar de nuevo Windows Admin Center.
• Opción 2: En PowerShell, compruebe si el clúster se ha creado correctamente mediante la ejecución del comando Get-AksHciCluster y, a continuación, use Enable-AksHciArcConnection para conectar el clúster a Arc.

Al usar Connect-AzAccount para iniciar sesión en Azure, es posible que establezca una suscripción diferente como contexto predeterminado que el que proporcionó como entrada en Set-AksHciRegistration. Al ejecutar Enable-AksHciArcConnection posteriormente, el comando espera la suscripción usada en Set-AksHciRegistration. Sin embargo, Enable-AksHciArcConnection obtiene el conjunto de suscripciones predeterminado mediante Connect-AzAccount y, por lo tanto, podría producir un error.

Para evitar este error, siga una de las opciones siguientes:

• Opción 1: Ejecute Set-AksHciRegistration para iniciar sesión en Azure con los mismos parámetros (suscripción y grupo de recursos) que usó cuando ejecutó por primera vez el comando para conectar el host de AKS a Azure para la facturación. A continuación, puede usar Enable-AksHciArcConnection -Name <ClusterName> con los valores predeterminados y el clúster se conectará a Arc en la suscripción y el grupo de recursos de facturación del host de AKS.

• Opción 2: Ejecute Enable-AksHciArcRegistration con los parámetros subscription, resource group, location, tenant y secret para conectar el clúster a Azure Arc en una suscripción y un grupo de recursos diferentes a los del host de AKS. También debe ejecutar Enable-AksHciArcRegistration si no tiene permisos suficientes para conectar el clúster a Azure Arc mediante su cuenta de Azure (por ejemplo, si no es el propietario de la suscripción).

Este error suele indicar uno de los siguientes problemas:

• Los clústeres se crearon en una máquina virtual de Azure en un entorno virtualizado o se implementaron AKS en Azure Stack HCI en varios niveles de virtualización.
• Un internet lento provocó el tiempo de espera.

Si uno de los escenarios anteriores se aplica, ejecute Disable-AksHciArcConnection e intente conectarse de nuevo. Si el escenario anterior no se aplica, abra un problema de soporte técnico para AKS en Azure Stack HCI.

Este error indica que no se ha podido contactar con el servidor de API de Kubernetes.

Pruebe a ejecutar el comando Disable-AksHciArcConnection de nuevo y, a continuación, vaya a Azure Portal para confirmar que el recurso connectedCluster se ha eliminado realmente. También puede ejecutar kubectl get ns -A para confirmar que el espacio de nombres azure-arc no existe en el clúster.

Si habilita las características de conexión de clúster y ubicación personalizada en un clúster de AKS que está conectado a Azure Arc, es posible que vea el siguiente error:

Error while updating agents for enabling features. Please run "kubectl get pods -n azure-arc" to check the pods in case of timeout error. Error: Error: UPGRADE FAILED: timed out waiting for the condition

Se trata de un problema conocido de la versión de septiembre y se ha corregido en la versión de octubre. Los nuevos clústeres de AKS creados con la versión de octubre y conectados a Arc mediante Enable-AksHciArcConnection no experimentan este problema. Actualice la implementación de AKS Arc a la versión de octubre y vuelva a conectar los clústeres existentes a Arc para obtener una solución alternativa a este problema.

Este error significa que las credenciales de inicio de sesión en Azure han expirado.

Use Set-AksHciRegistration para iniciar sesión en Azure antes de volver a ejecutar el comando Enable-AksHciArcConnection. Al volver a ejecutar Set-AksHciRegistration, asegúrese de usar los mismos datos de suscripción y grupo de recursos que usó cuando registró por primera vez el host de AKS en Azure para la facturación. Si vuelve a ejecutar el comando con una suscripción o un grupo de recursos diferentes, no se registrarán. Una vez establecida la suscripción y el grupo de recursos en Set-AksHciRegistration, no se pueden cambiar sin desinstalar AKS Arc.

Este error indica que el clúster de carga de trabajo no sigue la convención de nomenclatura de Kubernetes.

Como sugiere el error, asegúrese de que el nombre del clúster esté en minúsculas y coincida con el patrón de expresión regular: '^[a-z0-9][a-z0-9-]*[a-z0-9]$'.

Este error suele significar que ya ha conectado el clúster de AKS a Kubernetes habilitado para Arc. Para confirmar que está conectado, vaya a Azure Portal y compruebe en la suscripción y el grupo de recursos que proporcionó al ejecutar Set-AksHciRegistration (si ha usado valores predeterminados) o Enable-AksHciArcConnection (si no ha usado valores predeterminados). También puede confirmar si su clúster de AKS en Azure Stack HCI está conectado a Azure mediante la ejecución del comando az connectedk8s show de la CLI de Azure. Si no ve el clúster de carga de trabajo, ejecute Disable-AksHciArcConnection e inténtelo de nuevo.

El error siguiente significa que Azure no ha podido encontrar el recurso de ARM connectedCluster asociado al clúster:

autorest/azure: Service returned an error. Status=404 Code="ResourceNotFound" Message="The Resource 'Microsoft.Kubernetes/connectedClusters/my-workload-cluster' under resource group 'AKS-HCI2' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix"]

Puede encontrar este error si:

• Ha proporcionado un grupo de recursos o una suscripción incorrectos al ejecutar el cmdlet Disable-AksHciArcConnection.
• Ha eliminado manualmente el recurso en Azure Portal.
• ARM no puede encontrar el recurso de Azure.

Para resolver este error, como se indica en el mensaje de error, consulte Solución de errores de recurso no encontrado.

Este error suele significar que ya ha desinstalado agentes de Arc del clúster de carga de trabajo o que ha eliminado manualmente el espacio de nombres azure-arc mediante el comando kubectl.

Vaya a Azure Portal para confirmar que no tiene ningún recurso filtrado. Por ejemplo, compruebe que no se vea un recurso connectedCluster en la suscripción ni el grupo de recursos.

Puede encontrar este problema si no ha configurado la suscripción de Azure con los proveedores de recursos de Kubernetes habilitados para Arc. Actualmente se comprueba que Microsoft.Kubernetes y Microsoft.KubernetesConfiguration están configurados.

Para más información sobre cómo habilitar estos proveedores de recursos, consulte Registro de proveedores para Kubernetes habilitado para Arc.

Pasos siguientes

• Solución de problemas de Kubernetes habilitado para Azure Arc
• Problemas conocidos