Configure the Azure App Configuration extension for your Azure Kubernetes Service

Once you created the Azure App Configuration extension, you can configure the extension to work best for you and your project using various configuration options, like:

  • Configuring the replica count.
  • Configuring the log verbosity.
  • Configuring the installation namespace.

The extension enables you to configure Azure App Configuration extension settings by using the --configuration-settings parameter in the Azure CLI.

Tip

For a list of available options, see Azure App Configuration Kubernetes Provider helm values.

Configure the replica count

The default replica count is 1. Create Azure App Configuration extension with customized replica count:

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"

Note

If configuration settings are sensitive and need to be protected (for example, cert-related information), pass the --configuration-protected-settings parameter and the value will be protected from being read.

Configure the log verbosity

The default log verbosity is 1. Create Azure App Configuration extension with customized log verbosity:

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"

Log verbosity levels follow the klog convention:

  • 0: Warning and error only.
  • 1: Informational, this level is default.
  • 2: Detailed steady state information.
  • 3: Extended information about changes.
  • 4: Debug level verbosity.
  • 5: Trace level verbosity.

Configure the Azure App Configuration extension namespace

The Azure App Configuration extension gets installed in the azappconfig-system namespace by default. To override it, use --release-namespace. Include the cluster --scope to redefine the namespace.

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

Show current configuration settings

Use the az k8s-extension show command to show the current Azure App Configuration extension settings:

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

Update configuration settings

To update your Azure App Configuration extension settings, recreate the extension with the desired state. For example, assume we installed the extension using the following configuration:

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" 

To update the replicaCount from two to three, use the following command:

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"

Next Steps

Once you successfully install Azure App Configuration extension in your AKS cluster, try quickstart to learn how to use it.