Guia de início rápido: criar um aplicativo Python com a Configuração de Aplicativo do Azure

Artigo
11/21/2023

Neste início rápido, você usará o provedor Python para Configuração de Aplicativo do Azure para centralizar o armazenamento e o gerenciamento de configurações de aplicativo usando a biblioteca de cliente do provedor Python de Configuração de Aplicativo do Azure.

O provedor de Configuração de Aplicativo Python é uma biblioteca executada sobre o SDK do Azure para Python, ajudando os desenvolvedores Python a consumir facilmente o serviço de Configuração de Aplicativo. Ele permite que as definições de configuração sejam usadas como um dicionário.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie um gratuitamente.
Uma loja de configuração de aplicativos. Crie uma loja.
Python 3.8 ou posterior - para obter informações sobre como configurar o Python no Windows, consulte a documentação do Python no Windows

Adicionar valores-chave

Adicione os seguintes valores-chave à App Configuration store. Para obter mais informações sobre como adicionar valores-chave a uma loja usando o portal do Azure ou a CLI, vá para Criar um valor-chave.

Key	valor	Label	Tipo de conteúdo
mensagem	Hello (Olá)	Deixar em branco	Deixar em branco
test.message	Olá teste	Deixar em branco	Deixar em branco
my_json	{"chave":"valor"}	Deixar em branco	Aplicação/JSON

Aplicações de consola

Nesta seção, você criará um aplicativo de console e carregará dados da sua loja de configuração de aplicativos.

Conectar-se à configuração do aplicativo

Crie um novo diretório para o projeto chamado app-configuration-quickstart.
```
mkdir app-configuration-quickstart
```
Alterne para o diretório app-configuration-quickstart recém-criado.
```
cd app-configuration-quickstart
```
Instale o provedor de Configuração de Aplicativo do Azure usando o pip install comando.
```
pip install azure-appconfiguration-provider
```

Crie um novo arquivo chamado app-configuration-quickstart.py no diretório app-configuration-quickstart e adicione o seguinte código:

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

Executar a aplicação

Defina uma variável de ambiente chamada AZURE_APPCONFIG_CONNECTION_STRING e defina-a como a cadeia de conexão da sua loja de configuração de aplicativos. Na linha de comando, execute o seguinte comando:
Para executar o aplicativo localmente usando o prompt de comando do Windows, execute o seguinte comando e substitua <app-configuration-store-connection-string> pela cadeia de conexão do repositório de configuração do aplicativo:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Se você usar o Windows PowerShell, execute o seguinte comando e substitua <app-configuration-store-connection-string> pela cadeia de conexão do seu repositório de configuração de aplicativos:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
```
Se você usa macOS, execute o seguinte comando e substitua <app-configuration-store-connection-string> pela cadeia de conexão da sua loja de configuração de aplicativos:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Se você usa Linux, execute o seguinte comando e substitua <app-configuration-store-connection-string> pela cadeia de conexão da sua loja de configuração de aplicativos:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Imprima o valor da variável de ambiente para validar se ela está definida corretamente com o comando abaixo.
Usando o prompt de comando do Windows, reinicie o prompt de comando para permitir que a alteração entre em vigor e execute o seguinte comando:
```
echo %AZURE_APPCONFIG_CONNECTION_STRING%
```
Se você usar o Windows PowerShell, execute o seguinte comando:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING
```
Se você usa macOS, execute o seguinte comando:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Se você usa Linux, execute o seguinte comando:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Depois que a variável de ambiente estiver definida corretamente, execute o seguinte comando para executar o aplicativo localmente:
```
python app-configuration-quickstart.py
```
Deverá ver o seguinte resultado:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Aplicações Web

O provedor de configuração de aplicativo carrega dados em um objeto, acessível como um Mapping dicionário, que pode ser usado em combinação com a configuração existente de várias estruturas Python. Esta seção mostra como usar o provedor de Configuração de Aplicativo em estruturas da Web populares como Flask e Django.

Frasco
Django

Você pode usar a Configuração do Aplicativo do Azure em seus aplicativos Web Flask existentes atualizando sua configuração incorporada. Você pode fazer isso passando o objeto do provedor de Configuração do Aplicativo para a update função da instância do aplicativo Flask em 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")

Você pode usar a Configuração do Aplicativo do Azure em seus aplicativos Web Django existentes adicionando as seguintes linhas de código ao seu settings.py arquivo

AZURE_APPCONFIGURATION = load(connection_string=os.environ.get("AZURE_APPCONFIG_CONNECTION_STRING"))

Para acessar definições de configuração individuais nas visualizações do Django, você pode fazer referência a elas a partir do objeto do provedor criado nas configurações do Django. Por exemplo, em views.py:

# Import Django settings
from django.conf import settings

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

Exemplos de código completo sobre como usar a Configuração de Aplicativo do Azure em aplicativos Web Python podem ser encontrados no repositório GitHub de Configuração de Aplicativo do Azure.

Clean up resources (Limpar recursos)

Se não quiser continuar a utilizar os recursos criados neste artigo, elimine o grupo de recursos que criou aqui para evitar cobranças.

Importante

A eliminação de um grupo de recursos é irreversível. O grupo de recursos e todos os recursos nele contidos são excluídos permanentemente. Certifique-se de não excluir acidentalmente o grupo de recursos ou recursos errados. Se você criou os recursos para este artigo dentro de um grupo de recursos que contém outros recursos que deseja manter, exclua cada recurso individualmente de seu respetivo painel em vez de excluir o grupo de recursos.

Entre no portal do Azure e selecione Grupos de recursos.
Na caixa Filtrar por nome, introduza o nome do seu grupo de recursos.
Na lista de resultados, selecione o nome do grupo de recursos para ver uma visão geral.
Selecione Eliminar grupo de recursos.
É-lhe pedido que confirme a eliminação do grupo de recursos. Insira o nome do grupo de recursos a ser confirmado e selecione Excluir.

Após alguns momentos, o grupo de recursos e todos os seus recursos são excluídos.

Próximos passos

Neste início rápido, você criou uma nova loja de configuração de aplicativos e aprendeu como acessar valores-chave de um aplicativo Python.

Para obter exemplos de código adicionais, visite:

Django Sample Flask Sample Azure App Configuration Python provider

Partilhar via