Konfigurieren der Erweiterung „Azure App Configuration“ für Ihre Instanz von Azure Kubernetes Service

Artikel
09/10/2024

Nachdem Sie die Azure App-Konfigurationserweiterung erstellt haben, können Sie die Erweiterung so konfigurieren, dass sie am besten für Sie und Ihr Projekt mit verschiedenen Konfigurationsoptionen funktioniert, z. B.:

Konfigurieren der Replikatanzahl.
Konfigurieren der Ausführlichkeit des Protokolls.
Konfigurieren des Installationsnamespaces.

Mit der Erweiterung können Sie die Azure App-Konfigurationserweiterungseinstellungen mithilfe des --configuration-settings-Parameters in der Azure CLI konfigurieren.

Tipp

Eine Liste der verfügbaren Optionen finden Sie unter Helm-Versionen des Azure App Configuration Kubernetes Provider.

Konfigurieren der Replikatanzahl

Die Standardreplikatanzahl ist 1. Erstellen sie die Azure App-Konfigurationserweiterung mit angepasster Replikatanzahl:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

Hinweis

Wenn Konfigurationseinstellungen vertraulich sind und geschützt werden müssen, (z. B. zertifikatbezogene Informationen), übergeben Sie den --configuration-protected-settings-Parameter, und der Wert wird vor dem Lesen geschützt.

Konfigurieren der Ausführlichkeit des Protokolls

Die standardmäßige Ausführlichkeit des Protokolls lautet 1. Erstellen Sie die Azure App-Konfigurationserweiterung mit angepasster Ausführlichkeit des Protokolls:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "logVerbosity=3"

Ebenen der Ausführlichkeit des Protokolls folgen der klog-Konvention:

0: Nur Warnung und Fehler.
1: Informativ – diese Ebene ist Standard.
2: Detaillierte Informationen zum stabilen Zustand.
3: Erweiterte Informationen zu Änderungen.
4: Ausführlichkeit der Debugebene.
5: Ausführlichkeit der Ablaufverfolgungsebene.

Konfigurieren der Azure App-Konfigurationserweiterung

Die Azure App-Konfigurationserweiterung wird standardmäßig im azappconfig-system-Namespace installiert. Um ihn zu überschreiben, verwenden Sie --release-namespace. Schließen Sie den Cluster --scope ein, um den Namespace neu zu definieren.

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --scope cluster \
    --release-namespace custom-namespace

Zeigen Sie die aktuellen Konfigurationseinstellungen an

Verwenden Sie den az k8s-extension show-Befehl, um die aktuellen Azure App-Konfigurationserweiterungseinstellungen anzuzeigen:

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

Konfigurationseinstellungen aktualisieren

Um Ihre Azure App-Konfigurationserweiterungseinstellungen zu aktualisieren, erstellen Sie die Erweiterung mit dem gewünschten Zustand neu. Angenommen, wir haben die Erweiterung mit der folgenden Konfiguration installiert:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \  
    --configuration-settings "replicaCount=2"

Verwenden Sie den folgenden Befehl, um das replicaCount von zwei auf drei zu aktualisieren:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

Nächste Schritte

Nachdem Sie die Azure App Konfigurationserweiterung erfolgreich in Ihrem AKS-Cluster installiert haben, probieren Sie die Schnellstartanleitung, um zu erfahren, wie Sie sie verwenden.

Freigeben über