Feature flags для веб-приложений
Без feature flags деплой больших фич превращается в страшилку с откатами. Что брать в малом и среднем проекте.
Без feature flags выкатка большой функции превращается в лотерею: всё или ничего, а если что-то пошло не так — срочный откат и разбор полётов. Флаг позволяет разделить два события, которые обычно происходят одновременно: доставку кода на сервер и включение функции для пользователей. Разберём, зачем это малому и среднему проекту, что выбрать и как не утонуть в переключателях.
Что такое 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. Без процентов и атрибутов вроде тарифа или региона постепенная выкатка невозможна.
- Нет поведения по умолчанию. Если сервис флагов недоступен, приложение должно работать с безопасным значением, а не падать.
- Флаги вместо прав доступа. Разграничение по тарифам и ролям — это бизнес-логика. Смешивать её с временными флагами выкатки — путь к путанице.
Чек-лист внедрения
- Договоритесь об именовании флагов и о том, кто может их переключать.
- Выберите инструмент под масштаб: свой код, open-source или SaaS.
- Сделайте журнал изменений: кто и когда переключил флаг.
- Свяжите флаги с аналитикой, чтобы видеть эффект.
- Раз в месяц проводите чистку устаревших флагов.
Если флаги нужны в первую очередь для экспериментов, начните со статьи что тестировать первым и посмотрите нашу услугу A/B-тестирование. Внедрить флаги в существующий продукт можно и в рамках поддержки веб-приложения.
Вывод: feature flags снимают страх перед релизами, если относиться к ним как к временным инструментам с владельцем и сроком жизни.
Хотите выкатывать функции без нервов и ночных откатов, — напишите в Telegram или MAX.