Extension Azure App Configuration pour Azure Kubernetes Service

Azure App Configuration est un service permettant de gérer de manière centralisée les paramètres d’application et les indicateurs de fonctionnalités. Le fournisseur Kubernetes Azure App Configuration est un opérateur Kubernetes qui obtient des valeurs-clés, des références Key Vault et des indicateurs de fonctionnalité à partir d’Azure App Configuration, et qui les intègre dans des secrets et ConfigMaps Kubernetes. L’extension Azure App Configuration pour Azure Kubernetes Service (AKS) vous permet d’installer et de gérer le fournisseur Kubernetes Azure App Configuration sur votre cluster AKS via Azure Resource Manager (ARM).

Prérequis

• Un abonnement Azure. Vous n'en avez pas ? Créez un compte gratuit.
• Installez la dernière version d’Azure CLI.
• Si vous n’en avez pas déjà un, vous devez créer un cluster AKS.
• Vérifiez que vous disposez d’un rôle de Administration RBAC Azure Kubernetes Service

Configurer l’extension Azure CLI pour les extensions de cluster

Installez l’extension k8s-extension Azure CLI en exécutant les commandes suivantes :

az extension add --name k8s-extension

Si l’extension k8s-extension est déjà installée, vous pouvez la mettre à jour vers la version la plus récente à l’aide de la commande suivante :

az extension update --name k8s-extension

Enregistrer le fournisseur de ressources KubernetesConfiguration

Si vous n’avez pas déjà utilisé d’extensions de cluster, vous devrez peut-être inscrire le fournisseur de ressources auprès de votre abonnement. Vous pouvez vérifier l’état d’inscription du fournisseur à l’aide de la commande az provider list, comme dans l’exemple suivant :

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

Le fournisseur Microsoft.KubernetesConfiguration doit être signalé comme Registered (Inscrit) comme dans l’exemple de sortie suivant :

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

Si le fournisseur apparaît NotRegistered (Non-inscrit), inscrivez-le à l’aide de la commande az provider register comme dans l’exemple suivant :

az provider register --namespace Microsoft.KubernetesConfiguration

Installer l’extension sur votre cluster AKS

Créez l’extension Azure App Configuration, ce qui installe le fournisseur Kubernetes Azure App Configuration sur votre cluster AKS.

Par exemple, installez la dernière version du fournisseur Kubernetes Azure App Configuration via l’extension Azure App Configuration sur votre cluster AKS :

Azure CLI

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

Bicep

Créez un modèle Bicep à l’aide de l’exemple suivant.

@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'
  }
}

Déployez le modèle Bicep à l'aide de la commande az deployment group.

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

Configurer les mises à jour automatiques

Si vous créez une extension Azure App Configuration sans spécifier de version, --auto-upgrade-minor-versionest automatiquement activé, ce qui configure l’extension Azure App Configuration pour mettre automatiquement à jour sa version mineure lors de nouvelles mises en production.

Vous pouvez désactiver la mise à jour automatique en spécifiant le paramètre --auto-upgrade-minor-version et en définissant la valeur sur false.

Azure CLI

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Ciblage d’une version spécifique

Le même argument de ligne de commande est utilisé pour installer une version spécifique du fournisseur Kubernetes Azure App Configuration ou restaurer une version antérieure. Définissez --auto-upgrade-minor-version sur false et --version sur la version du fournisseur Kubernetes Azure App Configuration que vous souhaitez installer. Si le paramètre version est omis, l’extension installe la dernière version.

Azure CLI

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.0.0

Bicep

Créez un modèle Bicep à l’aide de l’exemple suivant.

@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.0.0'
  }
}

Déployez le modèle Bicep à l'aide de la commande az deployment group.

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

Versions d’extension

L’extension Azure App Configuration prend en charge la version suivante du fournisseur Kubernetes Azure App Configuration :

• 2.0.0

Résoudre les erreurs d’installation de l’extension

Si la création ou la mise à jour de l’extension échoue, essayez les suggestions et solutions du Guide de résolution des problèmes de l’extension Azure App Configuration.

Résoudre les problèmes liés au fournisseur Kubernetes Azure App Configuration

Résolvez les erreurs du fournisseur Kubernetes Azure App Configuration à l’aide du guide de résolution des problèmes.

Supprimer l’extension

Si vous devez supprimer l’extension et retirer le fournisseur Kubernetes Azure App Configuration de votre cluster AKS, vous pouvez utiliser la commande suivante :

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

Étapes suivantes

• Apprenez-en davantage sur les paramètres et préférences supplémentaires que vous pouvez définir sur l’extension Azure App Configuration.
• Une fois que vous avez correctement installé l’extension Azure App Configuration dans votre cluster AKS, essayez le guide de démarrage rapide pour découvrir comment l’utiliser.
• Consultez toutes les fonctionnalités prises en charge du fournisseur Kubernetes Azure App Configuration.