Azure App Configuration AKS-extensie installeren

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 functievlagmen worden opgehaald uit Azure App Configuration en worden gebouwd in Kubernetes ConfigMaps en Geheimen. De Azure App Configuration-extensie voor Azure Kubernetes Service (AKS) maakt het mogelijk 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 Azure Kubernetes Service (AKS)-cluster. Maak een AKS-cluster.
• Toestemming met de rol Azure Kubernetes Service RBAC-beheerder.

De Azure CLI-extensie instellen voor clusterextensies

Installeer de extensie k8s-extension Azure CLI 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 rapporteren als Registered, 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 Configuration-extensie, waarmee Azure App Configuration 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

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

Bicep

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 opdracht az deployment group.

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

Belangrijk

De Azure App Configuration AKS-extensie is standaard geïnstalleerd in de azappconfig-system-naamruimte. Als u Azure Policy-toewijzingen hebt waarmee podspecificaties worden gevalideerd of gewijzigd (bijvoorbeeld het ingebouwde beleid 'Kubernetes-clusters moeten het automatisch koppelen van API-referenties uitschakelen' waarmee automountServiceAccountToken: false wordt afgedwongen), sluit dan de azappconfig-system-naamruimte uit van die beleidsregels door het toe te voegen aan de uitsluitingslijst van naamruimten van het beleid, zodat de extensie correct kan functioneren. Als u dit niet opneemt, kunnen de extensiepods falen bij validatie of niet-compatibel lijken.

Automatische updates configureren

Als u Azure App Configuration-extensie maakt zonder een versie op te geven, --auto-upgrade-minor-version automatisch ingeschakeld, configureert u de Azure App Configuration-extensie om de secundaire versie automatisch bij te werken in 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

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Een specifieke versie instellen

Hetzelfde opdrachtregelargument wordt gebruikt voor het installeren van een specifieke versie van Azure App Configuration 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

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

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 opdracht az deployment group.

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 Azure App Configuration Kubernetes-provider:

• 2.1.0
• 2.0.0

Installatiefouten met extensies oplossen

Als de extensie niet kan worden gemaakt of bijgewerkt, kunt u suggesties en oplossingen proberen in de handleiding voor het oplossen van problemen met Azure App Configuration-extensie.

Problemen met Azure App Configuration Kubernetes-provider oplossen

Los Azure App Configuration Kubernetes Provider-fouten op met de gids voor probleemoplossing.

De extensie verwijderen

Als u de extensie wilt verwijderen en Azure App Configuration Kubernetes Provider uit uw AKS-cluster wilt verwijderen, 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 voor de Azure App Configuration-extensie.
• Nadat u Azure App Configuration-extensie in uw AKS-cluster hebt geïnstalleerd, kunt u quickstart proberen om te leren hoe u deze kunt gebruiken.
• Bekijk alle ondersteunde functies van Azure App Configuration Kubernetes Provider.