Azure App Configuration AKS-extensie installeren

2025-04-03

Azure-app Configuration biedt een service voor het centraal beheren van toepassingsinstellingen en functievlagmen. Azure App Configuration Kubernetes Provider is een Kubernetes-operator waarmee sleutelwaarden, Key Vault-verwijzingen en functievlaggen worden opgehaald uit Azure App Configuration en deze worden gebouwd in Kubernetes ConfigMaps en Secrets. Azure App Configuration-extensie voor Azure Kubernetes Service (AKS) stelt u in staat om de Azure App Configuration Kubernetes-provider op uw AKS-cluster te installeren en beheren via Azure Resource Manager (ARM).

Vereisten

Een Azure-abonnement. Maak een gratis account.
De nieuwste versie van de Azure CLI.
Een AKS-cluster (Azure Kubernetes Service). Maak een AKS-cluster.
Toestemming met de rol RBAC Admin van Azure Kubernetes Service.

De Azure CLI-extensie instellen voor clusterextensies

Installeer de k8s-extension Azure CLI-extensie door de volgende opdrachten uit te voeren:

az extension add --name k8s-extension

Als de extensie al is geïnstalleerd, kunt u deze k8s-extension bijwerken naar de nieuwste versie met behulp van de volgende opdracht:

az extension update --name k8s-extension

`KubernetesConfiguration` De resourceprovider registreren

Als u nog geen clusterextensies hebt gebruikt, moet u mogelijk de resourceprovider registreren bij uw abonnement. U kunt de status van de providerregistratie controleren met behulp van de opdracht az provider list , zoals wordt weergegeven in het volgende voorbeeld:

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

De Microsoft.KubernetesConfiguration-provider moet als Geregistreerd rapporteren, zoals wordt weergegeven in de volgende voorbeelduitvoer:

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

Als de provider wordt weergegeven als NotRegistered, registreert u de provider met behulp van het az-providerregister , zoals wordt weergegeven in het volgende voorbeeld:

az provider register --namespace Microsoft.KubernetesConfiguration

De extensie installeren op uw AKS-cluster

Maak de Azure-app-configuratie-extensie, waarmee Azure-app Configuratie-Kubernetes-provider op uw AKS wordt geïnstalleerd.

Installeer bijvoorbeeld de nieuwste versie van Azure-app Configuration Kubernetes Provider via de Azure-app Configuration-extensie op uw AKS-cluster:

Azure-CLI
Bicep

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

Maak een Bicep-sjabloon met behulp van het volgende voorbeeld.

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

Implementeer de Bicep-sjabloon met behulp van de az deployment group opdracht.

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

Automatische updates configureren

Als u de Azure App Configuration-extensie maakt zonder een versie op te geven, --auto-upgrade-minor-versionwordt deze automatisch ingeschakeld en wordt de Azure App Configuration-extensie zodanig geconfigureerd dat hij zijn secundaire versie automatisch bijwerkt bij nieuwe releases.

U kunt automatisch bijwerken uitschakelen door de --auto-upgrade-minor-version parameter op te geven en de waarde in te stellen op false.

Azure-CLI
Biceps

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Een specifieke versie instellen

Hetzelfde opdrachtregelargument wordt gebruikt voor het installeren van een specifieke versie van Azure-app Configuratie Kubernetes Provider of het terugdraaien naar een eerdere versie. Stel --auto-upgrade-minor-version in op false en --version op de versie van Azure App Configuration Kubernetes Provider die u wilt installeren. Als de version parameter wordt weggelaten, installeert de extensie de nieuwste versie.

Azure-CLI
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

Maak een Bicep-sjabloon met behulp van het volgende voorbeeld.

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

Implementeer de Bicep-sjabloon met behulp van de az deployment group opdracht.

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

Extensieversies

De Azure App Configuration-extensie ondersteunt de volgende versie van de Azure App Configuration Kubernetes Provider:

2.1.0
2.0.0

Installatiefouten met extensies oplossen

Als het maken of bijwerken van de extensie mislukt, kunt u suggesties en oplossingen proberen in de handleiding voor het oplossen van problemen met de configuratie-extensie Azure-app.

Problemen met Azure App-configuratie Kubernetes-provider oplossen

Problemen met Azure App Configuratie Kubernetes-provider oplossen via de gids voor probleemoplossing.

De extensie verwijderen

Als u de extensie wilt verwijderen en Azure-app Kubernetes-provider wilt verwijderen uit uw AKS-cluster, kunt u de volgende opdracht gebruiken:

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

Volgende stappen

Meer informatie over extra instellingen en voorkeuren die u kunt instellen op de Azure-app Configuratie-extensie.
Zodra je de Azure-appconfiguratie-extensie in je AKS-cluster hebt geïnstalleerd, probeer dan de snelstart om te leren hoe je deze kunt gebruiken.
Bekijk alle ondersteunde functies van Azure-app Configuration Kubernetes Provider.