Szybki start: tworzenie aplikacji w języku Python przy użyciu konfiguracji aplikacja systemu Azure

Artykuł
12/18/2024

W tym przewodniku Szybki start użyjesz dostawcy języka Python dla usługi aplikacja systemu Azure Configuration, aby scentralizować magazyn i zarządzanie ustawieniami aplikacji przy użyciu biblioteki klienta dostawcy aplikacja systemu Azure Configuration Python.

Dostawca usługi App Configuration języka Python to biblioteka działająca na podstawie zestawu Azure SDK dla języka Python, która ułatwia deweloperom języka Python łatwe korzystanie z usługi App Configuration. Umożliwia ona korzystanie z ustawień konfiguracji, takich jak słownik.

Wymagania wstępne

Konto platformy Azure z aktywną subskrypcją. Utwórz je bezpłatnie.
Magazyn usługi App Configuration. Utwórz magazyn.
Python 3.8 lub nowszy — aby uzyskać informacje na temat konfigurowania języka Python w systemie Windows, zobacz dokumentację języka Python w systemie Windows

Dodawanie wartości klucz-wartość

Dodaj następujące wartości klucza do magazynu App Configuration. Aby uzyskać więcej informacji na temat dodawania wartości klucz-wartości do magazynu przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia, przejdź do artykułu Create a key-value (Tworzenie wartości klucza).

Key	Wartość	Etykieta	Typ zawartości
message	Hello (Cześć)	Pozostaw pole puste	Pozostaw pole puste
test.message	Witaj, test	Pozostaw pole puste	Pozostaw pole puste
my_json	{"key":"value"}	Pozostaw pole puste	application/json

Aplikacje konsolowe

W tej sekcji utworzysz aplikację konsolową i załadujesz dane ze sklepu App Configuration.

Nawiązywanie połączenia z usługą App Configuration

Utwórz nowy katalog dla projektu o nazwie app-configuration-quickstart.
```
mkdir app-configuration-quickstart
```
Przejdź do nowo utworzonego katalogu app-configuration-quickstart .
```
cd app-configuration-quickstart
```
Zainstaluj dostawcę aplikacja systemu Azure Configuration przy użyciu pip install polecenia .
```
pip install azure-appconfiguration-provider
```

Utwórz nowy plik o nazwie app-configuration-quickstart.py w katalogu app-configuration-quickstart i dodaj następujący kod:

Microsoft Entra ID (zalecane)
Parametry połączenia

Użyj polecenia DefaultAzureCredential , aby uwierzytelnić się w magazynie usługi App Configuration. Postępuj zgodnie z instrukcjami, aby przypisać poświadczenia roli Czytelnik danych konfiguracji aplikacji. Przed uruchomieniem aplikacji należy zezwolić na wystarczający czas na propagację uprawnień.

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

Uruchamianie aplikacji

Ustaw zmienną środowiskową.
- Microsoft Entra ID (zalecane)
- Parametry połączenia
Ustaw zmienną środowiskową o nazwie AZURE_APPCONFIG_ENDPOINT na punkt końcowy sklepu App Configuration znajdującego się w obszarze Przegląd sklepu w witrynie Azure Portal.

Jeśli używasz wiersza polecenia systemu Windows, uruchom następujące polecenie i uruchom ponownie wiersz polecenia, aby zezwolić na wprowadzenie zmian:
```
setx AZURE_APPCONFIG_ENDPOINT "endpoint-of-your-app-configuration-store"
```
Jeśli używasz programu PowerShell, uruchom następujące polecenie:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "endpoint-of-your-app-configuration-store"
```
Jeśli używasz systemu macOS lub Linux, uruchom następujące polecenie:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Ustaw zmienną środowiskową o nazwie AZURE_APPCONFIG_CONNECTION_STRING na parametry połączenia tylko do odczytu magazynu App Configuration znajdującego się w obszarze Klucze dostępu sklepu w witrynie Azure Portal.

Jeśli używasz wiersza polecenia systemu Windows, uruchom następujące polecenie i uruchom ponownie wiersz polecenia, aby zezwolić na wprowadzenie zmian:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
Jeśli używasz programu PowerShell, uruchom następujące polecenie:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "connection-string-of-your-app-configuration-store"
```
Jeśli używasz systemu macOS lub Linux, uruchom następujące polecenie:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
Po poprawnym ustawieniu zmiennej środowiskowej uruchom następujące polecenie, aby uruchomić aplikację lokalnie:
```
python app-configuration-quickstart.py
```
Powinny zostać wyświetlone następujące dane wyjściowe:
```
Hello
value
Hello test
message found: True
test.message found: False
```

Aplikacje sieci Web

Dostawca usługi App Configuration ładuje dane do Mapping obiektu dostępnego jako słownik, który może być używany w połączeniu z istniejącą konfiguracją różnych struktur języka Python. W tej sekcji pokazano, jak używać dostawcy usługi App Configuration w popularnych platformach internetowych, takich jak Flask i Django.

Kolba
Django

Możesz użyć aplikacja systemu Azure Configuration w istniejących aplikacjach internetowych platformy Flask, aktualizując jej wbudowaną konfigurację. Można to zrobić, przekazując obiekt dostawcy usługi App Configuration do update funkcji wystąpienia aplikacji Platformy Flask w pliku 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")

Możesz użyć aplikacja systemu Azure Configuration w istniejących aplikacjach internetowych Django, dodając następujące wiersze kodu do pliku settings.py

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

Aby uzyskać dostęp do poszczególnych ustawień konfiguracji w widokach Django, możesz odwoływać się do nich z obiektu dostawcy utworzonego w ustawieniach Django. Na przykład w pliku views.py:

# Import Django settings
from django.conf import settings

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

Pełne przykłady kodu dotyczące korzystania z usługi aplikacja systemu Azure Configuration w aplikacjach internetowych języka Python można znaleźć w repozytorium GitHub aplikacja systemu Azure Configuration.

Czyszczenie zasobów

Jeśli nie chcesz nadal korzystać z zasobów utworzonych w tym artykule, usuń utworzoną tutaj grupę zasobów, aby uniknąć naliczania opłat.

Ważne

Usunięcie grupy zasobów jest nieodwracalne. Grupa zasobów i wszystkie zasoby w niej są trwale usuwane. Upewnij się, że nie usuniesz przypadkowo nieprawidłowej grupy zasobów ani zasobów. Jeśli zasoby dla tego artykułu zostały utworzone w grupie zasobów zawierającej inne zasoby, które chcesz zachować, usuń każdy zasób oddzielnie z odpowiedniego okienka zamiast usuwać grupę zasobów.

Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
Wybierz pozycję Usuń grupę zasobów.
Zobaczysz prośbę o potwierdzenie usunięcia grupy zasobów. Wprowadź nazwę grupy zasobów, aby potwierdzić, a następnie wybierz pozycję Usuń.

Po kilku chwilach grupa zasobów i wszystkie jej zasoby zostaną usunięte.

Następne kroki

W tym przewodniku Szybki start utworzono nowy magazyn usługi App Configuration i przedstawiono sposób uzyskiwania dostępu do klucz-wartości z poziomu aplikacji w języku Python.

Aby uzyskać dodatkowe przykłady kodu, odwiedź stronę:

Przykładowy przykład platformy Django platformy Flask aplikacja systemu Azure Dostawca konfiguracji języka Python

Udostępnij za pośrednictwem