Installera AKS-tillägget för Azure App Configuration

Azure App Configuration tillhandahåller en tjänst för att centralt hantera programinställningar och funktionsflaggor. Kubernetes-providern för Azure App Configuration är en Kubernetes-operatör som hämtar nyckelvärden, Key Vault-referenser och funktionsflaggor från Azure App Configuration och skapar dem i Kubernetes ConfigMaps och Secrets. Med Azure App Configuration-tillägget för Azure Kubernetes Service (AKS) kan du installera och hantera Kubernetes-providern för Azure App Configuration i aks-klustret via Azure Resource Manager (ARM).

Prerequisites

• Ett Azure-abonnemang. Skapa ett kostnadsfritt konto.
• Den senaste versionen av Azure CLI.
• Ett AKS-kluster (Azure Kubernetes Service). Skapa ett AKS-kluster.
• Behörighet med Azure Kubernetes Service RBAC Admin-rollen.

Konfigurera Azure CLI-tillägget för klustertillägg

k8s-extension Installera Azure CLI-tillägget genom att köra följande kommandon:

az extension add --name k8s-extension

k8s-extension Om tillägget redan är installerat kan du uppdatera det till den senaste versionen med hjälp av följande kommando:

az extension update --name k8s-extension

KubernetesConfiguration Registrera resursprovidern

Om du inte tidigare har använt klustertillägg kan du behöva registrera resursprovidern med din prenumeration. Du kan kontrollera statusen för providerregistreringen med kommandot az provider list , som du ser i följande exempel:

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

Microsoft.KubernetesConfiguration-providern bör rapportera som Registrerad, enligt följande exempelutdata:

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

Om providern visas som NotRegistered registrerar du providern med hjälp av az providerregistret enligt följande exempel:

az provider register --namespace Microsoft.KubernetesConfiguration

Installera tillägget i ditt AKS-kluster

Skapa Azure App Configuration-tillägget som installerar Kubernetes-providern för Azure App Configuration på din AKS.

Installera till exempel den senaste versionen av Azure App Configuration Kubernetes-providern via Azure App Configuration-tillägget i AKS-klustret:

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

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

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

Konfigurera automatiska uppdateringar

Om du skapar Azure App Configuration-tillägget utan att ange en version --auto-upgrade-minor-versionaktiveras automatiskt och konfigurerar Azure App Configuration-tillägget för att automatiskt uppdatera dess delversion på nya versioner.

Du kan inaktivera automatisk uppdatering genom att ange parametern --auto-upgrade-minor-version och ange värdet till false.

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Rikta in sig på en viss version

Samma kommandoradsargument används för att installera en specifik version av Azure App Configuration Kubernetes-providern eller återställa till en tidigare version. Ange --auto-upgrade-minor-version till false och --version till den version av Azure App Configuration Kubernetes-providern som du vill installera. Om parametern version utelämnas installerar tillägget den senaste versionen.

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

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

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

Tilläggsversioner

Azure App Configuration-tillägget stöder följande version av Azure App Configuration Kubernetes-providern:

• 2.1.0
• 2.0.0

Felsöka installationsfel för tillägg

Om tillägget inte kan skapa eller uppdatera kan du prova förslag och lösningar i felsökningsguiden för Azure App Configuration-tillägget.

Felsök Azure App Configuration-tjänstleverantör för Kubernetes

Felsöka Kubernetes-providerfel i Azure App Configuration via felsökningsguiden.

Ta bort tillägget

Om du behöver ta bort tillägget och ta bort Azure App Configuration Kubernetes-providern från AKS-klustret kan du använda följande kommando:

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

Nästa steg

• Läs mer om extra inställningar och inställningar som du kan ange i Azure App Configuration-tillägget.
• När du har installerat Azure App Configuration-tillägget i AKS-klustret kan du prova med snabbstarten och lära dig hur du använder det.
• Se alla funktioner som stöds i Kubernetes-providern för Azure App Configuration.