Azure-app-configuratie-extensie voor Azure Kubernetes Service

Azure-app Configuration biedt een service voor het centraal beheren van toepassingsinstellingen en functievlagmen. Azure-app Configuratie kubernetes-provider is een Kubernetes-operator waarmee sleutelwaarden, Key Vault-verwijzingen en functievlagmen worden opgehaald uit Azure-app Configuratie en deze worden gebouwd in Kubernetes ConfigMaps en Geheimen. Azure-app Configuratie-extensie voor Azure Kubernetes Service (AKS) kunt u Azure-app Kubernetes-provider voor configuratie installeren en beheren op uw AKS-cluster via Azure Resource Manager (ARM).

Vereisten

• Een Azure-abonnement. Heb je er geen? Maak een gratis account.
• Installeer de nieuwste versie van de Azure CLI.
• Als u er nog geen hebt, moet u een AKS-cluster maken.
• Zorg ervoor dat u een RBAC-beheerdersrol voor Azure Kubernetes Service hebt

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

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 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 Azure-app Configuratie-extensie maakt zonder een versie op te geven, --auto-upgrade-minor-version wordt deze automatisch ingeschakeld en configureert u de Azure-app Configuratie-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 Configuratie Kubernetes Provider of het terugdraaien naar een eerdere versie. Stel --auto-upgrade-minor-version deze false in op en --version naar de versie van Azure-app 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 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 Azure-app Kubernetes-provider voor configuratie:

• 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 u Azure-app Configuratie-extensie in uw AKS-cluster hebt geïnstalleerd, kunt u snelstartgids proberen om te leren hoe u deze kunt gebruiken.
• Bekijk alle ondersteunde functies van Azure-app Configuration Kubernetes Provider.