День 1652. #ЗаметкиНаПолях
Флаги функций в ASP.NET Core. Продолжение
Начало

2. Фильтр по времени
Если мы хотим, чтобы функция была включена только в течение определённого временного окна, используем TimeWindowFilter.
Сначала зарегистрируем фильтр:

builder.Services.AddFeatureManagement()
  .AddFeatureFilter<TimeWindowFilter>();

В appsettings.json, определим конфигурацию:

"FeatureManagement": {
  // …
  "TimeFeature": {
   "EnabledFor": [
    {
     "Name": "TimeWindow",
     "Parameters": {
       "Start": "2023-08-09T09:00:00+03:00",
       "End": "2023-08-24T11:00:00+03:00"
     }
   }
  ]
 }
}

Функция TimeFeature будет включена с 09:00 (Мск) 09.08.2023 до 11:00 (Мск) 24.08.2023. Проверка работы функции аналогична логическому фильтру.

3. Процентный фильтр
Аналогично фильтру по времени, нужно добавить его в сервисы:

 ….AddFeatureFilter<PercentageFilter>();

И в appsettings.json:

"FeatureManagement": {
 "PercentFeature": {
   "EnabledFor": [
   {
     "Name": "Percentage",
     "Parameters": {
      "Value": 50
    }
   }
  ]
 }
}

Эта функция будет «включена» в 50% случаев.

4. Фильтр таргетинга
Фильтры таргетинга позволяют включить функцию для определённых пользователей или групп. Как обычно, нам нужно зарегистрировать фильтр таргетинга:

….AddFeatureFilter<TargetingFilter>();

И добавить настройку в appsettings.json:

"FeatureManagement": {
 "TargetFeature": {
  "EnabledFor": [
   {
    "Name": "Targeting",
    "Parameters": {
     "Audience": {
      "Users": [],
      "Groups": [
       {
        "Name": "Beta Testers",
        "RolloutPercentage": 20
       }
      ]
     }
    }
   }
  ]
 }
}

Здесь функция TargetFeature будет доступна для 20% пользователей из группы "Beta Testers". В Users можно задать список Id отдельных пользователей.

Также мы должны добавить логику определения аудитории. Для этого нужно создать сервис реализующий интерфейс ITargetingContextAccessor и зарегистрировать его в DI.
Интерфейс содержит один метод GetContextAsync(), возвращающий ValueTask<TargetingContext>. TargetingContext, в свою очередь, содержит свойства:
- UserId (строка) – сопоставляется со списком Users в appsettings,
- Groups (коллекция строк) – сопоставляется со списком Groups.
Для определения Id или группы для текущего пользователя, в сервис, реализующий ITargetingContextAccessor, можно внедрить IHttpContextAccessor (об этом завтра).

Продолжение следует…

Источник: https://code-maze.com/aspnetcore-feature-flags/