Inicio rápido: Creación de una aplicación de Python con Azure App Configuration

En este inicio rápido, usará el proveedor de Python para Azure App Configuration para centralizar el almacenamiento y la administración de la configuración de aplicaciones mediante la biblioteca cliente proveedor de Python de App Configuration.

El proveedor de App Configuration de Python es una biblioteca que se ejecuta sobre el SDK de Azure para Python, lo que ayuda a los desarrolladores de Python a consumir fácilmente el servicio App Configuration. Permite usar opciones de configuración como un diccionario.

Prerrequisitos

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.
• Un almacén de App Configuration. Crear un almacén.
• Python 3.8 o posterior: para información sobre cómo configurar Python en Windows, consulte la documentación de Python en Windows

Agregar pares de clave-valor

Agregue los siguientes pares de clave-valor al almacén de App Configuration. Para obtener más información sobre cómo agregar pares clave-valor a un almacén mediante Azure Portal o la CLI, vaya a Creación de un par clave-valor.

Clave	Value	Etiqueta	Tipo de contenido
message	Hello	Dejar en blanco	Dejar en blanco
test.message	Prueba hola	Dejar en blanco	Dejar en blanco
my_json	{"key":"value"}	Dejar en blanco	application/json

Aplicaciones de consola

En esta sección, creará una aplicación de consola y cargará datos desde el almacén de App Configuration.

Conexión a App Configuration

1. Cree un directorio para el proyecto denominado app-configuration-quickstart.

   mkdir app-configuration-quickstart
   

2. Cambie al directorio recién creado app-configuration-quickstart.

   cd app-configuration-quickstart
   

3. Instale el proveedor de Azure App Configuration mediante el comando pip install.

   pip install azure-appconfiguration-provider
   

4. Cree un archivo llamado app-configuration-quickstart.py en el directorio app-configuration-quickstart y agregue el código siguiente:

   Microsoft Entra ID (recomendado)

   Use DefaultAzureCredential para autenticarse en el almacén de App Configuration. Siga las instrucciones para asignar la credencial al rol Lector de datos de App Configuration. Asegúrese de dejar tiempo suficiente para que el permiso se propague antes de ejecutar la aplicación.

   from azure.appconfiguration.provider import (
       load,
       SettingSelector
   )
   from azure.identity import DefaultAzureCredential
   import os
   
   endpoint = os.environ.get("AZURE_APPCONFIG_ENDPOINT")
   
   # Connect to Azure App Configuration using a connection string.
   config = load(endpoint=endpoint, credential=credential)
   credential = DefaultAzureCredential()
   
   # Find the key "message" and print its value.
   print(config["message"])
   # Find the key "my_json" and print the value for "key" from the dictionary.
   print(config["my_json"]["key"])
   
   # Connect to Azure App Configuration using a connection string and trimmed key prefixes.
   trimmed = {"test."}
   config = load(endpoint=endpoint, credential=credential, trim_prefixes=trimmed)
   # From the keys with trimmed prefixes, find a key with "message" and print its value.
   print(config["message"])
   
   # Connect to Azure App Configuration using SettingSelector.
   selects = {SettingSelector(key_filter="message*", label_filter="\0")}
   config = load(endpoint=endpoint, credential=credential, selects=selects)
   
   # Print True or False to indicate if "message" is found in Azure App Configuration.
   print("message found: " + str("message" in config))
   print("test.message found: " + str("test.message" in config))
   

   Cadena de conexión

   from azure.appconfiguration.provider import (
       load,
       SettingSelector
   )
   import os
   
   connection_string = os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING")
   
   # Connect to Azure App Configuration using a connection string.
   config = load(connection_string=connection_string)
   
   # Find the key "message" and print its value.
   print(config["message"])
   # Find the key "my_json" and print the value for "key" from the dictionary.
   print(config["my_json"]["key"])
   
   # Connect to Azure App Configuration using a connection string and trimmed key prefixes.
   trimmed = {"test."}
   config = load(connection_string=connection_string, trim_prefixes=trimmed)
   # From the keys with trimmed prefixes, find a key with "message" and print its value.
   print(config["message"])
   
   # Connect to Azure App Configuration using SettingSelector.
   selects = {SettingSelector(key_filter="message*", label_filter="\0")}
   config = load(connection_string=connection_string, selects=selects)
   
   # Print True or False to indicate if "message" is found in Azure App Configuration.
   print("message found: " + str("message" in config))
   print("test.message found: " + str("test.message" in config))
   

Ejecución de la aplicación

1. Establezca una variable de entorno.

   Microsoft Entra ID (recomendado)

   Establezca la variable de entorno denominada AZURE_APPCONFIG_ENDPOINT en el punto de conexión del almacén de App Configuration que se encuentra en la Información general del almacén en Azure Portal.

   Si usa el símbolo del sistema de Windows, ejecute el siguiente comando y reinícielo para que se aplique el cambio:

   setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
   

   Si usa PowerShell, ejecute el siguiente comando:

   $Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
   

   Si usa macOS o Linux, ejecute el siguiente comando:

   export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
   

   Cadena de conexión

   Establezca la variable de entorno denominada AZURE_APPCONFIG_CONNECTION_STRING en la cadena de conexión de solo lectura del almacén de App Configuration que se encuentra en Claves de acceso del almacén en Azure Portal.

   Si usa el símbolo del sistema de Windows, ejecute el siguiente comando y reinícielo para que se aplique el cambio:

   setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
   

   Si usa PowerShell, ejecute el siguiente comando:

   $Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
   

   Si usa macOS o Linux, ejecute el siguiente comando:

   export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
   

2. Una vez establecida correctamente la variable de entorno, ejecute el siguiente comando para ejecutar la aplicación localmente:

   python app-configuration-quickstart.py
   

   Debería ver la siguiente salida:

   Hello
   value
   Hello test
   message found: True
   test.message found: False
   

Aplicaciones web

El proveedor de App Configuration carga datos en un objeto Mapping, al que se puede acceder en la forma de diccionario, que se puede usar en combinación con la configuración existente de varios marcos de Python. En esta sección, se muestra cómo usar el proveedor de App Configuration en marcos web populares como Flask y Django.

Flask

Puede usar Azure App Configuration en las aplicaciones web de Flask existentes al actualizar su configuración integrada. Para ello, pase el objeto de proveedor de App Configuration a la función update de la instancia de aplicación de Flask en app.py:

azure_app_config = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

# NOTE: This will override all existing configuration settings with the same key name.
app.config.update(azure_app_config)

# Access a configuration setting directly from within Flask configuration
message = app.config.get("message")

Django

Puede usar Azure App Configuration en las aplicaciones web de Django existentes al agregar las siguientes líneas de código en el archivo settings.py

AZURE_APPCONFIGURATION = load(endpoint=os.environ.get("AZURE_APPCONFIG_ENDPOINT"), credential=credential)

Para acceder a las opciones de configuración individuales en las vistas de Django, puede hacer referencia a ellas desde el objeto de proveedor creado en la configuración de Django. Por ejemplo, en views.py:

# Import Django settings
from django.conf import settings

# Access a configuration setting from Django settings instance.
MESSAGE = settings.AZURE_APPCONFIGURATION.get("message")

Puede encontrar ejemplos de código completos sobre cómo usar Azure App Configuration en aplicaciones web de Python en el repositorio de GitHub de Azure App Configuration.

Limpieza de recursos

Si no quiere seguir usando los recursos que se han creado en este artículo, elimine el grupo de recursos que creó aquí para evitar cargos.

Importante

La eliminación de un grupo de recursos es irreversible. El grupo de recursos y todos los recursos que contiene se eliminan permanentemente. Asegúrese de que no elimina por accidente el grupo de recursos o los recursos equivocados. Si creó los recursos para este artículo en un grupo de recursos que contenga los recursos que desee conservar, elimine cada recurso de forma individual desde su panel respectivo, en lugar de eliminar el grupo de recursos.

1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.
2. En el cuadro de texto Filtrar por nombre, escriba el nombre del grupo de recursos.
3. En la lista resultados, seleccione el nombre del grupo de recursos para ver la información general.
4. Seleccione Eliminar grupo de recursos.
5. Se le pedirá que confirme la eliminación del grupo de recursos. Escriba el nombre del grupo de recursos para confirmar y seleccione Eliminar.

Transcurridos unos instantes, el grupo de recursos y todos sus recursos se eliminan.

Pasos siguientes

En este inicio rápido, ha creado un almacén de App Configuration y ha aprendido a acceder a los pares clave-valor desde una aplicación de Python.

Para encontrar otros ejemplos de código, visite:

Ejemplo de DjangoEjemplo de FlaskProveedor de Azure App Configuration de Python