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

  • Artículo

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

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:

    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 llamada AZURE_APPCONFIG_CONNECTION_STRING y defínala como la cadena de conexión de su almacén de App Configuration. En la línea de comandos, ejecute el siguiente comando:

    Para ejecutar la aplicación localmente mediante el símbolo del sistema de Windows, ejecute el siguiente comando y reemplace <app-configuration-store-connection-string> con la cadena de conexión del almacén de configuración de la aplicación:

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

  2. Imprima el valor de la variable de entorno para comprobar que se ha establecido correctamente con el siguiente comando.

    Con el símbolo del sistema de Windows, reinicie el símbolo del sistema para permitir que el cambio surta efecto y ejecute el siguiente comando:

    echo %AZURE_APPCONFIG_CONNECTION_STRING%

  3. 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.

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(connection_string=os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING"))

# 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")

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