Installare l'estensione di Configurazione app di Azure per AKS

Configurazione app di Azure fornisce un servizio per gestire centralmente le impostazioni dell'applicazione e i flag di funzionalità. Provider Kubernetes di Configurazione app di Azure è un operatore Kubernetes che ottiene valori chiave, riferimenti all'insieme di credenziali delle chiavi e flag di funzionalità da Configurazione app di Azure e li compila in ConfigMaps e segreti di Kubernetes. L'estensione di Configurazione app di Azure per Servizio Azure Kubernetes (AKS) consente di installare e gestire il provider Kubernetes di Configurazione app di Azure nel tuo cluster AKS tramite Azure Resource Manager (ARM).

Prerequisiti

Sottoscrizione Azure. Creare un account gratuito.
Versione più recente del interfaccia della riga di comando di Azure.
Un cluster del servizio Azure Kubernetes. Creare un cluster del servizio Azure Kubernetes.
Autorizzazione con il ruolo servizio Azure Kubernetes RBAC Admin.

Configurare l'estensione interfaccia della riga di comando di Azure per le estensioni del cluster

Installare l'estensione k8s-extension interfaccia della riga di comando di Azure eseguendo i comandi seguenti:

az extension add --name k8s-extension

Se l'estensione k8s-extension è già installata, è possibile aggiornarla alla versione più recente usando il comando seguente:

az extension update --name k8s-extension

Registrare il provider di risorse `KubernetesConfiguration`

Se le estensioni del cluster non sono state usate in precedenza, potrebbe essere necessario registrare il provider di risorse con la sottoscrizione. È possibile controllare lo stato di registrazione del provider usando il comando az provider list, come illustrato nell'esempio seguente:

az provider list --query "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

Il provider Microsoft.KubernetesConfiguration deve segnalare come Registered, come illustrato nell'output di esempio seguente:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Se il provider viene visualizzato come NotRegistered, registrare il provider usando az provider register come illustrato nell'esempio seguente:

az provider register --namespace Microsoft.KubernetesConfiguration

Installare l'estensione nel cluster del servizio Azure Kubernetes

Crea l'estensione Configurazione app di Azure, che installa Configurazione app di Azure Provider Kubernetes su AKS.

Ad esempio, installare la versione più recente di Configurazione app di Azure Provider Kubernetes tramite l'estensione Configurazione app di Azure sul cluster AKS:

interfaccia della riga di comando di Azure
Bicep

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration

Creare un modello di Bicep usando l'esempio seguente.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: true
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
  }
}

Distribuire il modello Bicep usando il comando az deployment group.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Importante

L'estensione Configurazione app di Azure AKS viene installata, per impostazione predefinita, nello spazio dei nomi azappconfig-system. Se sono presenti assegnazioni di Criteri di Azure che convalidano o modificano le specifiche dei pod (ad esempio, i criteri predefiniti "I cluster Kubernetes devono disabilitare il montaggio automatico delle credenziali API" che applicano automountServiceAccountToken: false), escludere lo spazio dei nomi azappconfig-system da tali criteri aggiungendolo all'elenco di esclusione dello spazio dei nomi dei criteri per consentire il corretto funzionamento dell'estensione. Non escluderlo potrebbe causare l'esito negativo della convalida dei pod dell'estensione o farli apparire non conformi.

Configurare gli aggiornamenti automatici

Se si crea l'estensione Configurazione app di Azure senza specificare una versione, --auto-upgrade-minor-versionviene abilitata automaticamente, configurando l'estensione Configurazione app di Azure per aggiornare automaticamente la versione minor nelle nuove release.

È possibile disabilitare l'aggiornamento automatico specificando il parametro --auto-upgrade-minor-version e impostando il valore su false.

interfaccia della riga di comando di Azure
Bicep

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Destinazione di una versione specifica

Lo stesso argomento della riga di comando viene usato per installare una versione specifica di Configurazione app di Azure provider Kubernetes o eseguire il rollback a una versione precedente. Impostare --auto-upgrade-minor-version su false e --version sulla versione del provider Kubernetes Configurazione app di Azure da installare. Se il parametro version viene omesso, l'estensione installa la versione più recente.

interfaccia della riga di comando di Azure
Bicep

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version false
    --version 2.1.0

Creare un modello di Bicep usando l'esempio seguente.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: false
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
    version: '2.1.0'
  }
}

Implementare il modello Bicep usando il comando az deployment group.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Versioni estensione

L'estensione Configurazione app di Azure supporta la versione seguente di Configurazione app di Azure provider Kubernetes:

2.1.0
2.0.0

Risolvere gli errori di installazione dell'estensione

Se l'estensione non riesce a creare o aggiornare, provare suggerimenti e soluzioni nella guida alla risoluzione dei problemi dell'estensione Configurazione app di Azure.

Risoluzione dei problemi del provider Kubernetes di Configurazione app di Azure

Risolvere gli errori del provider di Configurazione app di Azure per Kubernetes tramite la guida alla risoluzione dei problemi.

Eliminare l'estensione

Se è necessario eliminare l'estensione e rimuovere Configurazione app di Azure Provider di Kubernetes dal cluster AKS, è possibile usare il comando seguente:

az k8s-extension delete --resource-group myResourceGroup --cluster-name myAKSCluster --cluster-type managedClusters --name appconfigurationkubernetesprovider

Passaggi successivi

Altre informazioni sulle impostazioni e le preferenze di extra che è possibile impostare nell'estensione Configurazione app di Azure.
Dopo aver installato correttamente l'estensione Configurazione app di Azure nel cluster del servizio Azure Kubernetes, provare quickstart per informazioni su come usarla.
Vedere tutte le funzionalità supportate di Configurazione app di Azure provider Kubernetes.

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-07