Configurare l'estensione di configurazione app Azure per il servizio Azure Kubernetes

Articolo
09/10/2024

Dopo aver creato l'estensione Configurazione app di Azure, è possibile configurare l'estensione in modo che funzioni in maniera ottimale per l'utente e il progetto usando varie opzioni di configurazione come:

Configurazione del conteggio repliche.
Configurazione del dettaglio del log.
Configurazione dello spazio dei nomi di installazione.

L'estensione consente di configurare le impostazioni dell'estensione Configurazione app di Azure usando il parametro --configuration-settings nell'interfaccia della riga di comando di Azure.

Suggerimento

Per un elenco delle opzioni disponibili, vedere Valori helm del provider Kubernetes di Configurazione app di Azure.

Configurare il conteggio repliche

Il conteggio repliche predefinito è 1. Creare l'estensione Configurazione app di Azure con il conteggio repliche personalizzato:

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"

Nota

Se le impostazioni di configurazione sono sensibili e devono essere protette, ad esempio le informazioni correlate al certificato, passare il parametro --configuration-protected-settings e il valore sarà protetto dalla lettura.

Configurare il dettaglio del log

Il dettaglio del log predefinito è 1. Creare l'estensione Configurazione app di Azure con dettaglio di log personalizzato:

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"

I livelli di dettaglio del log seguono la convenzione klog:

0: solo avviso ed errore.
1: informativo; questo livello è predefinito.
2: informazioni dettagliate sullo stato stabile.
3: informazioni estese sulle modifiche.
4: dettaglio del livello di debug.
5: dettaglio del livello di traccia.

Configurare lo spazio dei nomi dell'estensione Configurazione app di Azure

L'estensione Configurazione app di Azure viene installata nello spazio dei nomi azappconfig-system per impostazione predefinita. Per eseguirne l'override, usare --release-namespace. Includere il cluster --scope per ridefinire lo spazio dei nomi.

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

Mostra le impostazioni di configurazione correnti

Usare il comando az k8s-extension show per visualizzare le impostazioni dell'estensione di Configurazione app di Azure:

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

Aggiornare impostazioni di configurazione

Per aggiornare le impostazioni dell'estensione Configurazione app di Azure, creare nuovamente l'estensione con lo stato desiderato. Si supponga, ad esempio, di aver installato l'estensione usando la configurazione seguente:

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"

Per aggiornare replicaCount da due a tre, usare il comando seguente:

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"

Passaggi successivi

Dopo aver installato correttamente l'estensione Configurazione app di Azure nel cluster del servizio Azure Kubernetes (AKS), provare la guida introduttiva per informazioni su come usarla.

Condividi tramite