Solución de errores de instalación de la extensión de configuración de App de Azure

En este artículo se describen algunos escenarios de error comunes que pueden surgir al instalar o actualizar la extensión de configuración de App de Azure para Microsoft Azure Kubernetes Service (AKS).

Nota:

Si la extensión App de Azure Configuration se instaló correctamente, pero experimenta problemas al usarlo, consulte la guía de solución de problemas del proveedor de Kubernetes de configuración de App de Azure.

Escenario 1: App de Azure proveedor de Kubernetes de configuración ya está instalado

Intenta instalar la extensión de configuración de App de Azure para AKS, pero recibe un mensaje de error que indica que el proveedor de Kubernetes de configuración de App de Azure ya está instalado a través del helm install comando . El mensaje de error puede parecerse a cualquiera de los siguientes mensajes de error.

Mensaje 1

(ExtensionOperationFailed) Error en la operación de extensión con el siguiente error: Error: [ InnerError: [Error de instalación de Helm: recurso ya existente en el clúster : Recomendación elimine manualmente los recursos que existen actualmente en el clúster e inténtelo de nuevo. Para eliminar estos recursos, ejecute los siguientes comandos: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [manifiestos representados contienen un recurso que ya existe. No se puede continuar con la instalación: CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" en el espacio de nombres "" existe y no se puede importar en la versión actual: metadatos de propiedad no válidos; error de validación de anotación: la clave "meta.helm.sh/release-name" debe ser igual a "azureappconfig": el valor actual es "azureappconfiguration.kubernetesprovider"; error de validación de anotación: la clave "meta.helm.sh/release-namespace" debe ser igual a "kube-system": el valor actual es "azappconfig-system"]]] al realizar la operación : [Crear] en la configuración, Para la visita general de solución de problemas: https://aka.ms/k8s-extensions-TSG.

Mensaje 2

(ExtensionOperationFailed) Error en la operación de extensión con el siguiente error: Error: [ InnerError: [Error de instalación de Helm: recurso ya existente en el clúster : Recomendación elimine manualmente los recursos que existen actualmente en el clúster e inténtelo de nuevo. Para eliminar estos recursos, ejecute los siguientes comandos: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [manifiestos representados contienen un recurso que ya existe. No se puede continuar con la instalación: ServiceAccount "az-appconfig-k8s-provider" en el espacio de nombres "azappconfig-system" existe y no se puede importar en la versión actual: metadatos de propiedad no válidos; error de validación de anotación: la clave "meta.helm.sh/release-name" debe ser igual a "azureappconfig": el valor actual es "azureappconfiguration.kubernetesprovider"]]] al realizar la operación : [Crear] en la configuración, para la visita general de solución de problemas: https://aka.ms/k8s-extensions-TSG.

Solución 1: Desinstalar primero App de Azure proveedor de Kubernetes de configuración

Desinstale el proveedor de Kubernetes de configuración de App de Azure antes de instalar la extensión de configuración de App de Azure. Para obtener más información, consulte los Recursos de limpieza.

Escenario 2: La versión de la extensión de configuración de App de Azure de destino no existe

Al intentar instalar la extensión de configuración de App de Azure para tener como destino una versión específica, recibirá un mensaje de error que indica que la versión de configuración de App de Azure no existe:

(ExtensionOperationFailed) Error en la operación de extensión con el siguiente error: No se pudo resolver la versión de la extensión de los valores especificados. Consulte https://aka.ms/k8s-extension-type-versions para encontrar la versión correcta de la instalación. Para la solución de problemas general, visite : https://aka.ms/k8s-extensions-TSG.

Código: ExtensionOperationFailed

Mensaje: Error en la operación de extensión con el siguiente error: No se pudo resolver la versión de la extensión de los valores especificados. Consulte https://aka.ms/k8s-extension-type-versions para encontrar la versión correcta de la instalación. Para la solución de problemas general, visite : https://aka.ms/k8s-extensions-TSG.

Solución 2: Instalar de nuevo para una versión de extensión de configuración de App de Azure compatible

Pruebe volver a instalar la extensión. Asegúrese de usar una versión compatible de la extensión App de Azure Configuration.

Escenario 3: La versión de la extensión de configuración de App de Azure de destino existe, pero no en la región especificada.

Dado que App de Azure extensión configuration no está disponible en todas las regiones de AKS, es posible que reciba el siguiente mensaje de error:

(ExtensionTypeRegistrationGetFailed) El tipo de extensión microsoft.appconfiguration no está registrado en region-name<>.

Código: ExtensionTypeRegistrationGetFailed

Mensaje: El tipo de extensión microsoft.appconfiguration no está registrado en region-name <>

Solución 3: Instalar en una región diferente

Ejecute la instalación en una región que admita la extensión de clúster.

Pasos siguientes

Si sigue experimentando problemas de instalación, explore la guía de solución de problemas de AKS.

Ponte en contacto con nosotros para obtener ayuda

Si tiene preguntas o necesita ayuda, cree una solicitud de soporte o busque consejo en la comunidad de Azure. También puede enviar comentarios sobre el producto con los comentarios de la comunidad de Azure.