Résoudre les erreurs d’installation de l’extension Azure App Configuration
Cet article décrit certains scénarios d’erreur courants que vous pouvez rencontrer lorsque vous installez ou mettez à jour l’extension Azure App Configuration pour Microsoft Azure Kubernetes Service (AKS).
Note
Si l’extension Azure App Configuration a été correctement installée, mais que vous rencontrez des problèmes lors de son utilisation, consultez le guide de résolution des problèmes du fournisseur Kubernetes Azure App Configuration.
Scénario 1 : Le fournisseur Kubernetes Azure App Configuration est déjà installé
Vous essayez d’installer l’extension Azure App Configuration pour AKS, mais vous recevez un message d’erreur indiquant que le fournisseur Kubernetes Azure App Configuration est déjà installé via la helm install commande. Le message d’erreur peut ressembler à l’un des messages d’erreur suivants.
Message 1
(ExtensionOperationFailed) L’opération d’extension a échoué avec l’erreur suivante : [ InnerError : [Échec de l’installation Helm : Ressource déjà existante dans votre cluster : Recommandation Supprimer manuellement les ressources qui existent actuellement dans votre cluster et réessayez d’installer. Pour supprimer ces ressources, exécutez les commandes suivantes :
kubectl delete {resource type} -n {resource namespace} {resource name}InnerError [manifestes rendus contiennent une ressource qui existe déjà. Impossible de poursuivre l’installation : CustomResourceDefinition « azureappconfigurationproviders.azconfig.io » dans l’espace de noms « » existe et ne peut pas être importé dans la version actuelle : métadonnées de propriété non valides ; Erreur de validation d’annotation : la clé « meta.helm.sh/release-name » doit être égale à « azureappconfig » : la valeur actuelle est « azureappconfiguration.kubernetesprovider » ; Erreur de validation d’annotation : la clé « meta.helm.sh/release-namespace » doit être égale à « kube-system » : la valeur actuelle est « azappconfig-system »]]] s’est produite lors de l’opération : [Créer] dans la configuration, pour une visite de dépannage générale : https://aka.ms/k8s-extensions-TSG.
Message 2
(ExtensionOperationFailed) L’opération d’extension a échoué avec l’erreur suivante : [ InnerError : [Échec de l’installation Helm : Ressource déjà existante dans votre cluster : Recommandation Supprimer manuellement les ressources qui existent actuellement dans votre cluster et réessayez d’installer. Pour supprimer ces ressources, exécutez les commandes suivantes :
kubectl delete {resource type} -n {resource namespace} {resource name}InnerError [manifestes rendus contiennent une ressource qui existe déjà. Impossible de poursuivre l’installation : ServiceAccount « az-appconfig-k8s-provider » dans l’espace de noms « azappconfig-system » existe et ne peut pas être importé dans la version actuelle : métadonnées de propriété non valides ; Erreur de validation d’annotation : la clé « meta.helm.sh/release-name » doit être égale à « azureappconfig » : la valeur actuelle est « azureappconfiguration.kubernetesprovider »]]] s’est produite lors de l’opération : [Créer] sur la configuration, pour une visite de dépannage générale : https://aka.ms/k8s-extensions-TSG.
Solution 1 : Désinstaller d’abord le fournisseur Kubernetes Azure App Configuration
Désinstallez le fournisseur Kubernetes Azure App Configuration avant d’installer l’extension Azure App Configuration. Pour plus d’informations, consultez Nettoyer les ressources.
Scénario 2 : La version d’extension Azure App Configuration ciblée n’existe pas
Lorsque vous essayez d’installer l’extension Azure App Configuration pour cibler une version spécifique, vous recevez un message d’erreur indiquant que la version d’Azure App Configuration n’existe pas :
(ExtensionOperationFailed) L’opération d’extension a échoué avec l’erreur suivante : échec de la résolution de la version de l’extension à partir des valeurs données. Reportez-vous https://aka.ms/k8s-extension-type-versions à la version correcte de votre installation. Pour obtenir la résolution des problèmes généraux, consultez : https://aka.ms/k8s-extensions-TSG.
Code : ExtensionOperationFailed
Message : Échec de l’opération d’extension avec l’erreur suivante : échec de la résolution de la version de l’extension à partir des valeurs données. Reportez-vous https://aka.ms/k8s-extension-type-versions à la version correcte de votre installation. Pour obtenir la résolution des problèmes généraux, consultez : https://aka.ms/k8s-extensions-TSG.
Solution 2 : Réinstaller pour une version d’extension Azure App Configuration prise en charge
Réinstallez d’installer l’extension. Veillez à utiliser une version prise en charge de l’extension Azure App Configuration.
Scénario 3 : La version ciblée de l’extension Azure App Configuration existe, mais pas dans la région spécifiée
Étant donné que l’extension Azure App Configuration n’est pas disponible dans toutes les régions AKS, vous pouvez recevoir le message d’erreur suivant :
(ExtensionTypeRegistrationGetFailed) Le type d’extension microsoft.appconfiguration n’est pas inscrit dans le nom> de région<.
Code : ExtensionTypeRegistrationGetFailed
Message : Le type d’extension microsoft.appconfiguration n’est pas inscrit dans le nom de région <>
Solution 3 : Installer dans une autre région
Exécutez l’installation dans une région prise en charge par l’extension de cluster.
Prochaines étapes
Si vous rencontrez toujours des problèmes d’installation, explorez le guide de résolution des problèmes AKS.
Contactez-nous pour obtenir de l’aide
Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.