Nasazení funkcí pro cílové skupiny v aplikaci Node.js

V této příručce použijete filtr cílení k zavedení funkce cílovým skupinám pro vaši Node.js aplikaci. Další informace o filtru cílení najdete v tématu Zavedení funkcí cílovým skupinám.

Požadavky

Účet Azure s aktivním předplatným. Vytvořte si ho zdarma.
Úložiště konfigurace aplikací, jak je znázorněno v kurzu pro vytvoření úložiště.
Příznak funkce Beta s filtrem cílení. Vytvořte příznak funkce.
Verze LTS Node.js.

Vytvoření webové aplikace s příznakem funkce

V této části vytvoříte webovou aplikaci, která používá příznak funkce Beta k řízení přístupu k beta verzi webové stránky.

Nastavení projektu Node.js Express

Vytvořte složku s názvem targeting-filter-tutorial a inicializujte projekt.
```
mkdir targeting-filter-tutorial
cd targeting-filter-tutorial
npm init -y
```

Nainstalujte následující balíčky.

npm install @azure/app-configuration-provider
npm install @microsoft/feature-management
npm install express

Vytvořte nový soubor s názvem app.js a přidejte následující kód.

const express = require("express");
const server = express();
const port = "8080";

server.listen(port, () => {
    console.log(`Server is running at http://localhost:${port}`);
});

Připojení ke službě Azure App Configuration

Aktualizujte app.js a přidejte následující kód.

// Existing code ...
const appConfigEndpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
const { DefaultAzureCredential } = require("@azure/identity");
const { load } = require("@azure/app-configuration-provider");
const { FeatureManager, ConfigurationMapFeatureFlagProvider } = require("@microsoft/feature-management");

let appConfig;
let featureManager;

async function initializeConfig() {
    // Load feature flags from App Configuration.
    appConfig = await load(appConfigEndpoint, new DefaultAzureCredential(), {
        featureFlagOptions: {
            enabled: true,
            refresh: {
                enabled: true
            }
        }
    });

    // Create feature manager with feature flag provider that accesses feature flags from App Configuration.
    featureManager = new FeatureManager(
        new ConfigurationMapFeatureFlagProvider(appConfig));
}

// Use a middleware to refresh the configuration before each request.
server.use((req, res, next) => {
    appConfig.refresh();
    next();
});
// Existing code ...

Připojíte se ke službě Azure App Configuration a načtete příznaky funkcí, povolíte automatickou FeatureManager aktualizaci a později vytvoříte objekt pro přístup k příznakům funkcí. Před každou žádost se přidá middleware, který aktualizuje konfiguraci.

Aktualizujte kód, aby se zajistilo, že se server Express spustí až po úspěšném inicializaci konfigurace.

// Existing code ...
initializeConfig()
    .then(() => {
        // Start the express server.
        server.listen(port, () => {
            console.log(`Server is running at http://localhost:${port}`);
        });
    })

Použití příznaku funkce

Do souboru app.js přidejte následující kód, který nakonfiguruje obslužnou rutinu trasy pro server Express. Server bude obsluhovat jiný obsah podle toho, jestli je povolený příznak funkce Beta .

// Existing code ...
server.get("/", async (req, res) => {
    const isBetaEnabled = await featureManager.isEnabled("Beta");
    const [title, message] = isBetaEnabled 
        ? ["Beta Page", "This is a beta page."]
        : ["Home Page", "Welcome."];
    
    res.send(
        `<!DOCTYPE html>
        <html>
            <head><title>${title}</title></head>
            <body style="display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0;">
                <h1 style="text-align: center; font-size: 5rem;">${message}</h1>
            </body>
        </html>`
    );
});

initializeConfig()
// Existing code ...

Povolení cílení pro webovou aplikaci

Kontext cílení se vyžaduje při vyhodnocování funkcí s povoleným cílením. Pokud chcete explicitně poskytnout tento kontext pro vyhodnocení funkce, můžete ho předat jako parametr metodě featureManager.isEnabled .

const isBetaEnabled = await featureManager.isEnabled("Beta", { userId: "UserA", groups: ["Group1"] });

Ve webové aplikaci lze kontext cílení také poskytnout jako kontext okolí implementací ITargetingContextAccessor rozhraní. Kontext cílení v prostředí znamená, že cílové informace se automaticky načítají z prostředí, jako je aktuální požadavek HTTP, aniž by bylo nutné je explicitně předávat každému volání funkce featureManager.isEnabled().

V tomto kurzu použijete kontext cílení na okolí.

Za deklaraci serveru Express přidejte následující kód. K uložení aktuálního požadavku se používá AsyncLocalStorage, což umožňuje správci funkcí automaticky získat kontext cílení prostřednictvím zpětného volání přístupového rozhraní pro kontext cílení. Další podrobnosti najdete v tématu Použití AsyncLocalStorage pro kontext požadavku.

const express = require("express");
const server = express();
const port = 8080;

const { AsyncLocalStorage } = require("async_hooks");
const requestAccessor = new AsyncLocalStorage();
// Use a middleware to store request context.
server.use((req, res, next) => {
    // Store the request in AsyncLocalStorage for this request chain.
    requestAccessor.run(req, () => {
        next();
    });
});

// Create a targeting context accessor that retrieves user data from the current request.
const targetingContextAccessor = {
    getTargetingContext: () => {
        // Get the current request from AsyncLocalStorage.
        const request = requestAccessor.getStore();
        if (!request) {
            return undefined;
        }
        const { userId, groups } = request.query;
        return {
            userId: userId,
            groups: groups ? groups.split(",") : [] 
        };
    }
};
// Existing code ...

Při vytváření FeatureManager předáte přístupový prvek cílového kontextu do FeatureManagerOptions.

featureManager = new FeatureManager(
    new ConfigurationMapFeatureFlagProvider(appConfig),
    {
        targetingContextAccessor: targetingContextAccessor
    });

Po dokončení předchozích kroků by soubor app.js teď měl obsahovat následující úplnou implementaci.

const express = require("express");
const server = express();
const port = 8080;

const { AsyncLocalStorage } = require("async_hooks");
const requestAccessor = new AsyncLocalStorage();
// Use a middleware to store request context
server.use((req, res, next) => {
    // Store the request in AsyncLocalStorage for this request chain
    requestAccessor.run(req, () => {
        next();
    });
});

// Create a targeting context accessor that retrieves user data from the current request
const targetingContextAccessor = {
    getTargetingContext: () => {
        // Get the current request from AsyncLocalStorage
        const request = requestAccessor.getStore();
        if (!request) {
            return undefined;
        }
        const { userId, groups } = request.query;
        return {
            userId: userId,
            groups: groups ? groups.split(",") : [] 
        };
    }
};

const appConfigEndpoint = process.env.AZURE_APPCONFIG_ENDPOINT;
const { DefaultAzureCredential } = require("@azure/identity");
const { load } = require("@azure/app-configuration-provider");
const { FeatureManager, ConfigurationMapFeatureFlagProvider } = require("@microsoft/feature-management");

let appConfig;
let featureManager;

async function initializeConfig() {
    // Load feature flags from App Configuration.
    appConfig = await load(appConfigEndpoint, new DefaultAzureCredential(), {
        featureFlagOptions: {
            enabled: true,
            refresh: {
                enabled: true
            }
        }
    });

    // Create feature manager with feature flag provider that accesses feature flags from App Configuration and targeting context accessor.
    featureManager = new FeatureManager(
        new ConfigurationMapFeatureFlagProvider(appConfig),
        {
            targetingContextAccessor: targetingContextAccessor
        });
}

// Use a middleware to refresh the configuration before each request
server.use((req, res, next) => {
    appConfig.refresh();
    next();
});

server.get("/", async (req, res) => {
    const isBetaEnabled = await featureManager.isEnabled("Beta");
    const [title, message] = isBetaEnabled 
        ? ["Beta Page", "This is a beta page."]
        : ["Home Page", "Welcome."];
    
    res.send(
        `<!DOCTYPE html>
        <html>
            <head><title>${title}</title></head>
            <body style="display: flex; justify-content: center; align-items: center; min-height: 100vh; margin: 0;">
                <h1 style="text-align: center; font-size: 5rem;">${message}</h1>
            </body>
        </html>`
    );
});

// Initialize the configuration and start the server
initializeConfig()
    .then(() => {
        // Start the express server.
        server.listen(port, () => {
            console.log(`Server is running at http://localhost:${port}`);
        });
    })

Cílení filtru v akci

Nastavte proměnnou prostředí s názvem AZURE_APPCONFIG_ENDPOINT na koncový bod obchodu App Configuration, který najdete v části Přehled obchodu na webu Azure Portal.

Pokud používáte příkazový řádek systému Windows, spusťte následující příkaz a restartujte příkazový řádek, aby se změna projevila:
```
setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
```
Pokud používáte PowerShell, spusťte následující příkaz:
```
$Env:AZURE_APPCONFIG_ENDPOINT = "<endpoint-of-your-app-configuration-store>"
```
Pokud používáte macOS nebo Linux, spusťte následující příkaz:
```
export AZURE_APPCONFIG_ENDPOINT='<endpoint-of-your-app-configuration-store>'
```
Aplikaci spusťte.
```
node app.js
```
Otevřete prohlížeč a přejděte na localhost:8080. Měli byste vidět výchozí zobrazení aplikace.
1. Přidejte userId jako parametr dotazu v adrese URL a zadejte ID uživatele. Navštivte localhost:8080/?userId=test@contoso.com. Zobrazí se stránka beta verze, protože test@contoso.com je určená jako cílový uživatel.
Navštivte localhost:8080/?userId=testuser@contoso.com. Beta stránku nevidíte, protože testuser@contoso.com je určená jako vyloučený uživatel.

Další kroky

Další informace o filtrech funkcí najdete v následujících dokumentech.

Povolování podmíněných funkcí pomocí filtrů funkcí

Povolení funkcí podle plánu

Úplný přehled funkcí knihovny pro správu funkcí JavaScriptu najdete v následujícím dokumentu.

Správa funkcí .NET

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-07-10