快速入門：將功能旗標新增至 Python 應用程式

發行項
07/01/2024

在本快速入門中，您將在 Azure 應用程式組態中建立功能旗標，並用它來動態控制 Python 應用程式，以建立功能管理的端對端實作。

功能管理支援會擴充應用程式設定中的動態設定功能。快速入門中的這些範例是以動態組態教學課程中介紹的 Python 應用程式為基礎來建置。繼續之前，請先完成快速入門和教學課程，以使用動態設定建立 Python 應用程式。

此連結庫不相依於任何 Azure 連結庫。它們可透過其 Python 設定提供者與應用程式組態緊密整合。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。
應用程式組態存放區。建立存放區。
Python 3.8 或更新版本 - 如需在 Windows 上設定 Python 的詳細資訊，請參閱 Windows 上的 Python 檔，否則請參閱 Python 下載。
azure-appconfiguration-provider 連結庫 1.2.0 或更新版本。

新增功能旗標

將名為 Beta 的功能旗標新增至應用程式組態存放區，並保留標籤和描述的預設值。如需如何使用 Azure 入口網站或 CLI 將功能旗標新增至存放區的詳細資訊，請移至建立功能旗標。在這個階段，應該取消核取 [啟用功能旗標檢查] bock。

主控台應用程式

使用 pip install 命令安裝功能管理。
```
pip install featuremanagement
```

建立名為 app.py 的新 Python 檔案，並新增下列程式代碼：

from featuremanagement import FeatureManager
from azure.identity import InteractiveBrowserCredential
from azure.appconfiguration.provider import load
import os
from time import sleep

endpoint = os.environ["APP_CONFIGURATION_ENDPOINT"]

# Connecting to Azure App Configuration using an endpoint
# credential is used to authenticate the client, the InteractiveBrowserCredential is used for this sample. It will open a browser window to authenticate the user. For all credential options see [credential classes](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credential-classes).
# feature_flag_enabled makes it so that the provider will load feature flags from Azure App Configuration
# feature_flag_refresh_enabled makes it so that the provider will refresh feature flags from Azure App Configuration, when the refresh operation is triggered
config = load(endpoint=endpoint, credential=InteractiveBrowserCredential(), feature_flag_enabled=True, feature_flag_refresh_enabled=True)

feature_manager = FeatureManager(config)

# Is always false
print("Beta is ", feature_manager.is_enabled("Beta"))

while not feature_manager.is_enabled("Beta"):
    sleep(5)
    config.refresh()

print("Beta is ", feature_manager.is_enabled("Beta"))

啟動應用程式時，瀏覽器視窗會開啟以驗證使用者。用戶必須至少有App Configuration Data Reader角色才能存取應用程式組態存放區，如需詳細資訊，請參閱應用程式組態角色。

設定名為 APP_CONFIGURATION_ENDPOINT 的環境變數，並將它設定為應用程式組態存放區的端點。在命令列執行下列命令，然後重新啟動命令提示字元，讓變更生效：
若要使用 Windows 命令提示字元在本機建置並執行應用程式，請執行下列命令：
```
setx APP_CONFIGURATION_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
重新啟動命令提示字元，讓變更生效。藉由列印環境變數的值來驗證它是否已正確設定。
如果您使用 Windows PowerShell，請執行下列命令：
```
$Env:APP_CONFIGURATION_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
如果您使用 macOS，請執行下列命令：
```
export APP_CONFIGURATION_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
重新啟動命令提示字元，讓變更生效。藉由列印環境變數的值來驗證它是否已正確設定。
如果您使用 Linux，請執行下列命令：
```
export APP_CONFIGURATION_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
重新啟動命令提示字元，讓變更生效。藉由列印環境變數的值來驗證它是否已正確設定。
執行 Python 應用程式。
```
python app.py
```
在應用程式組態入口網站中，選取 [功能管理員]，然後使用 [已啟用] 數據行中的切換，將 Beta 功能旗標的狀態變更為 [開啟]。

機碼州/省

Beta 另一
大約 30 秒之後，這是提供者的重新整理間隔，應用程式會列印下列內容：
```
Beta is True
```

機碼	州/省
Beta	另一

Web 應用程式

下列範例示範如何使用 Azure 應用程式組態動態重新整理來更新現有的 Web 應用程式，以使用功能旗標。如需如何使用動態重新整理設定值的更詳細範例，請參閱 Python 動態設定。在繼續之前，請確定您已在應用程式組態存放區中啟用 Beta 功能旗標。

Flask
Django

在 app.py中，設定 Azure 應用程式組態的載入方法，以額外載入功能旗標，以及啟用功能旗標的重新整理。

from featuremanagement import FeatureManager

...

global azure_app_config, feature_manager
# Connecting to Azure App Configuration using an endpoint
# credential is used to authenticate the client, the InteractiveBrowserCredential is used for this sample. It will open a browser window to authenticate the user. For all credential options see [credential classes](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credential-classes).
# feature_flag_enabled makes it so that the provider will load feature flags from Azure App Configuration
# feature_flag_refresh_enabled makes it so that the provider will refresh feature flags from Azure App Configuration, when the refresh operation is triggered
azure_app_config = load(endpoint=endpoint, credential=InteractiveBrowserCredential(),
                        refresh_on=[WatchKey("sentinel")],
                        on_refresh_success=on_refresh_success,
                        refresh_interval=10, # Default value is 30 seconds, shortened for this sample
                        feature_flag_enabled=True,
                        feature_flag_refresh_enabled=True,
                    )
feature_manager = FeatureManager(config)

同時更新您的路由，以檢查更新的功能旗標。

@app.route("/")
def index():
    ...
    context["message"] = azure_app_config.get("message")
    context["beta"] = feature_manager.is_enabled("Beta")
    ...

更新您的範本 index.html 以使用新功能旗標。

...

<body>
  <main>
    <div>
      <h1>{{message}}</h1>
      {% if beta %}
      <h2>Beta is enabled</h2>
      {% endif %}
    </div>
  </main>
</body>

更新並執行應用程式之後，您可以看到功能旗標作用中，訊息會出現在頁面上，Beta is enabled但前提是功能旗標是在應用程式組態存放區中啟用。

啟用功能旗標 Beta 已啟用的螢幕快照。

您可以在這裡找到完整的範例專案。

在 Django 設定檔中設定 Azure 應用程式組態，settings.py以載入功能旗標。

from featuremanagement import FeatureManager

...
# Connecting to Azure App Configuration using an endpoint
# credential is used to authenticate the client, the InteractiveBrowserCredential is used for this sample. It will open a browser window to authenticate the user. For all credential options see [credential classes](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credential-classes).
# feature_flag_enabled makes it so that the provider will load feature flags from Azure App Configuration
# feature_flag_refresh_enabled makes it so that the provider will refresh feature flags from Azure App Configuration, when the refresh operation is triggered
AZURE_APPCONFIGURATION = load(
        endpoint=endpoint, credential=InteractiveBrowserCredential(),
        refresh_on=[WatchKey("sentinel")],
        on_refresh_success=on_refresh_success,
        refresh_interval=10, # Default value is 30 seconds, shortened for this sample
        feature_flag_enabled=True,
        feature_flag_refresh_enabled=True,
    )
FEATURE_MANAGER = FeatureManager(config)

您可以存取功能旗標，以將它們新增至內容。例如，在 views.py 中：

def index(request):
    ...

    context = {
      "message": settings.AZURE_APPCONFIGURATION.get('message'),
      "beta": settings.FEATURE_MANAGER.is_enabled('Beta')
    }
    return render(request, 'hello_azure/index.html', context)

更新您的範本 index.html 以使用新的組態值。

<body>
  <main>
    <div>
      <h1>{{message}}</h1>
      {% if beta %}
      <h2>Beta is enabled</h2>
      {% endif %}
    </div>
  </main>
</body>

更新並執行應用程式之後，您可以看到功能旗標作用中，訊息會出現在頁面上，Beta is enabled但只有在功能旗標是在應用程式組態存放區中啟用時才會出現。

啟用功能旗標 Beta 已啟用的螢幕快照。

您可以在這裡找到完整的範例專案。

每當這些端點觸發時，就可以執行重新整理檢查，以確保使用最新的組態值。如果重新整理間隔尚未通過，或重新整理正在進行中，則檢查可以立即傳回。

當重新整理完成時，所有值都會立即更新，因此組態一律在物件內保持一致。

清除資源

如果您不想繼續使用本文中建立的資源，請刪除在此處建立的資源群組，以避免產生費用。

重要

刪除資源群組是無法回復的動作。資源群組和其中的所有資源都將被永久刪除。請確定您不會誤刪錯誤的資源群組或資源。如果您是在包含需保留其他資源的資源群組內部，建立本文的資源，則可以從每個資源各自的窗格中個別刪除每個資源，而不必刪除整個資源群組。

登入 Azure 入口網站，然後選取 [資源群組]。
在 [依名稱篩選] 方塊中，輸入您資源群組的名稱。
在結果清單中，選取資源群組名稱以查看概觀。
選取 [刪除資源群組]。
系統將會要求您確認是否刪除資源群組。輸入您資源群組的名稱以進行確認，然後選取 [刪除]。

不久後，系統便會刪除該資源群組及其所有的資源。

下一步

在本快速入門中，您已建立新的應用程式組態存放區，並用它來透過功能管理連結庫來管理 Python 應用程式中的功能。

深入了解功能管理。
管理功能旗標。

共用方式為