Tutorial: Uso de la configuración dinámica en Azure Kubernetes Service

Si usa Azure Kubernetes Service (AKS), en este tutorial se muestra cómo habilitar la configuración dinámica para las cargas de trabajo en AKS aprovechando Azure App Configuration y su proveedor de Kubernetes. En el tutorial se supone que trabaja en el inicio rápido y que tiene configurado un proveedor de Kubernetes de App Configuration, por lo que antes de continuar, asegúrese de completar el inicio rápido de Uso de Azure App Configuration en Azure Kubernetes Service.

Sugerencia

Consulte las opciones para las cargas de trabajo hospedadas en Kubernetes para acceder a Azure App Configuration.

Prerrequisitos

Finalice el inicio rápido: uso de Azure App Configuration en Azure Kubernetes Service.

Recarga de datos de App Configuration

1. Abra el archivo appConfigurationProvider.yaml ubicado en el directorio Implementación . A continuación, agregue la refresh sección bajo la configuration propiedad. Permite que el proveedor de Kubernetes vuelva a cargar toda la configuración siempre que detecte un cambio en cualquiera de los valores clave-valor seleccionados (los que empiezan por Configuración: y no tienen etiqueta). Para obtener más información sobre la supervisión de los cambios de configuración, consulte Procedimientos recomendados para la actualización de la configuración.

   apiVersion: azconfig.io/v1
   kind: AzureAppConfigurationProvider
   metadata:
     name: appconfigurationprovider-sample
   spec:
     endpoint: <your-app-configuration-store-endpoint>
     target:
       configMapName: configmap-created-by-appconfig-provider
       configMapData: 
         type: json
         key: mysettings.json
     auth:
       workloadIdentity:
         managedIdentityClientId: <your-managed-identity-client-id>
     configuration:
       refresh:
         enabled: true
   

   Sugerencia

   Puede establecer la interval propiedad de refresh para especificar el tiempo mínimo entre las actualizaciones de configuración. En este ejemplo, usará el valor predeterminado de 30 segundos. Ajusta a un valor mayor si necesitas reducir el número de solicitudes realizadas en la tienda de Configuración de Aplicaciones.

2. Abra el archivo deployment.yaml en el directorio Deployment y agregue el siguiente contenido a la spec.containers sección . La aplicación carga la configuración desde un archivo montado en volumen que genera el proveedor de Kubernetes de App Configuration. Al establecer esta variable de entorno, la aplicación puede usar el sondeo para supervisar los cambios en los archivos montados.

   env:
   - name: DOTNET_USE_POLLING_FILE_WATCHER
     value: "true"
   

3. Ejecute el siguiente comando para implementar el cambio. Reemplace el espacio de nombres si usa la aplicación de AKS existente.

   kubectl apply -f ./Deployment -n appconfig-demo
   

4. Abra una ventana del explorador y vaya a la dirección IP obtenida en el paso anterior. La página web tiene este aspecto:

   

5. Actualice los siguientes valores de clave en el almacén de App Configuration.

   Clave	Importancia
   Configuración:Mensaje	Hola desde Azure App Configuration: ahora con actualizaciones en directo.

6. Después de actualizar el explorador varias veces, verá el contenido actualizado una vez que ConfigMap se actualiza en 30 segundos.

   

Volver a cargar ConfigMap y Secret

El proveedor de Kubernetes de App Configuration genera ConfigMaps o secretos que se pueden usar como variables de entorno o archivos montados por volumen. En este tutorial se muestra cómo cargar la configuración desde un archivo JSON mediante el proveedor de configuración JSON de .NET, que vuelve a cargar automáticamente la configuración cada vez que se detecta un cambio en el archivo montado. Como resultado, la aplicación obtiene automáticamente la configuración actualizada cada vez que el proveedor de Kubernetes de App Configuration actualiza configMap.

Si la aplicación depende de variables de entorno para la configuración, puede requerir un reinicio para recoger los valores actualizados. En Kubernetes, el reinicio de la aplicación se puede orquestar mediante actualizaciones graduales en los pods o contenedores correspondientes. Para automatizar las actualizaciones de configuración, puede aprovechar herramientas de terceros como stakater/Reloader, que pueden desencadenar automáticamente actualizaciones graduales en los cambios realizados en ConfigMaps o Secretos.

Pasos siguientes

Para más información sobre el proveedor de Kubernetes de Azure App Configuration, consulte Referencia del proveedor de Kubernetes de Azure App Configuration.