Azure App Configuration es un servicio administrado, que almacena app settings en pares clave-valor, de forma centralizada en el cloud. Permite modificar configuración dinámicamente y gestionar feature flags, hacer despliegues progresivos o experimentar sin tener que desplegar la app de nuevo.
Understand the App Configuration data model
App Configuration guarda cada setting como pares clave-valor con propiedades adicionales para poder controlar como se identifica, interpreta, y administra la setting.
- Key: case-sensitive unicode string que identifica la setting. Soporta delimitadores como
:o/EjemploOpenAI:Endpoint. No se fuerzan schemas sobre las keys - Value: unicode string que almacena el dato. El tamaño combinado de Key y Value no puede pasar de 10 KB. Se pueden meter plain strings, JSON obects, o referencias a otros recursos como Key Vault secrets
- Label: Tag opcional que crea variantes de la misma key. Permite almacenar diferentes valores para la misma key a lo largo de environments, regiones, o versiones.
- Content Type: Property opcional que indica como se debe interpretar el valor.
application/jsonle dice al provider que parsee el valor como JSON object. Key Vault reference content types le dicen al provider que resuelva el valor de Azure Key Vault - Tags: metadatos opcionales en pares clave-valor para filtrar y organizar.
Install the python provider library
La libreria azure-appconfiguration-provider ofrece una interfaz a alto nivel para cargar config settings desde una App Configuration store, a tu python app.
Esta libreria crea un Mapping object que se comporta como un python dict.
Tambien necesitamos la libreria
azure-identitypara auth
pip install azure-appconfiguration-provider azure-identity
Connect and retrieve settings
La function load() acepta un endpoint parameter para la App Configuration store URL y un credential param para auth. El endpoint sigue el patrón https://<store-name>.azconfig.io
como conectar a App Configuration y hacer get de un valor
# Code fragment - focus on connecting to App Configuration and accessing a setting
from azure.appconfiguration.provider import load
from azure.identity import DefaultAzureCredential
import os
endpoint = os.environ.get("AZURE_APPCONFIG_ENDPOINT")
credential = DefaultAzureCredential()
config = load(endpoint=endpoint, credential=credential)
# Access settings using dictionary syntax
model_endpoint = config["OpenAI:Endpoint"]
batch_size = config["Pipeline:BatchSize"]
Authenticate with DefaultAzureCredential
También se soporta aqui. Prueba diferentes metodos de auth en orden hasta que uno funciona.
Select and filter keys with SettingSelector
La clase SettingSelector filtra que keys carga el provider de la store. Sin un selector, el provider carga cada par clave-valor con null label, lo que puede incluir settings de otras apps que compartan el mismo store.
Puedes usar key_filter para hacer match de keys por prefix o patron (se aceptan wildcards *) y label_filter para seleccionar settings para un entorno o version especifica.
Lo ideal es cargar solo la conf relevante al contexto actual de la app, para reducir memoria y evitar name colisions.
# Code fragment - focus on SettingSelector for filtering keys by prefix and label
from azure.appconfiguration.provider import load, SettingSelector
from azure.identity import DefaultAzureCredential
selects = [
SettingSelector(key_filter="Pipeline:*", label_filter="Production")
]
config = load(
endpoint=endpoint,
credential=DefaultAzureCredential(),
selects=selects
)
# Only keys matching "Pipeline:*" with the "Production" label are loaded
batch_size = config["Pipeline:BatchSize"]
Puedes pasar multiples SettingSelector para cargar several groups de settings en una unica llamada. Cuando hay multiples selectores que hacen match de la misma key, el ultimo selector de la lista es el que toma prioridad
Trim key prefixes
Nombres jerarquicos como DocPipeline:OpenAI:Endpoint mantienen la conf store organizada, pero el full prefix es normalmente innecesario dentro del codigo de la app.
El param trim_prefixes borra estos prefijos al cargar la config para que a la app le queden nombres más limpios
# Code fragment - focus on trimming key prefixes for cleaner access
config = load(
endpoint=endpoint,
credential=DefaultAzureCredential(),
trim_prefixes=["DocPipeline:"]
)
# Access "DocPipeline:OpenAI:Endpoint" as "OpenAI:Endpoint"
model_endpoint = config["OpenAI:Endpoint"]
Trimming es especialmente util cuando hay multiples apps que comparten un config store y cada una usa un prefijo único
Enable dynamic configuration refresh
El provider soporta refresh de config dinámicos para que tu app pueda recibir cambios desde App Configuration sin reiniciarse.
Tienes que activar el refresh especificando uno o más sentinel keys a hacer watch a través del param refresh_on.
Cuando el provider detecta un cambio en esa key que vigilamos, recarga la config entera (para mantener consistencia).
El param refresh_interval controla la frecuencia de ese check (en segundos).
# Code fragment - focus on enabling dynamic refresh with a sentinel key
from azure.appconfiguration.provider import load, WatchKey
from azure.identity import DefaultAzureCredential
config = load(
endpoint=endpoint,
credential=DefaultAzureCredential(),
refresh_on=[WatchKey("Sentinel")],
refresh_interval=60
)
# Later in your application loop or request handler
config.refresh()
# Access settings - values reflect the latest from the store after refresh
batch_size = config["Pipeline:BatchSize"]
El patrón sentinel key involucra una key dedicada que hace update cuando quieres que la app recargue su config. Cambiar la sentinel key le indica al provider que hay un nuevo set de config. El métpdp refresh() del provider debe ser llamado de manera explicita. Si el refresh_interval no se ha cumplido desde el ultimo check, la llamada refresh() se ignora y devuelve sin hacer nada.