Azure App Configuration-Erweiterung für Azure Kubernetes Service

Azure App Configuration bietet einen Dienst zur zentralen Verwaltung von Anwendungseinstellungen und Featureflags. Azure App Configuration Kubernetes Provider ist ein Kubernetes-Operator, der Schlüsselwerte, Key Vault-Verweise und Featurekennzeichnungen aus der Azure App-Konfiguration abruft und diese in Kubernetes ConfigMaps und Secrets erstellt. Mit der Azure App-Konfigurationserweiterung für Azure Kubernetes Service (AKS) können Sie Azure App Configuration Kubernetes Provider über Azure Resource Manager (ARM) auf Ihrem AKS-Cluster installieren und verwalten.

Voraussetzungen

• Ein Azure-Abonnement. Sie haben keine? Erstellen Sie ein kostenloses Konto.
• Installieren Sie die aktuelle Version der Azure CLI.
• Wenn Sie keinen besitzen, müssen Sie einen solchen AKS cluster erstellen.
• Stellen Sie sicher, dass Sie über eine RBAC-Administratorrolle in Azure Kubernetes Service verfügen.

Einrichten der Azure CLI-Erweiterung für Clustererweiterungen

Installieren Sie die Azure CLI-Erweiterung k8s-extension, indem Sie die folgenden Befehle ausführen:

az extension add --name k8s-extension

Wenn die Erweiterung k8s-extension bereits installiert ist, können Sie sie mit dem folgenden Befehl auf die neueste Version aktualisieren:

az extension update --name k8s-extension

Registrieren des Ressourcenanbieters KubernetesConfiguration

Wenn Sie bisher noch keine Clustererweiterungen verwendet haben, müssen Sie den Dienstanbieter möglicherweise in Ihrem Abonnement registrieren. Sie können den Status der Anbieterregistrierung mithilfe des Befehls az provider list überprüfen, wie im folgenden Beispiel gezeigt:

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

Der Microsoft.KubernetesConfiguration-Anbieter sollte als Registriert gemeldet werden, wie in der folgenden Beispielausgabe gezeigt:

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

Wenn der Anbieter als Nicht registriert angezeigt wird, registrieren Sie den Anbieter mit dem az provider register, wie im folgenden Beispiel gezeigt:

az provider register --namespace Microsoft.KubernetesConfiguration

Installieren der Erweiterung in Ihrem AKS-Cluster

Erstellen Sie die Azure App-Konfigurationserweiterung, die den Azure App Configuration Kubernetes Provider auf Ihrem AKS installiert.

Installieren Sie beispielsweise die neueste Version des Azure App Configuration Kubernetes Provider über die Azure App-Konfigurationserweiterung auf Ihrem AKS-Cluster:

Azure-Befehlszeilenschnittstelle

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

Bicep

Erstellen Sie eine Bicep-Vorlage mithilfe des folgenden Beispiels.

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

Stellen Sie die Bicep-Vorlage mithilfe des Befehls az deployment group bereit.

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

Konfigurieren automatischer Updates

Wenn Sie die Azure App-Konfigurationserweiterung ohne Angabe einer Version erstellen, wird die Azure App-Konfigurationserweiterung --auto-upgrade-minor-versionautomatisch aktiviert, um die Nebenversion für neue Versionen automatisch zu aktualisieren.

Sie können die automatische Aktualisierung deaktivieren, indem Sie den --auto-upgrade-minor-version-Parameter angeben und den Wert auf false festlegen.

Azure-Befehlszeilenschnittstelle

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Adressierung einer bestimmten Version

Dasselbe Befehlszeilenargument wird zum Installieren einer bestimmten Version von Azure App Configuration Kubernetes Provider verwendet, oder ein Rollback auf eine frühere Version durchgeführt. Legen Sie --auto-upgrade-minor-version auf false und --version auf die Version von Azure App Configuration Kubernetes Provider fest, die Sie installieren möchten. Wenn der Parameter version weggelassen wird, installiert die Erweiterung die neueste Version.

Azure-Befehlszeilenschnittstelle

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

Bicep

Erstellen Sie eine Bicep-Vorlage mithilfe des folgenden Beispiels.

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

Stellen Sie die Bicep-Vorlage mithilfe des Befehls az deployment group bereit.

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

Erweiterungsversionen

Die Azure App-Konfigurationserweiterung unterstützt die folgende Version des Azure App Configuration Kubernetes Provider:

• 2.0.0

Problembehandlung für Fehler bei der Installation der Erweiterung

Wenn die Erweiterung nicht erstellt oder aktualisiert werden kann, versuchen Sie Vorschläge und Lösungen im Erweiterungshandbuch zur Problembehandlung für die Azure App-Konfigurationserweiterung.

Problembehandlung für Azure App Configuration Kubernetes Provider

Behandeln von Fehlern des Azure App Configuration Kubernetes Provider über das Handbuch zur Problembehandlung.

Entfernen der Erweiterung

Wenn Sie die Erweiterung löschen und den Azure App Configuration Kubernetes Provider aus Ihrem AKS-Cluster entfernen müssen, können Sie den folgenden Befehl verwenden:

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

Nächste Schritte

• Erfahren Sie mehr über zusätzliche Einstellungen und Einstellungen, die Sie für die Azure App-Konfigurationserweiterung festlegen können.
• Nachdem Sie die Azure App Konfigurationserweiterung erfolgreich in Ihrem AKS-Cluster installiert haben, probieren Sie die Schnellstartanleitung, um zu erfahren, wie Sie sie verwenden.
• Alle unterstützten Features des Azure App Configuration Kubernetes Provider anzeigen.