Risolvere gli errori di installazione dell'estensione di configurazione app Azure

Questo articolo illustra alcuni scenari di errore comuni che possono verificarsi durante l'installazione o l'aggiornamento dell'estensione di configurazione app Azure per Microsoft servizio Azure Kubernetes (servizio Azure Kubernetes).

Note

Se l'estensione di configurazione app Azure è stata installata correttamente ma si verificano problemi durante l'uso, vedere la guida alla risoluzione dei problemi del provider Kubernetes di configurazione app Azure.

Scenario 1: app Azure provider Kubernetes di configurazione è già installato

Si tenta di installare l'estensione di configurazione app Azure per il servizio Azure Kubernetes, ma viene visualizzato un messaggio di errore che indica che il provider Kubernetes di configurazione app Azure è già installato tramite il helm install comando . Il messaggio di errore potrebbe essere simile a uno dei messaggi di errore seguenti.

Messaggio 1

(ExtensionOperationFailed) L'operazione di estensione non è riuscita con l'errore seguente: [ InnerError: [Installazione Helm non riuscita: risorsa già esistente nel cluster : raccomandazione Eliminare manualmente le risorse esistenti nel cluster e riprovare l'installazione. Per eliminare queste risorse, eseguire i comandi seguenti: : kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [manifesti sottoposti a rendering contengono una risorsa già esistente. Impossibile continuare con l'installazione: CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" nello spazio dei nomi "" esiste e non può essere importato nella versione corrente: metadati di proprietà non validi; errore di convalida dell'annotazione: la chiave "meta.helm.sh/release-name" deve essere uguale a "azureappconfig": il valore corrente è "azureappconfiguration.kubernetesprovider"; errore di convalida dell'annotazione: la chiave "meta.helm.sh/release-namespace" deve essere uguale a "kube-system": il valore corrente è "azappconfig-system"]]] durante l'operazione : [Crea] nella configurazione. Per la risoluzione dei problemi generali, vedere: https://aka.ms/k8s-extensions-TSG.

Messaggio 2

(ExtensionOperationFailed) L'operazione di estensione non è riuscita con l'errore seguente: [ InnerError: [Installazione Helm non riuscita: risorsa già esistente nel cluster : raccomandazione Eliminare manualmente le risorse esistenti nel cluster e riprovare l'installazione. Per eliminare queste risorse, eseguire i comandi seguenti: : kubectl delete {resource type} -n {resource namespace} {resource name} InnerError [manifesti sottoposti a rendering contengono una risorsa già esistente. Impossibile continuare con l'installazione: ServiceAccount "az-appconfig-k8s-provider" nello spazio dei nomi "azappconfig-system" esiste e non può essere importato nella versione corrente: metadati di proprietà non validi; errore di convalida dell'annotazione: la chiave "meta.helm.sh/release-name" deve essere uguale a "azureappconfig": il valore corrente è "azureappconfiguration.kubernetesprovider"]]] durante l'operazione : [Crea] nella configurazione, Per la risoluzione dei problemi generali, vedere: https://aka.ms/k8s-extensions-TSG.

Soluzione 1: Disinstallare prima app Azure provider Kubernetes di configurazione

Disinstallare il provider Kubernetes di configurazione app Azure prima di installare l'estensione di configurazione app Azure. Per altre informazioni, vedere Pulire le risorse.

Scenario 2: la versione dell'estensione di configurazione di app Azure di destinazione non esiste

Quando si tenta di installare l'estensione di configurazione app Azure per una versione specifica, viene visualizzato un messaggio di errore che indica che la versione di configurazione app Azure non esiste:

(ExtensionOperationFailed) L'operazione di estensione non è riuscita con l'errore seguente: Impossibile risolvere la versione dell'estensione dai valori specificati. Per la risoluzione dei problemi generali, vedere https://aka.ms/k8s-extension-type-versions trovare la versione corretta per l'installazione: https://aka.ms/k8s-extensions-TSG.

Codice: ExtensionOperationFailed

Messaggio: L'operazione di estensione non è riuscita con l'errore seguente: Impossibile risolvere la versione dell'estensione dai valori specificati. Per la risoluzione dei problemi generali, vedere https://aka.ms/k8s-extension-type-versions trovare la versione corretta per l'installazione: https://aka.ms/k8s-extensions-TSG.

Soluzione 2: Installare di nuovo per una versione supportata dell'estensione di configurazione app Azure

Provare a installare di nuovo l'estensione. Assicurarsi di usare una versione supportata dell'estensione di configurazione app Azure.

Scenario 3: la versione dell'estensione di configurazione di app Azure di destinazione esiste ma non nell'area specificata

Poiché app Azure'estensione di configurazione non è disponibile in tutte le aree del servizio Azure Kubernetes, è possibile che venga visualizzato il messaggio di errore seguente:

(ExtensionTypeRegistrationGetFailed) Il tipo di estensione microsoft.appconfiguration non è registrato in <region-name>.

Codice: ExtensionTypeRegistrationGetFailed

Messaggio: Il tipo di estensione microsoft.appconfiguration non è registrato in region-name <>

Soluzione 3: Installare in un'area diversa

Eseguire l'installazione in un'area supportata dall'estensione del cluster.

Passaggi successivi

Se si verificano ancora problemi di installazione, vedere la guida alla risoluzione dei problemi del servizio Azure Kubernetes.

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.