Beheben von Fehlern bei der Installation von Konfigurationserweiterungen Azure-App

In diesem Artikel werden einige häufige Fehlerszenarien erläutert, die beim Installieren oder Aktualisieren der Azure-App Konfigurationserweiterung für Microsoft Azure Kubernetes Service (AKS) auftreten können.

Notiz

Wenn die Azure-App Konfigurationserweiterung erfolgreich installiert wurde, sie aber probleme bei der Verwendung auftreten, finden Sie im Handbuch zur Problembehandlung von Azure-App Configuration Kubernetes Provider.

Szenario 1: Azure-App Konfigurations-Kubernetes-Anbieter ist bereits installiert

Sie versuchen, die Azure-App Konfigurationserweiterung für AKS zu installieren, aber Sie erhalten eine Fehlermeldung, die angibt, dass der Azure-App Configuration Kubernetes Provider bereits über den helm install Befehl installiert ist. Die Fehlermeldung kann einer der folgenden Fehlermeldungen ähneln.

Nachricht 1

(ExtensionOperationFailed) Fehler beim Erweiterungsvorgang: [ InnerError: [ InnerError: [Helm installation failed : Resource already existing in your cluster : Recommendation Manually delete the resource(s) that currently exist in your cluster and try installation again. Um diese Ressourcen zu löschen, führen Sie die folgenden Befehle aus: kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [gerenderte Manifeste enthalten eine Ressource, die bereits vorhanden ist. Die Installation kann nicht fortgesetzt werden: CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" im Namespace "" ist vorhanden und kann nicht in die aktuelle Version importiert werden: ungültige Besitzermetadaten; Fehler bei der Anmerkungsüberprüfung: Schlüssel "meta.helm.sh/release-name" muss gleich "azureappconfig" sein: Der aktuelle Wert lautet "azureappconfiguration.kubernetesprovider"; Fehler bei der Anmerkungsüberprüfung: Schlüssel "meta.helm.sh/release-namespace" muss gleich "kube-system" sein: Der aktuelle Wert ist "azappconfig-system"]]] ist beim Ausführen des Vorgangs aufgetreten: [Erstellen] in der Konfiguration, Allgemeine Problembehandlung: https://aka.ms/k8s-extensions-TSG.

Nachricht 2

(ExtensionOperationFailed) Fehler beim Erweiterungsvorgang: [ InnerError: [ InnerError: [Helm installation failed : Resource already existing in your cluster : Recommendation Manually delete the resource(s) that currently exist in your cluster and try installation again. Um diese Ressourcen zu löschen, führen Sie die folgenden Befehle aus: kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [gerenderte Manifeste enthalten eine Ressource, die bereits vorhanden ist. Die Installation kann nicht fortgesetzt werden: ServiceAccount "az-appconfig-k8s-provider" im Namespace "azappconfig-system" ist vorhanden und kann nicht in die aktuelle Version importiert werden: ungültige Besitzmetadaten; Fehler bei der Anmerkungsüberprüfung: Schlüssel "meta.helm.sh/release-name" muss gleich "azureappconfig" sein: Der aktuelle Wert ist "azureappconfiguration.kubernetesprovider"]]] beim Ausführen des Vorgangs aufgetreten: [Create] für die Konfiguration, Allgemeine Problembehandlung: https://aka.ms/k8s-extensions-TSG.

Lösung 1: Zuerst Azure-App Configuration Kubernetes-Anbieter deinstallieren

Deinstallieren Sie den Azure-App Configuration Kubernetes-Anbieter, bevor Sie die Azure-App Konfigurationserweiterung installieren. Weitere Informationen finden Sie unter Bereinigen von Ressourcen.

Szenario 2: Die Konfigurationserweiterungsversion für gezielte Azure-App ist nicht vorhanden.

Wenn Sie versuchen, die Azure-App Konfigurationserweiterung für eine bestimmte Version zu installieren, erhalten Sie eine Fehlermeldung, die besagt, dass die Azure-App Konfigurationsversion nicht vorhanden ist:

(ExtensionOperationFailed) Fehler beim Erweiterungsvorgang: Fehler beim Beheben der Erweiterungsversion aus den angegebenen Werten. Bitte finden https://aka.ms/k8s-extension-type-versions Sie die richtige Version für Ihre Installation. Allgemeine Problembehandlung finden Sie unter: https://aka.ms/k8s-extensions-TSG

Code: ExtensionOperationFailed

Meldung: Fehler beim Erweiterungsvorgang mit dem folgenden Fehler: Fehler beim Beheben der Erweiterungsversion aus den angegebenen Werten. Bitte finden https://aka.ms/k8s-extension-type-versions Sie die richtige Version für Ihre Installation. Allgemeine Problembehandlung finden Sie unter: https://aka.ms/k8s-extensions-TSG

Lösung 2: Erneutes Installieren für eine unterstützte Azure-App Konfigurationserweiterungsversion

Versuchen Sie erneut, die Erweiterung zu installieren. Stellen Sie sicher, dass Sie eine unterstützte Version der konfigurationserweiterung Azure-App verwenden.

Szenario 3: Die zielorientierte Azure-App Konfigurationserweiterungsversion ist vorhanden, aber nicht in der angegebenen Region.

Da Azure-App Konfigurationserweiterung in allen AKS-Regionen nicht verfügbar ist, wird möglicherweise die folgende Fehlermeldung angezeigt:

(ExtensionTypeRegistrationGetFailed) Der Erweiterungstyp "microsoft.appconfiguration" ist nicht im Regionsregionsnamen <>registriert.

Code: ExtensionTypeRegistrationGetFailed

Meldung: Der Erweiterungstyp "microsoft.appconfiguration" ist nicht im Regionsbereichsnamen <registriert.>

Lösung 3: Installieren in einer anderen Region

Führen Sie die Installation in einer Region aus, die von der Clustererweiterung unterstützt wird.

Nächste Schritte

Wenn weiterhin Installationsprobleme auftreten, erkunden Sie das Handbuch zur Problembehandlung von AKS.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.