Partager via


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

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 :

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

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.

--auto-upgrade-minor-version 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.

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

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