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

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

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.

Połączenie do usługi App Configuration

  1. Utwórz nowy katalog dla projektu o nazwie app-configuration-quickstart.

    mkdir app-configuration-quickstart
    
  2. Przejdź do nowo utworzonego katalogu app-configuration-quickstart .

    cd app-configuration-quickstart
    
  3. Zainstaluj dostawcę aplikacja systemu Azure Configuration przy użyciu pip install polecenia .

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

    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

  1. Ustaw zmienną środowiskową o nazwie AZURE_APPCONFIG_CONNECTION_STRING i ustaw ją na parametry połączenia magazynu App Configuration. W wierszu polecenia uruchom następujące polecenie:

    Aby uruchomić aplikację lokalnie przy użyciu wiersza polecenia systemu Windows, uruchom następujące polecenie i zastąp <app-configuration-store-connection-string> parametry połączenia magazynu konfiguracji aplikacji:

    setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
    
  2. Wyświetl wartość zmiennej środowiskowej, aby sprawdzić, czy jest ona poprawnie ustawiona za pomocą poniższego polecenia.

    Korzystając z wiersza polecenia systemu Windows, uruchom ponownie wiersz polecenia, aby zezwolić na wprowadzenie zmiany i uruchomić następujące polecenie:

    echo %AZURE_APPCONFIG_CONNECTION_STRING%
    
  3. 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.

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

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.

  1. Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
  2. W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
  3. Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
  4. Wybierz pozycję Usuń grupę zasobów.
  5. 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ę: