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

Článek
11/21/2023

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í do konfigurace aplikace

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.pya přidejte následující kód:

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í s názvem AZURE_APPCONFIG_CONNECTION_STRING a nastavte ji na připojovací řetězec vašeho App Configuration Storu. Na příkazovém řádku spusťte následující příkaz:
Pokud chcete aplikaci spustit místně pomocí příkazového řádku Windows, spusťte následující příkaz a nahraďte <app-configuration-store-connection-string> připojovací řetězec úložiště konfigurace aplikací:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Pokud používáte Windows PowerShell, spusťte následující příkaz a nahraďte <app-configuration-store-connection-string> připojovací řetězec úložiště konfigurace aplikací:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
```
Pokud používáte macOS, spusťte následující příkaz a nahraďte <app-configuration-store-connection-string> připojovací řetězec úložiště konfigurace aplikací:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Pokud používáte Linux, spusťte následující příkaz a nahraďte <app-configuration-store-connection-string> připojovací řetězec úložiště konfigurace vaší aplikace:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Vytiskněte hodnotu proměnné prostředí, abyste ověřili, že je správně nastavená pomocí následujícího příkazu.
Pomocí příkazového řádku systému Windows restartujte příkazový řádek, aby se změna projevila, a spusťte následující příkaz:
```
echo %AZURE_APPCONFIG_CONNECTION_STRING%
```
Pokud používáte Windows PowerShell, spusťte následující příkaz:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING
```
Pokud používáte macOS, spusťte následující příkaz:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Pokud používáte Linux, spusťte následující příkaz:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
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ňky
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(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")

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

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