Extensión de Azure App Configuration para Azure Kubernetes Service

Azure App Configuration proporciona un servicio para administrar de forma centralizada la configuración y las marcas de características de la aplicación. El proveedor de Kubernetes de Azure App Configuration es un operador de Kubernetes que obtiene valores clave, referencias de Key Vault e indicadores de características de Azure App Configuration y los crea en Kubernetes ConfigMaps y Secrets. La extensión azure App Configuration para Azure Kubernetes Service (AKS) le permite instalar y administrar el proveedor de Kubernetes de Azure App Configuration en el clúster de AKS mediante Azure Resource Manager (ARM).

Requisitos previos

• Suscripción a Azure. ¿Aún no tiene una? Cree una cuenta gratuita.
• Instalar la versión más reciente de la CLI de Azure.
• Si todavía no tiene uno, debe crear un clúster de AKS.
• Asegúrese de tener un rol de administrador de RBAC de Azure Kubernetes Service.

Configuración de la extensión de la CLI de Azure para las extensiones de clúster

Instale la extensión k8s-extension de la CLI de Azure mediante la ejecución de los siguientes comandos:

az extension add --name k8s-extension

Si la extensión k8s-extension ya está instalada, puede actualizarla a su versión más reciente con el siguiente comando:

az extension update --name k8s-extension

Registro del proveedor de KubernetesConfiguration recurso

Si no ha usado anteriormente extensiones de clúster, es posible que tenga que registrar el proveedor de recursos con su suscripción. Puede comprobar el estado del registro del proveedor mediante el comando az provider list, como se muestra en el siguiente ejemplo:

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

El proveedor Microsoft.KubernetesConfiguration debería indicar Registered, tal y como se muestra en el siguiente ejemplo de salida:

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

Si el proveedor se muestra como NotRegistered, registre el proveedor con el comando az provider register tal como se muestra en el siguiente ejemplo:

az provider register --namespace Microsoft.KubernetesConfiguration

Instalación de la extensión en el clúster de AKS

Cree la extensión Azure App Configuration, que instala el proveedor Azure App Configuration Kubernetes en su AKS.

Por ejemplo, instale la última versión del proveedor Azure App Configuration Kubernetes Provider a través de la extensión Azure App Configuration en su clúster AKS:

CLI de Azure

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

Bicep

Cree una plantilla de Bicep con el ejemplo siguiente.

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

Implemente la plantilla de Bicep mediante el comando az deployment group.

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

Configuración de actualizaciones automáticas

Si crea la extensión Azure App Configuration sin especificar una versión, --auto-upgrade-minor-version se habilita automáticamente, configurando la extensión Azure App Configuration para que actualice automáticamente su versión secundaria en las nuevas versiones.

Puede deshabilitar la actualización automática especificando el parámetro --auto-upgrade-minor-version y estableciendo el valor en false.

CLI de Azure

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Seleccionar una versión específica

El mismo argumento de línea de comandos se utiliza para instalar una versión específica de Azure App Configuration Proveedor de Kubernetes o para revertir a una versión anterior. Establezca --auto-upgrade-minor-version en false y --version en la versión del proveedor de Kubernetes de Azure App Configuration que desea instalar. Si se omite el parámetro version, la extensión instala la versión más reciente.

CLI de Azure

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

Bicep

Cree una plantilla de Bicep con el ejemplo siguiente.

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

Implemente la plantilla de Bicep mediante el comando az deployment group.

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

Versiones de extensión

La extensión Azure App Configuration admite la siguiente versión del proveedor de Kubernetes de Azure App Configuration:

• 2.1.0
• 2.0.0

Solución de errores de instalación de extensiones

Si la extensión no se puede crear o actualizar, pruebe las sugerencias y soluciones de la guía de solución de problemas de la extensión Azure App Configuration.

Solución de problemas del proveedor de Kubernetes de Azure App Configuration

Solucionar errores del proveedor Kubernetes de Azure App Configuration mediante la guía de solución de problemas.

Eliminación de la extensión

Si necesita eliminar la extensión y quitar el proveedor de Kubernetes de Azure App Configuration del clúster de AKS, puede usar el siguiente comando:

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

Pasos siguientes

• Obtenga más información sobre los ajustes y preferencias adicionales que puede establecer en la extensión Azure App Configuration.
• Una vez que instale correctamente la extensión de Azure App Configuration en el clúster de AKS, pruebe inicio rápido para aprender a usarlo.
• Consulte todas las características admitidas de proveedor de Kubernetes de Azure App Configuration.