Início rápido: Adicionar sinalizadores de recursos a um aplicativo de console Node.js

Artigo
02/25/2025

Neste início rápido, você incorporará a Configuração de Aplicativos do Azure a um aplicativo de console Node.js para criar uma implementação de ponta a ponta do gerenciamento de recursos. Você pode usar a Configuração de Aplicativos para armazenar centralmente todos os sinalizadores de recursos e controlar seus estados.

As bibliotecas de Gerenciamento de Recursos do JavaScript estendem a estrutura com suporte ao sinalizador de recursos. Elas são integradas diretamente à Configuração de Aplicativos por meio de seu provedor de configuração do JavaScript. Por exemplo, este tutorial mostra como usar o Gerenciamento de Recursos do JavaScript em um aplicativo Node.js.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
Um repositório de Configuração de Aplicativos. Criar um repositório.
Versões LTS do Node.js. Para obter informações sobre como instalar o Node.js diretamente no Windows ou usando o WSL (Subsistema do Windows para Linux), confira Introdução ao Node.js

Adicionar um sinalizador de recursos

Adicione um sinalizador de recurso chamado Beta ao repositório da Configuração de Aplicativos e deixe o Rótulo e a Descrição com seus valores padrão. Para mais informações sobre como adicionar sinalizadores de recursos a um repositório usando o portal do Azure ou a CLI, acesse Criar um sinalizador de recurso.

Usar o sinalizador de recurso

Instale o Gerenciamento de Recursos usando o comando npm install.
```
npm install @microsoft/feature-management
```

Crie um arquivo chamado app.js e adicione o código a seguir.

Microsoft Entra ID (recomendado)
Cadeia de conexão

Você usa a autenticação DefaultAzureCredential no repositório de Configuração de Aplicativos. Siga as instruções para atribuir à credencial a função Leitor de Dados de Configuração de Aplicativo. Certifique-se de permitir tempo suficiente para a permissão se propagar antes de executar seu aplicativo.

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

Executar o aplicativo

Defina a variável de ambiente .
- Microsoft Entra ID (recomendado)
- Cadeia de conexão
Defina a variável de ambiente chamada AZURE_APPCONFIG_ENDPOINT como o ponto de extremidade do seu repositório de configuração de aplicativos, encontrado na Visão geral do seu repositório no portal do Azure.

Se você usar o prompt de comando do Windows, execute o comando a seguir e reinicie o prompt de comando para permitir que a alteração entre em vigor:
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Se você usar o PowerShell, execute o seguinte comando:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
Se você usa macOS ou Linux, execute o comando a seguir:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Defina a variável de ambiente chamada AZURE_APPCONFIG_CONNECTION_STRING como a cadeia de conexão somente leitura do seu repositório de configuração de aplicativos, encontrada em Chaves de acesso do seu repositório no portal do Azure.

Se você usar o prompt de comando do Windows, execute o comando a seguir e reinicie o prompt de comando para permitir que a alteração entre em vigor:
```
setx AZURE_APPCONFIG_CONNECTION_STRING "<connection-string-of-your-app-configuration-store>"
```
Se você usar o PowerShell, execute o seguinte comando:
```
$Env:AZURE_APPCONFIG_CONNECTION_STRING = "<connection-string-of-your-app-configuration-store>"
```
Se você usa macOS ou Linux, execute o comando a seguir:
```
export AZURE_APPCONFIG_CONNECTION_STRING='<connection-string-of-your-app-configuration-store>'
```
Execute o seguinte comando para executar o aplicativo localmente:
```
node app.js
```
Você verá as seguintes saídas de console porque o sinalizador de recursos Beta está desabilitado.
```
Beta is enabled: false
```
Entre no portal do Azure. Escolha Todos os recursos e escolha o repositório de Configuração de Aplicativos que você criou anteriormente.
Selecione Gerenciador de recursos e localize o sinalizador de recurso Beta. Habilite o sinalizador marcando a caixa de seleção abaixo de Habilitado.
Aguarde alguns segundos e você verá as saídas do console alteradas.
```
Beta is enabled: true
```

Próximas etapas

Para ver o resumo completo da biblioteca de gerenciamento de recursos .NET, continue para o documento a seguir.

Gerenciamento de recursos JavaScript

Embora um sinalizador de recurso permita ativar ou desativar a funcionalidade em seu aplicativo, convém personalizar um sinalizador de recurso com base na lógica do aplicativo. Os filtros de recursos permitem habilitar um sinalizador de recurso condicionalmente. Para saber mais, continue no tutorial a seguir.

Habilitar recursos condicionais com filtros de recursos

A Configuração de Aplicativos do Azure oferece filtros de recursos internos que permitem ativar um sinalizador de recurso somente durante um período específico ou para um público-alvo específico do seu aplicativo. Para saber mais, continue no tutorial a seguir.

Habilitar os recursos em um agendamento

Distribuir os recursos para os públicos-alvo

Compartilhar via