Rövid útmutató: Python-alkalmazás létrehozása Azure-alkalmazás konfigurációval

Ebben a rövid útmutatóban a Python-szolgáltatót fogja használni Azure-alkalmazás konfigurációhoz az alkalmazásbeállítások tárolásának és kezelésének központosításához a Azure-alkalmazás Python-szolgáltató ügyfélkódtárával.

A Python alkalmazáskonfigurációs szolgáltató egy, a Pythonhoz készült Azure SDK-n futó kódtár, amely segít a Python-fejlesztőknek az App Configuration szolgáltatás egyszerű használatában. Lehetővé teszi a konfigurációs beállítások szótárként való használatát.

Előfeltételek

Egy Azure-fiók, aktív előfizetéssel. Hozzon létre egyet ingyen.
Egy alkalmazáskonfigurációs áruház, ahogyan az egy áruház létrehozására vonatkozó oktatóanyagban is látható.
Python 3.8 vagy újabb – a Python Windowson való beállításával kapcsolatos információkért tekintse meg a Python windowsos dokumentációját

Kulcsértékek hozzáadása

Adja hozzá a következő kulcsértékeket az Alkalmazáskonfigurációs áruházhoz. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs	Érték	Címke	Tartalomtípus
üzenet	Üdvözöljük	Hagyja üresen	Hagyja üresen
test.message	Hello teszt	Hagyja üresen	Hagyja üresen
my_json	{"key":"value"}	Hagyja üresen	alkalmazás/json

Konzolalkalmazások

Ebben a szakaszban létrehoz egy konzolalkalmazást, és betölti az adatokat az Alkalmazáskonfigurációs áruházból.

Csatlakozás az alkalmazáskonfigurációhoz

Hozzon létre egy új könyvtárat az app-configuration-quickstart nevű projekthez.
```
mkdir app-configuration-quickstart
```
Váltson az újonnan létrehozott app-configuration-quickstart könyvtárra .
```
cd app-configuration-quickstart
```
Telepítse a Azure-alkalmazás konfigurációszolgáltatót a pip install parancs használatával.
```
pip install azure-appconfiguration-provider
```

Hozzon létre egy app-configuration-quickstart.py nevű új fájlt az app-configuration-quickstart könyvtárban, és adja hozzá a következő kódot:

Microsoft Entra-azonosító (ajánlott)
Kapcsolati sztring

Ezzel hitelesítheti magát DefaultAzureCredential az Alkalmazáskonfigurációs áruházban. Kövesse az utasításokat a hitelesítő adatok alkalmazáskonfigurációs adatolvasói szerepkör hozzárendeléséhez. Győződjön meg arról, hogy elegendő időt hagy az engedély propagálására az alkalmazás futtatása előtt.

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 Microsoft Entra ID.
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 Entra ID 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))

Az alkalmazás futtatása

Környezeti változó beállítása.
- Microsoft Entra-azonosító (ajánlott)
- Kapcsolati sztring
Állítsa a AZURE_APPCONFIG_ENDPOINT nevű környezeti változót az Alkalmazáskonfigurációs áruház végpontjára, amely az Azure Portalon található áruház áttekintésében található.

Ha a Windows parancssorát használja, futtassa a következő parancsot, és indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez:
```
setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
```
Ha a PowerShellt használja, futtassa a következő parancsot:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
```
MacOS vagy Linux használata esetén futtassa a következő parancsot:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Állítsa a AZURE_APPCONFIG_CONNECTION_STRING nevű környezeti változót az Alkalmazáskonfigurációs áruház írásvédett kapcsolati sztring az Azure Portalon található áruház Access-kulcsai alatt.

Ha a Windows parancssorát használja, futtassa a következő parancsot, és indítsa újra a parancssort a módosítás érvénybe lépésének engedélyezéséhez:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
Ha a PowerShellt használja, futtassa a következő parancsot:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
MacOS vagy Linux használata esetén futtassa a következő parancsot:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
A környezeti változó megfelelő beállítása után futtassa a következő parancsot az alkalmazás helyi futtatásához:
```
python app-configuration-quickstart.py
```
A következő kimenetnek kell megjelennie:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Webes alkalmazások

Az alkalmazáskonfigurációs szolgáltató adatokat tölt be egy Mapping szótárként elérhető objektumba, amely a különböző Python-keretrendszerek meglévő konfigurációjával kombinálva használható. Ez a szakasz bemutatja, hogyan használhatja az alkalmazáskonfigurációs szolgáltatót olyan népszerű webes keretrendszerekben, mint a Flask és a Django.

Lombik
Django

A Azure-alkalmazás-konfigurációt a meglévő Flask-webalkalmazásokban a beépített konfiguráció frissítésével használhatja. Ezt úgy teheti meg, hogy átadja az alkalmazáskonfiguráció-szolgáltató objektumát a update Flask-alkalmazáspéldány függvényének a következő helyen 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")

A Azure-alkalmazás-konfigurációt a meglévő Django-webalkalmazásokban az alábbi kódsorok fájlba adásával használhatja settings.py

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

A Django-nézetek egyéni konfigurációs beállításainak eléréséhez a Django beállításaiban létrehozott szolgáltatói objektumból hivatkozhat rájuk. Például:views.py

# Import Django settings
from django.conf import settings

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

A Azure-alkalmazás-konfiguráció Python-webalkalmazásokban való használatára vonatkozó teljes kódminták a Azure-alkalmazás Konfigurációs GitHub-adattárban találhatók.

Az erőforrások eltávolítása

Ha nem szeretné folytatni a cikkben létrehozott erőforrások használatát, törölje az itt létrehozott erőforráscsoportot a díjak elkerülése érdekében.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne lévő összes erőforrás véglegesen törlődik. Győződjön meg arról, hogy nem véletlenül törli a rossz erőforráscsoportot vagy erőforrásokat. Ha a cikk erőforrásait olyan erőforráscsoporton belül hozta létre, amely más megtartani kívánt erőforrásokat tartalmaz, törölje az egyes erőforrásokat a megfelelő panelről az erőforráscsoport törlése helyett.

Jelentkezzen be az Azure Portalra, és válassza ki az Erőforráscsoportokat.
A Szűrés név szerint mezőbe írja be az erőforráscsoport nevét.
Az eredménylistában válassza ki az erőforráscsoport nevét az áttekintés megtekintéséhez.
Válassza az Erőforráscsoport törlése elemet.
A rendszer az erőforráscsoport törlésének megerősítését kéri. Adja meg a megerősítéshez az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Néhány pillanat múlva az erőforráscsoport és annak összes erőforrása törlődik.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy új alkalmazáskonfigurációs áruházat, és megtanulta, hogyan érheti el a kulcsértékeket egy Python-alkalmazásból.

További kódmintákért látogasson el a következőre:

Django sample Flask Sample Azure-alkalmazás Configuration Python provider

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2024-12-18