استخدام عوامل تصفية المعالم لتمكين علامات المعالم الشرطية
تسمح لك علامات الميزات بتنشيط الوظائف أو إلغاء تنشيطها في تطبيقك. علامة ميزة بسيطة إما قيد التشغيل أو الإيقاف. يتصرف التطبيق دائما بنفس الطريقة. على سبيل المثال، يمكنك طرح ميزة جديدة خلف علامة ميزة. عند تمكين علامة الميزة، يرى جميع المستخدمين الميزة الجديدة. يؤدي تعطيل علامة الميزة إلى إخفاء الميزة الجديدة.
في المقابل، تسمح علامة المعالم الشرطية بتمكين علامة المعلم أو تعطيلها ديناميكيا. قد يتصرف التطبيق بشكل مختلف ، اعتمادا على معايير علامة الميزة. لنفترض أنك تريد عرض ميزتك الجديدة على مجموعة فرعية صغيرة من المستخدمين في البداية. تسمح لك علامة الميزة الشرطية بتمكين علامة الميزة لبعض المستخدمين مع تعطيلها للآخرين. تحدد فلاتر المعالم حالة علامة المعلم في كل مرة يتم تقييمها.
تتضمن Microsoft.FeatureManagement المكتبة ثلاثة مرشحات للميزات:
PercentageFilterتمكين علامة الميزة استنادا إلى نسبة مئوية.TimeWindowFilterتمكين علامة الميزة خلال فترة زمنية محددة.TargetingFilterتمكين علامة الميزة للمستخدمين والمجموعات المحددة.
يمكنك أيضا إنشاء عامل تصفية الميزات الخاص بك الذي يقوم بتنفيذ واجهة Microsoft.FeatureManagement.IFeatureFilter.
تسجيل مرشح ميزة
يمكنك تسجيل عامل تصفية معالم عن طريق استدعاء الأسلوب AddFeatureFilter ، وتحديد اسم نوع عامل تصفية المعالم المطلوبة. على سبيل المثال، يتم تسجيل PercentageFilterالتعليمات البرمجية التالية:
public void ConfigureServices(IServiceCollection services)
{
services.AddControllersWithViews();
services.AddFeatureManagement().AddFeatureFilter<PercentageFilter>();
}
تكوين عامل تصفية معالم في تكوين تطبيق Azure
تحتوي بعض فلاتر الميزات على إعدادات إضافية. على سبيل المثال، PercentageFilter تنشيط ميزة استنادا إلى نسبة مئوية. يحتوي على إعداد يحدد النسبة المئوية للاستخدام.
يمكنك تكوين هذه الإعدادات لعلامات المعالم المحددة في تكوين تطبيق Azure. على سبيل المثال، اتبع الخطوات التالية لاستخدامها PercentageFilter لتمكين علامة الميزة ل 50٪ من الطلبات إلى تطبيق ويب:
اتبع الإرشادات الواردة في التشغيل السريع: أضف علامات ميزات إلى تطبيق ASP.NET Core لإنشاء تطبيق ويب باستخدام علامة ميزة.
في مدخل Azure، انتقل إلى مخزن التكوين وانقر فوق مدير المعالم.
انقر فوق قائمة السياق لعلامة ميزة Beta التي أنشأتها في التشغيل السريع. انقر فوق Edit.
في شاشة تحرير ، حدد خانة الاختيار تمكين علامة الميزة إذا لم تكن ممكنة بالفعل. ثم حدد خانة الاختيار استخدام عامل تصفية الميزاتوحدد مخصص.
في الحقل "الاسم"، حدد Microsoft.Percentage.
انقر على قائمة السياق بجوار اسم فلتر الميزات. انقر على تحرير معلمات الفلتر.
أدخل اسمالقيمةوالقيمة 50. يشير الحقل "القيمة" إلى النسبة المئوية للطلبات التي سيتم تمكين عامل تصفية المعالم لها.
انقر فوق تطبيق للعودة إلى شاشة علامة تحرير الميزة. ثم انقر فوق تطبيق مرة أخرى لحفظ إعدادات علامة الميزة.
في صفحة مدير المعالم ، تحتوي علامة المعالم الآن على قيمة عامل تصفية ميزةمخصص.
مرشحات الميزات أثناء العمل
لرؤية تأثيرات علامة الميزة هذه ، قم بتشغيل التطبيق واضغط على زر التحديث في متصفحك عدة مرات. سترى أن عنصر Beta يظهر على شريط الأدوات حوالي 50٪ من الوقت. يتم إخفاؤه بقية الوقت ، لأن PercentageFilter ميزة Beta تقوم بإلغاء تنشيط مجموعة فرعية من الطلبات. يعرض الفيديو التالي هذا السلوك أثناء العمل.
