快速入門：將功能旗標新增至Node.js控制台應用程式

發行項
12/17/2024

在本快速入門中，您會將 Azure 應用程式組態併入Node.js控制台應用程式，以建立功能管理的端對端實作。您可以使用應用程式組態服務來集中儲存所有功能旗標及控制其狀態。

JavaScript 功能管理連結庫會使用功能旗標支援來擴充架構。它們可透過其 JavaScript 設定提供者與應用程式組態緊密整合。例如，本教學課程示範如何在Node.js應用程式中使用JavaScript功能管理。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。
應用程式組態存放區。建立存放區。
Node.js 的 LTS 版本。如需關於直接在 Windows 上或是使用 Windows 子系統 Linux 版 (WSL) 安裝 Node.js，請參閱開始使用 Node.js

新增功能旗標

將名為 Beta 的功能旗標新增至應用程式組態存放區，並保留標籤和描述的預設值。如需如何使用 Azure 入口網站或 CLI 將功能旗標新增至存放區的詳細資訊，請移至建立功能旗標。

啟用功能旗標

使用 npm install 命令安裝功能管理。
```
npm install @microsoft/feature-management
```

建立名為 app.js 的 檔案，並新增下列程序代碼。

Microsoft Entra ID (建議)
連接字串

您可以使用 DefaultAzureCredential 來向應用程式組態存放區進行驗證。請遵循指示，將認證指派給應用程式組態數據讀取者角色。在執行應用程式之前，請務必允許足夠的時間來傳播許可權。

const sleepInMs = require("util").promisify(setTimeout);
const { load } = require("@azure/app-configuration-provider");
const { DefaultAzureCredential } = require("@azure/identity");
const { FeatureManager, ConfigurationMapFeatureFlagProvider} = require("@microsoft/feature-management");
const endpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
const credential = new DefaultAzureCredential(); // For more information, see https://learn.microsoft.com/azure/developer/javascript/sdk/credential-chains#use-defaultazurecredential-for-flexibility

async function run() {
    // Connect to Azure App Configuration using endpoint and token credential
    const settings = await load(endpoint, credential, {
        featureFlagOptions: {
            enabled: true,
            // Note: selectors must be explicitly provided for feature flags.
            selectors: [{
                keyFilter: "*"
            }],
            refresh: {
                enabled: true,
                refreshIntervalInMs: 10_000
            }
        }
    });

    // Create a feature flag provider which uses a map as feature flag source
    const ffProvider = new ConfigurationMapFeatureFlagProvider(settings);
    // Create a feature manager which will evaluate the feature flag
    const fm = new FeatureManager(ffProvider);

    while (true) {
        await settings.refresh(); // Refresh to get the latest feature flag settings
        const isEnabled = await fm.isEnabled("Beta"); // Evaluate the feature flag
        console.log(`Beta is enabled: ${isEnabled}`);
        await sleepInMs(5000);
    }
}

run().catch(console.error);

const sleepInMs = require("util").promisify(setTimeout);
const { load } = require("@azure/app-configuration-provider");
const { FeatureManager, ConfigurationMapFeatureFlagProvider} = require("@microsoft/feature-management");
const connectionString = process.env.AZURE_APPCONFIG_CONNECTION_STRING;

async function run() {
    // Connect to Azure App Configuration using connection string
    const settings = await load(connectionString, {
        featureFlagOptions: {
            enabled: true,
            // Note: selectors must be explicitly provided for feature flags.
            selectors: [{
                keyFilter: "*"
            }],
            refresh: {
                enabled: true,
                refreshIntervalInMs: 10_000
            }
        }
    });

    // Create a feature flag provider which uses a map as feature flag source
    const ffProvider = new ConfigurationMapFeatureFlagProvider(settings);
    // Create a feature manager which will evaluate the feature flag
    const fm = new FeatureManager(ffProvider);

    while (true) {
        await settings.refresh(); // Refresh to get the latest feature flag settings
        const isEnabled = await fm.isEnabled("Beta"); // Evaluate the feature flag
        console.log(`Beta is enabled: ${isEnabled}`);
        await sleepInMs(5000);
    }
}

run().catch(console.error);

執行應用程式

設定環境變數。
- Microsoft Entra ID (建議)
- 連接字串
將名為 AZURE_APPCONFIG_ENDPOINT 的環境變數設定為應用程式組態存放區端點，該存放區位於 Azure 入口網站的市集概觀底下。

如果您使用 Windows 命令提示字元，請執行下列命令，然後重新啟動命令提示字元以讓變更生效：
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
如果您使用 PowerShell，請執行下列命令：
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
如果您使用 macOS 或 Linux，請執行下列命令：
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
將名為 AZURE_APPCONFIG_CONNECTION_STRING 的環境變數設定為應用程式組態存放區在 Azure 入口網站中存放區存取金鑰下找到的唯讀連接字串。

如果您使用 Windows 命令提示字元，請執行下列命令，然後重新啟動命令提示字元以讓變更生效：
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
如果您使用 PowerShell，請執行下列命令：
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<connection-string-of-your-app-configuration-store>"
```
如果您使用 macOS 或 Linux，請執行下列命令：
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
執行下列命令，在本機執行應用程式：
```
node app.js
```
您會看到下列控制台輸出， 因為 Beta 功能旗標已停用。
```
Beta is enabled: false
```
登入 Azure 入口網站。選取 [所有資源]，然後選取您之前建立的應用程式設定存放區。
選取 [功能管理員]，找到 Beta 功能旗標。選取 [啟用] 下的核取方塊，以啟用旗標。
等候幾秒鐘，您會看到主控台輸出變更。
```
Beta is enabled: true
```

共用方式為

快速入門：將功能旗標新增至Node.js控制台應用程式

必要條件

新增功能旗標

啟用功能旗標

執行應用程式

意見反應

其他資源