estensione di configurazione app Azure per servizio Azure Kubernetes

Configurazione app di Azure fornisce un servizio per la gestione centralizzata delle impostazioni e dei flag di funzionalità dell'applicazione. Provider Kubernetes di Configurazione app di Azure è un operatore Kubernetes che ottiene valori chiave, riferimenti a Key Vault e flag di funzionalità da Configurazione app di Azure e li compila in ConfigMaps e segreti di Kubernetes. L'estensione Configurazione app di Azure per il servizio Azure Kubernetes consente di installare e gestire il provider Kubernetes di Configurazione app di Azure nel cluster del servizio Azure Kubernetes tramite Azure Resource Manager (ARM).

Prerequisiti

• Una sottoscrizione di Azure. Non se ne ha una? Crea un account gratuito.
• Installare la versione più recente dell'interfaccia della riga di comando di Azure.
• Se non ne è già disponibile uno, è necessario creare un cluster del servizio Azure Kubernetes.
• Assicurarsi di avere un ruolo di amministratore controllo degli accessi in base al ruolo del servizio Azure Kubernetes

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

Installare l’estensione dell'k8s-extensioninterfaccia della riga di comando di Azure eseguendo questi comandi:

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 della registrazione del provider usando il comando az provider list, come spiegato nell'esempio seguente:

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

Il provider Microsoft.KubernetesConfiguration deve essere contrassegnato come Registrato, come spiegato 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

Creare l'estensione di Configurazione app di Azure, che installa il provider Kubernetes di Configurazione app di Azure nel servizio Azure Kubernetes.

Ad esempio, installare la versione più recente del provider Kubernetes di Configurazione app di Azure tramite l'estensione Configurazione app di Azure nel cluster del servizio Azure Kubernetes:

Interfaccia della riga di comando di Azure

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

Bicep

Creare un modello 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

Configurare gli aggiornamenti automatici

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

È 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

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Destinazione di una versione specifica

Lo stesso argomento della riga di comando viene usato per installare una versione specifica del provider Kubernetes di Configurazione app di Azure o eseguire il rollback a una versione precedente. Impostare --auto-upgrade-minor-version su false e --version sulla versione del provider Kubernetes di 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

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

Bicep

Creare un modello 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'
  }
}

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

Versioni estensione

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

• 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 di Configurazione app di Azure.

Risolvere i problemi del provider Kubernetes di Configurazione app di Azure

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

Eliminare l'estensione

Se è necessario eliminare l'estensione e rimuovere provider Kubernetes di Configurazione app di Azure dal cluster del servizio Azure Kubernetes, è 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 aggiuntive che è possibile impostare nell'estensione di Configurazione app di Azure.
• Dopo aver installato correttamente l'estensione Configurazione app di Azure nel cluster del servizio Azure Kubernetes (AKS), provare la guida introduttiva per informazioni su come usarla.
• Vedere tutte le funzionalità supportate del Provider Kubernetes di Configurazione app di Azure.