Felsöka installationsfel för Azure App Configuration-tillägg

I den här artikeln beskrivs några vanliga felscenarier som kan uppstå när du installerar eller uppdaterar Azure App Configuration-tillägget för Microsoft Azure Kubernetes Service (AKS).

Kommentar

Om Azure App Configuration-tillägget har installerats men du får problem när du använder det kan du läsa felsökningsguiden för Azure App Configuration Kubernetes Provider.

Scenario 1: Kubernetes-providern för Azure App Configuration är redan installerad

Du försöker installera Azure App Configuration-tillägget för AKS, men du får ett felmeddelande som anger att Kubernetes-providern för Azure App Configuration redan har installerats via helm install kommandot . Felmeddelandet kan likna något av följande felmeddelanden.

Meddelande 1

(ExtensionOperationFailed) Tilläggsåtgärden misslyckades med följande fel: Fel: [ InnerError: [Helm-installationen misslyckades: Resursen finns redan i klustret : Rekommendationen tar manuellt bort de resurser som för närvarande finns i klustret och försöker installera igen. Om du vill ta bort dessa resurser kör du följande kommandon: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [renderade manifest innehåller en resurs som redan finns. Det går inte att fortsätta med installationen: CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" i namnområdet "" finns och kan inte importeras till den aktuella versionen: ogiltiga ägarskapsmetadata; valideringsfel för anteckningar: nyckeln "meta.helm.sh/release-name" måste vara lika med "azureappconfig": det aktuella värdet är "azureappconfiguration.kubernetesprovider"; valideringsfel för anteckningar: nyckeln "meta.helm.sh/release-namespace" måste vara lika med "kube-system": det aktuella värdet är "azappconfig-system"]]] inträffade när åtgärden : [Create] on the config, For general troubleshooting visit: https://aka.ms/k8s-extensions-TSG.

Meddelande 2

(ExtensionOperationFailed) Tilläggsåtgärden misslyckades med följande fel: Fel: [ InnerError: [Helm-installationen misslyckades: Resursen finns redan i klustret : Rekommendationen tar manuellt bort de resurser som för närvarande finns i klustret och försöker installera igen. Om du vill ta bort dessa resurser kör du följande kommandon: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [renderade manifest innehåller en resurs som redan finns. Det går inte att fortsätta med installationen: ServiceAccount "az-appconfig-k8s-provider" i namnområdet "azappconfig-system" finns och kan inte importeras till den aktuella versionen: metadata för ogiltigt ägarskap; valideringsfel för anteckning: nyckeln "meta.helm.sh/release-name" måste vara lika med "azureappconfig": det aktuella värdet är "azureappconfiguration.kubernetesprovider"]]] inträffade när åtgärden : [Create] på konfigurationen, För allmänt felsökningsbesök: https://aka.ms/k8s-extensions-TSG.

Lösning 1: Avinstallera Kubernetes-providern för Azure App Configuration först

Avinstallera Kubernetes-providern för Azure App Configuration innan du installerar Azure App Configuration-tillägget. Mer information finns i Rensa resurser.

Scenario 2: Den riktade versionen av Azure App Configuration-tillägget finns inte

När du försöker installera Azure App Configuration-tillägget för att rikta in dig på en viss version får du ett felmeddelande om att Azure App Configuration-versionen inte finns:

(ExtensionOperationFailed) Tilläggsåtgärden misslyckades med följande fel: Det gick inte att matcha tilläggsversionen från de angivna värdena. https://aka.ms/k8s-extension-type-versions Se hitta rätt version för installationen för allmän felsökning: https://aka.ms/k8s-extensions-TSG.

Kod: ExtensionOperationFailed

Meddelande: Tilläggsåtgärden misslyckades med följande fel: Det gick inte att matcha tilläggsversionen från de angivna värdena. https://aka.ms/k8s-extension-type-versions Se hitta rätt version för installationen för allmän felsökning: https://aka.ms/k8s-extensions-TSG.

Lösning 2: Installera igen för en version av Azure App Configuration-tillägget som stöds

Försök igen för att installera tillägget. Kontrollera att du använder en version som stöds av Azure App Configuration-tillägget.

Scenario 3: Den riktade versionen av Azure App Configuration-tillägget finns men inte i den angivna regionen

Eftersom Azure App Configuration-tillägget inte är tillgängligt i alla AKS-regioner kan du få följande felmeddelande:

(ExtensionTypeRegistrationGetFailed) Tilläggstypen microsoft.appconfiguration är inte registrerad i regionregionnamn<>.

Kod: ExtensionTypeRegistrationGetFailed

Meddelande: Tilläggstypen microsoft.appconfiguration är inte registrerad i regionregionnamn <>

Lösning 3: Installera i en annan region

Kör installationen i en region som klustertillägget stöder.

Nästa steg

Om du fortfarande har installationsproblem kan du utforska felsökningsguiden för AKS.

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.