快速入門：在 Azure 應用程式組態中管理功能旗標

發行項
07/17/2024

Azure 應用程式組態包含功能旗標，可讓您啟用或停用特定功能，以及允許功能旗標多種變化的變化功能旗標 (預覽)。

在 Azure 入口網站中的功能管理員提供用來建立和管理功能旗標和變化功能旗標的 UI，供您在應用程式中使用。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。
應用程式組態存放區。建立存放區。

建立功能旗標

入口網站
Azure CLI

遵循下列步驟以新增新的功能旗標。

在 Azure 入口網站開啟您的 Azure 應用程式組態存放區，然後從 [作業] 功能表中，選取 [功能管理員]>[建立]。然後選取 [功能旗標]。

在 [建立] 下方，選取或輸入下列資訊：

設定	範例值	描述
啟用功能旗標	已勾選方塊	此選項在建立時會啟用功能旗標。如果您取消勾選此方塊，將會儲存新功能旗標的設定，但新功能旗標仍會維持停用狀態。
功能旗標名稱	Beta	功能旗標名稱可用於在程式碼中參考旗標內容。在應用程式內名稱必須是唯一。
索引鍵	Beta	您可以使用金鑰來篩選應用程式中載入的功能旗標。預設情況下，金鑰會從功能旗標名稱中產生，但您也可以新增前置詞或命名空間，以分組功能旗標，例如，.appconfig.featureflag/myapp/Beta。
標籤	保留空白	您可以使用並根據標籤，來針對載入至應用程式的相同金鑰和篩選旗標建立不同的功能旗標。根據預設，功能旗標沒有標籤。
說明	保留空白	保留空白或輸入功能旗標的描述。
使用功能篩選	未勾選方塊	功能篩選方塊維持未勾選。若要深入了解功能篩選，請瀏覽使用功能篩選來啟用條件式功能旗標和針對目標受眾啟用功能的分段推出。

選取 [套用] 以建立功能旗標。

使用 az appconfig feature set 命令，將功能旗標新增至應用程式組態存放區。以名稱或應用程式組態存放區，取代預留位置 <name>：

az appconfig feature set --name <name> --feature Beta

建立變體功能旗標 (預覽)

在 Azure 入口網站開啟您的 Azure 應用程式組態存放區，以新增新的變化功能旗標 (預覽)，然後從 [作業] 功能表中，選取 [功能管理員]>[建立]。接著選取 [變化功能旗標 (預覽)]。

設定基本

在 [詳細資料] 索引標籤中，選取或輸入下列資訊：

設定	範例值	描述
啟用功能旗標	已勾選方塊	此選項在建立時會啟用功能旗標。如果您取消勾選此方塊，將會儲存新功能旗標的設定，但新功能旗標仍會維持停用狀態。
名稱	問候	功能旗標名稱可用於在程式碼中參考旗標內容。在應用程式內名稱必須是唯一。
索引鍵	問候	您可以使用金鑰來篩選應用程式中載入的功能旗標。預設情況下，金鑰會從功能旗標名稱中產生，但您也可以新增前置詞或命名空間，以分組功能旗標，例如，.appconfig.featureflag/myapp/Greeting。
標籤	保留空白	您可以使用並根據標籤，來針對載入至應用程式的相同金鑰和篩選旗標建立不同的功能旗標。根據預設，功能旗標沒有標籤。
說明	保留空白	保留空白或輸入功能旗標的描述。

選取 [下一步]> 以新增 [變體]。

新增變體

在 [變體] 索引標籤中，選取或輸入下列資訊。

設定	範例值	描述
變體名稱	Off & On	根據預設會新增兩個變體。更新變體或輸入新變體的名稱。變體名稱在功能旗標內必須是唯一。
值	false & true	為每個變體提供值。此值可以是字串、數字、布林值或設定物件。若要在 JSON 編輯器中編輯值，您可以選取 [在多行中編輯值]。
預設變體	關閉	從下拉式清單中選擇預設變體。沒有指派變體至特定對象或停用功能旗標時，功能旗標會回傳預設變體。在指定的預設變體旁會顯示預設字樣。

選取 [下一步]> 以存取 [配置] 設定。

配置流量

在 [配置] 索引標籤中，選取或輸入下列資訊：

將流量分散至每個變體，加起來必須剛好為 100%。
選擇性地選取 [根據群組覆寫] 和 [根據使用者覆寫] 選項，以針對選取群組或使用者指派變體。預設會停用這些選項。
在 [散發] 下方，選擇性地選取 [使用自訂種子]，並提供非空白字串作為新的種子值。跨多個功能旗標使用通用種子，可配置相同的使用者至相同的百分位數。當您同時推出多個功能旗標，而且想確保每個物件區段皆獲得一致體驗時，這項功能非常實用。如果未指定任何自訂種子，則會根據功能名稱使用預設種子。
選取 [檢閱 + 建立] 以查看新變體功能旗標摘要，然後選取 [建立] 以完成作業。表示已成功建立新功能旗標的通知。

編輯功能旗標

若要更新功能旗標或變體功能旗標：

從 [作業] 功能表，選取 [功能管理員]。
前往您想要修改的功能旗標或變體功能旗標右端，然後選取 [更多動作] 省略號 (...)。在此功能表中，您可以編輯旗標、鎖定或解除鎖定旗標、建立標籤、更新標籤、檢閱歷程記錄、刪除旗標。
選取 [編輯] 並更新旗標。
透過開啟或關閉 [啟用] 切換，以選擇性地變更功能旗標的狀態。

管理檢視

功能管理員 功能表會顯示儲存在 Azure 應用程式組態中的功能旗標和變體功能旗標。您可以選取 [管理檢視]，以變更 Azure 入口網站中顯示的功能管理員。

[設定] 可讓您選擇每個 [載入更多] 動作將載入多少功能旗標。 [載入更多] 只有在有超過 200 個功能旗標時才會顯示。
[編輯資料行] 可讓您新增或移除資料行，以及變更資料行順序。

使用功能管理員建立的功能旗標會以一般索引鍵/值的形式儲存。它們會保留特殊前置詞 .appconfig.featureflag/ 和內容類型 application/vnd.microsoft.appconfig.ff+json;charset=utf-8。若要在設定總管中檢視功能旗標的基礎索引鍵，請遵循下列步驟。