التشغيل السريع: إضافة علامات الميزات إلى تطبيق وحدة تحكم Node.js

مقالة
٢٦‏/٠٨‏/١٤٤٦ هـ

في هذا التشغيل السريع، يمكنك دمج Azure App Configuration في تطبيق وحدة تحكم Node.js لإنشاء تنفيذ شامل لإدارة الميزات. يمكنك استخدام App Configuration لتخزين جميع علامات الميزات الخاصة بك مركزيا والتحكم في حالاتها.

توسع مكتبات إدارة ميزات JavaScript إطار العمل بدعم علامة الميزة. وهي تتكامل بسلاسة مع App Configuration من خلال موفر تكوين JavaScript الخاص بها. على سبيل المثال، يوضح هذا البرنامج التعليمي كيفية استخدام إدارة ميزات JavaScript في تطبيق Node.js.

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.
متجر App Configuration. إنشاء متجر.
إصدارات "LTS" من "Node.js". للحصول على معلومات حول تثبيت "Node.js" إما مباشرةً على الـWindows أو باستخدام نظام Windows الفرعي لـ Linux، يُرجى الرجوع إلى بدء استخدام "Node.js"

إضافة علامة ميزة

أضف علامة ميزة تسمى Beta إلى متجر App Configuration واترك Label and Description بقيمها الافتراضية. لمزيد من المعلومات حول كيفية إضافة علامات الميزات إلى متجر باستخدام مدخل Microsoft Azure أو CLI، انتقل إلى إنشاء علامة ميزة.

استخدام علامة الميزة

تثبيت إدارة الميزات باستخدام npm install الأمر .
```
npm install @microsoft/feature-management
```

أنشئ ملفا باسم app.js وأضف التعليمات البرمجية التالية.

معرف Microsoft Entra (مستحسن)
سلسلة الاتصال

يمكنك استخدام DefaultAzureCredential للمصادقة على متجر App Configuration. اتبع الإرشادات لتعيين بيانات الاعتماد الخاصة بك دور قارئ بيانات تكوين التطبيق. تأكد من السماح بوقت كاف للإذن للنشر قبل تشغيل التطبيق الخاص بك.

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 (مستحسن)
- سلسلة الاتصال
قم بتعيين متغير البيئة المسمى AZURE_APPCONFIG_ENDPOINT إلى نقطة نهاية متجر App Configuration الموجود ضمن نظرة عامة على متجرك في مدخل Microsoft 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 إلى سلسلة الاتصال للقراءة فقط لمتجر App Configuration الموجود ضمن مفاتيح الوصول لمتجرك في مدخل Microsoft 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. حدد All resources، وحدد App Configuration store الذي قمت بإنشائه مسبقا.
حدد إدارة الميزات وحدد موقع علامة ميزة Beta . قم بتمكين العلامة عن طريق تحديد خانة الاختيار ضمن ممكن.
انتظر لبضع ثوان وسترى مخرجات وحدة التحكم تتغير.
```
Beta is enabled: true
```

الخطوات التالية

للتشغيل الكامل للميزة لمكتبة إدارة الميزات JavaScript.NET، تابع إلى المستند التالي.

إدارة ميزات JavaScript

بينما تسمح لك علامة الميزة بتنشيط الوظائف أو إلغاء تنشيطها في تطبيقك، فقد تحتاج إلى تخصيص علامة ميزة استنادا إلى منطق التطبيق. تسمح لك عوامل تصفية الميزات بتمكين علامة ميزة بشكل مشروط. لمزيد من المعلومات، تابع إلى البرنامج التعليمي التالي.

تمكين الميزات الشرطية باستخدام عوامل تصفية الميزات

يوفر Azure App Configuration عوامل تصفية ميزات مضمنة تمكنك من تنشيط علامة ميزة فقط خلال فترة معينة أو لجمهور مستهدف معين من تطبيقك. لمزيد من المعلومات، تابع إلى البرنامج التعليمي التالي.

تمكين الميزات في جدول زمني

طرح الميزات للجماهير المستهدفة