Rychlý start: Vytvoření aplikace v Pythonu pomocí konfigurace Aplikace Azure

Článek
12/18/2024

V tomto rychlém startu použijete zprostředkovatele Pythonu pro Aplikace Azure Configuration k centralizaci úložiště a správy nastavení aplikace pomocí klientské knihovny zprostředkovatele Aplikace Azure Configuration Python.

Zprostředkovatel konfigurace aplikací v Pythonu je knihovna spuštěná nad sadou Azure SDK pro Python, která vývojářům v Pythonu pomáhá snadno využívat službu App Configuration. Umožňuje použít nastavení konfigurace, jako je slovník.

Požadavky

Účet Azure s aktivním předplatným. Vytvořte si ho zdarma.
App Configuration Store. Vytvořte úložiště.
Python 3.8 nebo novější – informace o nastavení Pythonu ve Windows najdete v dokumentaci k Pythonu ve Windows.

Přidání hodnot klíče

Do app Configuration Storu přidejte následující hodnoty klíčů. Další informace o tom, jak přidat hodnoty klíčů do úložiště pomocí webu Azure Portal nebo rozhraní příkazového řádku, najdete v tématu Vytvoření hodnoty klíče.

Key	Hodnota	Popisek	Typ obsahu
message	Hello (Nazdar)	Nechejte prázdné.	Nechejte prázdné.
test.message	Hello test	Nechejte prázdné.	Nechejte prázdné.
my_json	{"key":"value"}	Nechejte prázdné.	application/json

Konzolové aplikace

V této části vytvoříte konzolovou aplikaci a načtete data z app Configuration Storu.

Připojení ke službě App Configuration

Vytvořte nový adresář pro projekt s názvem app-configuration-quickstart.
```
mkdir app-configuration-quickstart
```
Přepněte do nově vytvořeného adresáře app-configuration-quickstart .
```
cd app-configuration-quickstart
```
Pomocí příkazu nainstalujte zprostředkovatele pip install konfigurace Aplikace Azure.
```
pip install azure-appconfiguration-provider
```

V adresáři app-configuration-quickstart vytvořte nový soubor s názvem app-configuration-quickstart.py a přidejte následující kód:

Microsoft Entra ID (doporučeno)
Připojovací řetězec

Použijete DefaultAzureCredential k ověření ve službě App Configuration Store. Postupujte podle pokynů a přiřaďte své přihlašovací údaje roli Čtenář dat konfigurace aplikace. Před spuštěním aplikace nezapomeňte povolit dostatek času, než se oprávnění rozšíří.

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

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

Spuštění aplikace

Nastavte proměnnou prostředí.
- Microsoft Entra ID (doporučeno)
- Připojovací řetězec
Nastavte proměnnou prostředí s názvem AZURE_APPCONFIG_ENDPOINT na koncový bod obchodu App Configuration, který najdete v části Přehled obchodu na webu Azure Portal.

Pokud používáte příkazový řádek systému Windows, spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:
```
setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
```
Pokud používáte PowerShell, spusťte následující příkaz:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
```
Pokud používáte macOS nebo Linux, spusťte následující příkaz:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Nastavte proměnnou prostředí s názvem AZURE_APPCONFIG_CONNECTION_STRING na připojovací řetězec služby App Configuration Store, která se nachází v části Přístupové klíče úložiště na webu Azure Portal.

Pokud používáte příkazový řádek systému Windows, spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
Pokud používáte PowerShell, spusťte následující příkaz:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
Pokud používáte macOS nebo Linux, spusťte následující příkaz:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
Jakmile je proměnná prostředí správně nastavená, spusťte aplikaci místně spuštěním následujícího příkazu:
```
python app-configuration-quickstart.py
```
Měl by se zobrazit následující výstup:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Webové aplikace

Zprostředkovatel konfigurace aplikace načte data do objektu Mapping , který je přístupný jako slovník, který lze použít v kombinaci se stávající konfigurací různých architektur Pythonu. Tato část ukazuje, jak používat zprostředkovatele konfigurace aplikace v oblíbených webových architekturách, jako je Flask a Django.

Baňka
Django

Konfiguraci Aplikace Azure můžete použít ve stávajících webových aplikacích Flask tak, že aktualizujete integrovanou konfiguraci. Můžete to provést předáním objektu zprostředkovatele konfigurace aplikace do update funkce instance aplikace Flask v 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")

V existujících webových aplikacích Django můžete použít konfiguraci Aplikace Azure přidáním následujících řádků kódu do souborusettings.py.

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

Pokud chcete získat přístup k individuálnímu nastavení konfigurace v zobrazeníCh Django, můžete na ně odkazovat z objektu zprostředkovatele vytvořeného v nastavení Django. Například v views.py:

# Import Django settings
from django.conf import settings

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

Kompletní ukázky kódu o použití Aplikace Azure Konfigurace ve webových aplikacích Pythonu najdete v úložišti Aplikace Azure Configuration GitHub.

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Ujistěte se, že omylem neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste vytvořili prostředky pro tento článek ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.

Přihlaste se k webu Azure Portal a vyberte skupiny prostředků.
Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků.
V seznamu výsledků vyberte název skupiny prostředků, abyste zobrazili přehled.
Vyberte Odstranit skupinu prostředků.
Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.

Po chvíli se skupina prostředků a všechny její prostředky odstraní.

Další kroky

V tomto rychlém startu jste vytvořili nový obchod App Configuration a dozvěděli jste se, jak přistupovat k hodnotám klíčů z aplikace v Pythonu.

Další ukázky kódu najdete zde:

Ukázka Ukázky Django Flask Aplikace Azure konfiguračního poskytovatele Pythonu

Sdílet prostřednictvím