Schnellstart: Erstellen einer Python-App mit Azure App Configuration

Artikel
11/20/2023

In dieser Schnellstartanleitung verwenden Sie den Python-Anbieter von Azure App Configuration zum Zentralisieren der Speicherung und Verwaltung von Anwendungseinstellungen mithilfe der Clientbibliothek des Python-Anbieters von Azure App Configuration.

Der Python-Anbieter von App Configuration ist eine Bibliothek, die auf dem Azure SDK für Python ausgeführt wird und Python-Entwicklern hilft, den Dienst App Configuration problemlos zu nutzen. Er ermöglicht die Verwendung von Konfigurationseinstellungen wie ein Wörterbuch.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto.
Ein App Configuration-Speicher. Erstellen Sie einen Speicher.
Python 3.8 oder höher: Informationen zum Einrichten von Python unter Windows finden Sie in der Dokumentation zu Python unter Windows.

Schlüsselwerte hinzufügen

Fügen Sie dem App Configuration-Speicher die folgenden Schlüsselwerte hinzu. Weitere Informationen zum Hinzufügen von Schlüssel-Wert-Paaren zu einem Speicher mithilfe des Azure-Portals oder der CLI finden Sie unter Erstellen eines Schlüssel-Wert-Paars.

Schlüssel	Wert	Bezeichnung	Inhaltstyp
Nachricht	Hello	Leer lassen	Leer lassen
test.message	Hello test	Leer lassen	Leer lassen
my_json	{"key":"value"}	Leer lassen	Anwendung/json

Konsolenanwendungen

In diesem Abschnitt werden Sie eine Konsolenanwendung erstellen und laden Daten aus Ihrem App Configuration-Speicher.

Herstellen einer Verbindung mit App Configuration

Erstellen Sie ein neues Verzeichnis für das Projekt mit dem Namen app-configuration-quickstart.
```
mkdir app-configuration-quickstart
```
Wechseln Sie zum neu erstellten Verzeichnis app-configuration-quickstart.
```
cd app-configuration-quickstart
```
Installieren Sie den Azure App Configuration-Anbieter mit dem Befehl pip install.
```
pip install azure-appconfiguration-provider
```

Erstellen Sie im Verzeichnis app-configuration-quickstart eine neue Datei mit dem Namen app-configuration-quickstart.py, und fügen Sie ihr den folgenden Code hinzu:

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

Ausführen der Anwendung

Legen Sie eine Umgebungsvariable mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING auf die Verbindungszeichenfolge für Ihren App Configuration-Speicher fest. Führen Sie an der Befehlszeile den folgenden Befehl aus:
Um die App mithilfe der Windows-Eingabeaufforderung lokal auszuführen, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
```
Wenn Sie Windows PowerShell verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
```
Wenn Sie macOS verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Wenn Sie Linux verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
```
Geben Sie mit dem unten stehenden Befehl den Wert der Umgebungsvariablen aus, um zu überprüfen, ob sie richtig festgelegt wurde.
Starten Sie die Eingabeaufforderung über eine Windows-Eingabeaufforderung neu, damit die Änderung wirksam wird, und führen Sie den folgenden Befehl aus:
```
echo %AZURE_APPCONFIG_CONNECTION_STRING%
```
Führen Sie bei Verwendung von Windows PowerShell den folgenden Befehl aus:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING
```
Führen Sie bei Verwendung von macOS den folgenden Befehl aus:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Führen Sie bei Verwendung von Linux den folgenden Befehl aus:
```
echo "$AZURE_APPCONFIG_CONNECTION_STRING"
```
Nachdem die Umgebungsvariable ordnungsgemäß festgelegt wurde, führen Sie den folgenden Befehl aus, um die App lokal auszuführen:
```
python app-configuration-quickstart.py
```
Die folgende Ausgabe wird angezeigt.
```
Hello
value
Hello test
message found: True
test.message found: False
```

Webanwendungen

Der App Configuration-Anbieter lädt Daten in ein Mapping-Objekt, das als Wörterbuch zugänglich ist und in Kombination mit der vorhandenen Konfiguration verschiedener Python-Frameworks verwendet werden kann. Dieser Abschnitt zeigt, wie Sie den App Configuration-Anbieter in beliebten Webframeworks wie Flask und Django verwenden.

Flask
Django

Sie können Azure App Configuration in Ihren vorhandenen Flask-Web-Apps verwenden, indem Sie deren integrierte Konfiguration aktualisieren. Hierzu können Sie Ihr App Configuration-Anbieterobjekt an die update-Funktion Ihrer Flask-App-Instanz in app.py übergeben:

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

Sie können Azure App Configuration in Ihren vorhandenen Django-Web-Apps verwenden, indem Sie Ihrer settings.py-Datei die folgenden Codezeilen hinzufügen

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

Um auf einzelne Konfigurationseinstellungen in den Django-Ansichten zuzugreifen, können Sie über das in den Django-Einstellungen erstellte Anbieterobjekt auf diese verweisen. Gehen Sie beispielsweise in views.py folgendermaßen vor:

# Import Django settings
from django.conf import settings

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

Vollständige Codebeispiele zur Verwendung Azure App Configuration in Python-Webanwendungen finden Sie im GitHub-Repository für Azure App Configuration.

Bereinigen von Ressourcen

Wenn Sie die in diesem Artikel erstellten Ressourcen nicht mehr verwenden möchten, löschen Sie die erstellte Ressourcengruppe, um Kosten zu vermeiden.

Wichtig

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden. Die Ressourcengruppe und alle darin enthaltenen Ressourcen werden unwiderruflich gelöscht. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen. Falls Sie die Ressourcen für diesen Artikel in einer Ressourcengruppe erstellt haben, die andere beizubehaltende Ressourcen enthält, löschen Sie die Ressourcen einzeln über den entsprechenden Bereich, statt die Ressourcengruppe zu löschen.

Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.
Geben Sie im Feld Nach Name filtern den Namen Ihrer Ressourcengruppe ein.
Wählen Sie in der Ergebnisliste den Ressourcengruppennamen aus, um eine Übersicht anzuzeigen.
Wählen Sie die Option Ressourcengruppe löschen.
Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen. Geben Sie zur Bestätigung den Namen Ihrer Ressourcengruppe ein, und klicken Sie auf Löschen.

Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie einen neuen App Configuration-Speicher erstellt und gelernt, wie Sie aus einer Python-App auf Schlüsselwerte zugreifen.

Weitere Codebeispiele finden Sie unter:

Beispiel für Django Beispiel für Flask Python-Anbieter für Azure App Configuration

Freigeben über