1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/didiopensource-FeatureProbe

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
USER_GUIDE.md 14 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 30.11.2024 08:20 735383a

Руководство пользователя

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

Популярные варианты использования

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

Кроме того, существует множество других сценариев, в которых мы можем использовать FeatureProbe.

  • Онлайн-промоакции Многие компании периодически проводят промоакции для увеличения продаж. Эти акции используют похожие шаблоны в большинстве случаев, и операционной команде нужно только изменить несколько параметров, чтобы создать новую акцию.

    • Пример использования: онлайн-платформа для покупок проводит распродажу «Чёрная пятница» и должна изменить цены на многие товары. В прошлом команда R&D меняла цены на товары и запускала изменения с помощью длительного рабочего процесса. Теперь они могут использовать FeatureProbe для переключения цен на товары и сделать их эффективными за секунду.

    • Процедура работы:

      • Операционная команда добавляет новый проект под названием «Мой первый проект» и добавляет переключатель функций под названием «commodity_spike_activity» для среды «онлайн».
      FPUser user = new FPUser(user_id);
      user.with("city", city_name);
      double discount = fpClient.numberValue("commodity_spike_activity", user, 1.0);
      discountSetTo(discount);
      • Разработчик импортирует SDK FeatureProbe в кодовую базу (например, код Java) и использует переключатель «commodity_spike_activity», устанавливая ключ sdk, который назначен FeatureProbe проекту «Мой первый проект», среде «онлайн». Тип вариации — число, пользовательский параметр — «город».

      • Разработчик запускает кодовую базу. Затем операционная команда включает переключатель, чтобы сделать ценовую политику на основе города эффективной.

      Если операционной группе необходимо изменить цены, они могут легко изменить настройки ценовой вариации в пользовательском интерфейсе FeatureProbe.

    • Отключение сервиса Когда онлайн-сервис сталкивается с чрезвычайно высокими требованиями, которые влияют на некоторые зависимые сервисы, или происходит что-то непредвиденное (например, бэкенд-сервис неожиданно становится недоступным), нам необходимо гарантировать, что основные сервисы работают без сбоев, используя кэшированные данные вместо получения данных от проблемных сервисов.

    Пример использования: сервису электронной коммерции необходимо вызвать службу инвентаризации для отображения информации о запасах товаров. Если служба инвентаризации сталкивается с некоторыми проблемами и недоступна, операционная группа может использовать FeatureProbe, чтобы получить данные о запасах из кэшированного контента в течение секунды и выполнить дорогостоящую операцию резервного копирования приложения или переключиться на резервный сервис без прерывания онлайн-сервиса.

    Процедура работы:

      * Команда R&D добавляет новый проект под названием «Мой первый проект» и добавляет переключатель функций под названием «store_service_fallback» для среды «онлайн».
    
      ```java
      FPUser user = new FPUser(user_id);
      boolean fallback = fpClient.boolValue("store_service_fallback", user, false);
      if (fallback) {
          // Do something.
      } else {
          // Do normal process.
      }
      ```
    • Разработчик импортирует SDK FeatureProbe в кодовую базу (например, код Java) и использует переключатель «store_service_fallback», устанавливая ключ sdk, назначенный FeatureProbe проекту «Мой первый проект», среде «онлайн». Тип вариации — логический, его результат включает или отключает деградацию. Проект под названием «Мобильное клиентское приложение» и другой проект под названием «Серверное приложение» настраиваются соответственно в своих уникальных средах и переключателях.

Система FeatureProbe предоставляет начальный проект по умолчанию под названием «Мой первый проект», который имеет две среды: test и online. Вы можете добавить больше проектов на вкладке «Проекты».

Вот шаги для добавления нового проекта:

  1. Перейдите на вкладку «Проекты», чтобы перейти на страницу проектов.
  2. Нажмите кнопку «+ Проект» в правом верхнем углу, чтобы открыть новую страницу ящика справа для создания проекта.
  3. Введите название нового проекта.
  4. Введите ключ. Это уникальное значение для определения проекта, которое нельзя изменить после создания проекта.
  5. Введите описание проекта.
  6. Создайте проект, нажав кнопку «Создать» в верхней части окна ящика. Теперь проект создан, и его нельзя удалить.
  7. Щёлкните карточку (карточка имеет название конкретной среды, такой как test или online) под проектом, чтобы перейти на конкретную страницу среды и увидеть переключатели.

Редактирование проектов

Вы можете выбрать редактирование проекта, щёлкнув значок с тремя вертикальными точками в правом верхнем углу проекта. Вы можете изменить выбранное имя проекта или/и описание и сохранить изменения.

Добавление среды проекта

Вы можете добавить новые среды для своего проекта и сделать переключатели доступными для разных сред.

Вот шаги, чтобы добавить новую среду:

  1. Щёлкните значок с тремя вертикальными точками в правом верхнем углу проекта и выберите пункт меню «Добавить среду».
  2. Заполните имя среды.
  3. Заполните ключ. Он должен быть уникальным в рамках проекта, и его нельзя изменить после создания среды.
  4. Нажмите кнопку «Подтвердить», чтобы создать среду. Её нельзя удалить после создания.

Примечание: Недавно созданная среда использует переключатели всех сред в рамках одного проекта. Но вам нужно настроить конфигурацию переключателя для конкретной среды.

Редактирование сред

Вы можете отредактировать среду, щёлкнув значок с тремя вертикальными точками в правом верхнем углу среды. В настоящее время вы можете только изменить имя среды.

Переключатель функций

Сервис FeatureProbe обеспечивает мощное управление переключателями функций. Вы можете управлять выпуском своих бизнес-сервисов или приложений, изменяя объёмную часть, контролируя включённые функции и отслеживая показатели с различными настройками переключателей, чтобы постепенно увеличивать новые конфигурации, пока они не будут включены для всех.

Настройки переключателей работают индивидуально для разных сред, и вы можете легко переключаться между разными средами, используя раскрывающееся меню в верхнем левом углу страницы проекта.

Панель переключателей

  1. На рисунке показан список переключателей среды My First Project online.
  2. В верхней части левого навигатора есть переключатель среды. Щёлкните раскрывающееся меню, чтобы выбрать среду.
  3. Есть три поля фильтра и поле поиска, которые помогают быстро находить переключатели.

Добавление переключателей

Вы можете добавлять новые переключатели для своего проекта на странице проекта.

Вот шаги по добавлению нового переключателя:

  1. Введите имя переключателя.
  2. Введите ключ переключателя. Он уникален в рамках проекта и не может быть изменён после создания.
  3. Введите описание переключателя.
  4. Создайте или выберите теги из списка.
  5. Выберите SDK.
  6. Выберите тип возврата. Сейчас существует четыре типа (Boolean, String, Number, JSON). Тип возврата нельзя редактировать позже.
  7. Заполните вариации.
    1. Для типа возврата Boolean есть два значения по умолчанию, и их значения равны true и false соответственно. Вы не можете изменить количество вариаций. Вы не можете изменить значения вариаций (разрешены только «true» и «false»), но вы можете изменить их.

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/didiopensource-FeatureProbe.git
git@api.gitlife.ru:oschina-mirror/didiopensource-FeatureProbe.git
oschina-mirror
didiopensource-FeatureProbe
didiopensource-FeatureProbe
main