OpenFlags

Что такое OpenFlags?

OpenFlags — это open source self-hosted система feature flags, предназначенная для помощи командам в доставке изменений с progressive delivery и более безопасными релизами. Она предоставляет контрольную плоскость и SDK, чтобы код приложения мог оценивать флаги локально и включать поведение фич без повторного деплоя для каждого изменения.

Основная цель OpenFlags — поддержка рабочих процессов релизов, таких как процентные роллауты, целевая активация и контролируемое включение, при этом оценка флагов остается низкозадержанной, а владение runtime остается внутри инфраструктуры команды.

Ключевые возможности

• Self-hosted инфраструктура флагов: Храните хранение флагов, логику таргетинга и владение runtime внутри своей инфраструктуры, а не полагаясь на hosted-платформу.
• Локальная оценка через typed SDK: Оценивайте флаги в приложении с помощью TypeScript-пакетов, обеспечивая быстрые и предсказуемые проверки за счет локального выполнения в вашем коде.
• Контроли progressive delivery: Роллаутите фичи на контролируемые сегменты (включая процентные роллауты), а не включая изменения для всех сразу.
• Детальный таргетинг: Активируйте флаги на основе конкретного таргетинга пользователей, чтобы разные когорты получали разное поведение фич.
• REST контрольная плоскость с фокусированной поверхностью: Используйте простой REST API для контрольной плоскости и управления флагами, разработанный как часть монопо с dedicated ролями для сервера, дашборда, SDK и документации.
• Дашборд для переключения и управления роллаутами: React-based админ UI помогает командам переключать релизы и управлять конфигурацией роллаутов.

Как использовать OpenFlags

1. Начните с документации и quickstart: Используйте предоставленные docs для настройки сервера, дашборда и SDK в вашей среде.
2. Создайте SDK-клиент в приложении: Инициализируйте клиент с вашим API URL, идентификатором проекта и идентификатором пользователя.
3. Оценивайте флаги локально в коде приложения: Используйте SDK для проверки, включен ли флаг (например, вызывая flags.isEnabled("flag_name")), и условно рендерите поведение.
4. Управляйте конфигурацией роллаутов из контрольной плоскости: Используйте дашборд и/или REST API для определения поведения роллаутов, такого как процентное включение или целевая активация.

Сценарии использования

• Постепенно включать новый user experience: Закройте UI или workflow за feature flag и включите его для контролируемой подгруппы пользователей, а не всего трафика сразу.
• Провести бета-тест с целевыми пользователями: Активируйте фичу для конкретных когорт по идентификаторам пользователей, чтобы сравнивать поведение между группами, не затрагивая остальных.
• Сократить blast radius релиза с процентными роллаутами: Роллаутите изменения постепенно (например, для 35% пользователей) и корректируйте поведение роллаута без перестройки или редеплоя приложения.
• Держать проверки флагов быстрыми в performance-sensitive приложениях: Используйте локальную оценку в приложении, чтобы проверки фич оставались низкозадержанными и стабильными во время runtime.
• Сохранять владение внутри своей инфраструктуры: Используйте self-hosted контрольную плоскость, чтобы операционная и аудиторская поверхность оставались в вашем стеке.

FAQ

• OpenFlags self-hosted или cloud-hosted? OpenFlags Cloud описан как «coming soon», а текущее предложение позиционируется как open source и self-hosted.

• Как работает оценка фич? OpenFlags поддерживает локальную оценку через свои SDK, так что проверки флагов происходят внутри кода вашего приложения, без удаленного вызова для каждой оценки.

• Какие паттерны роллаутов поддерживаются? Сайт упоминает progressive delivery с процентными роллаутами, детальным таргетингом и контролируемым включением.

• Какие компоненты включает OpenFlags? Монопо включает сервер (Bun-powered API для контрольной плоскости), React-based дашборд, TypeScript SDK-пакеты и документацию.

• Для каких языков/фреймворков предназначены SDK? Сайт подчеркивает JavaScript-first использование SDK и упоминает поддержку Bun, React, Next.js, Vite и Node-приложений.

Альтернативы

• Управляемые платформы feature flags (SaaS): Они обычно централизуют управление флагами в хостинговой службе. В сравнении с self-hosted контрольной плоскостью OpenFlags оценка и операционная ответственность могут быть более зависимы от платформы вендора.
• Релизы на основе инфраструктуры как кода (без выделенной оценки флагов): Команды могут имитировать progressive delivery с помощью деплоев, роутинга или переключателей конфигурации. Это отличается от OpenFlags отсутствием специализированного workflow SDK feature flags для локальной оценки.
• Open source сервисы feature flags с другой архитектурой: Альтернативные open source системы могут предлагать похожие концепции (flags, targeting, dashboards), но с другими компромиссами в подходе SDK, дизайне API контрольной плоскости или обработке локальной оценки.