Feature flags для веб-приложений

Без feature flags деплой больших фич превращается в страшилку с откатами. Что брать в малом и среднем проекте.

Feature flags для веб-приложений

Без feature flags выкатка большой функции превращается в лотерею: всё или ничего, а если что-то пошло не так — срочный откат и разбор полётов. Флаг позволяет разделить два события, которые обычно происходят одновременно: доставку кода на сервер и включение функции для пользователей. Разберём, зачем это малому и среднему проекту, что выбрать и как не утонуть в переключателях.

Feature flags для веб-приложений
Основные варианты feature flags: SaaS, open-source и свой код.

Что такое feature flag и зачем он нужен

Feature flag — условие в коде, которое включает или выключает функцию без нового релиза. Значение флага хранится вне кода: в базе, в конфигурации или во внешнем сервисе. Базовые сценарии:

  • Постепенная выкатка. Сначала функцию видят сотрудники, потом небольшая доля пользователей, потом все. Если метрики проседают, флаг выключается за секунды.
  • A/B-тесты. Разным группам показываются разные варианты, а результат сравнивается по метрикам.
  • Аварийный выключатель. Тяжёлый отчёт, внешняя интеграция, новая рекомендательная система — если начинает тормозить или падать, её можно отключить без деплоя.
  • Бета-доступ. Функция открыта для конкретных клиентов или тарифа.
  • Работа в основной ветке. Незаконченная функция уже в коде, но выключена. Нет долгоживущих веток и болезненных слияний.

Варианты инструментов

  • LaunchDarkly — один из самых зрелых коммерческих сервисов: таргетинг, эксперименты, аудит изменений. Платный, и для российских компаний оплата зарубежных SaaS может быть проблемой.
  • GrowthBook — open-source, можно развернуть на своём сервере. Сильная сторона — эксперименты и статистика по ним.
  • Unleash — open-source, давно на рынке, есть SDK для большинства языков. Интерфейс проще, но для флагов и постепенной выкатки хватает.
  • PostHog — флаги в комплекте с продуктовой аналитикой. Удобно, если вы уже им пользуетесь. Есть self-hosted вариант.
  • Свой код — таблица в базе и раздел в админке. Делается быстро, но таргетинг, проценты, аудит и эксперименты придётся дописывать самим.

Для небольшого проекта разумный путь — начать со своего простого решения или self-hosted open-source и переходить на что-то сложнее, когда флагов и экспериментов станет много. Если данные пользователей нельзя отправлять за рубеж, self-hosted вариант часто единственно возможный.

Как устроить простой флаг правильно

Ключевое — детерминированное распределение по процентам. Один и тот же пользователь должен всегда попадать в одну группу, иначе интерфейс будет «мигать» между версиями.

function isEnabled(string $flag, int $userId, int $percent): bool {
    $bucket = crc32($flag . ':' . $userId) % 100;
    return $bucket < $percent;
}

Хеш от имени флага и идентификатора пользователя даёт стабильное число от 0 до 99. Включили флаг на 10% — функцию видят те, у кого число меньше 10. Подняли до 50% — к ним добавились новые пользователи, а старые остались в группе.

Главные ошибки

  • Флаги не удаляются. Через год в коде десятки переключателей, и никто не помнит, что они делают и можно ли их убрать. Заводите у каждого флага владельца и срок жизни, а после полной выкатки удаляйте условие из кода.
  • Чтение флагов без кеша. Запрос в базу или внешний сервис на каждое обращение тормозит приложение. Кешируйте значения в памяти на короткое время или используйте SDK с локальным вычислением.
  • Нет сегментов. Флаг можно включить только «всем» или списку ID. Без процентов и атрибутов вроде тарифа или региона постепенная выкатка невозможна.
  • Нет поведения по умолчанию. Если сервис флагов недоступен, приложение должно работать с безопасным значением, а не падать.
  • Флаги вместо прав доступа. Разграничение по тарифам и ролям — это бизнес-логика. Смешивать её с временными флагами выкатки — путь к путанице.

Чек-лист внедрения

  1. Договоритесь об именовании флагов и о том, кто может их переключать.
  2. Выберите инструмент под масштаб: свой код, open-source или SaaS.
  3. Сделайте журнал изменений: кто и когда переключил флаг.
  4. Свяжите флаги с аналитикой, чтобы видеть эффект.
  5. Раз в месяц проводите чистку устаревших флагов.

Если флаги нужны в первую очередь для экспериментов, начните со статьи что тестировать первым и посмотрите нашу услугу A/B-тестирование. Внедрить флаги в существующий продукт можно и в рамках поддержки веб-приложения.

Вывод: feature flags снимают страх перед релизами, если относиться к ним как к временным инструментам с владельцем и сроком жизни.

Хотите выкатывать функции без нервов и ночных откатов, — напишите в Telegram или MAX.

Услуги веб-разработки
Разработка, ИИ, автоматизация — что мы делаем и как.

Есть задача по теме? Напишите — вернёмся с оценкой и сроками.

Написать в Telegram → Написать в MAX