{"canonical_url":"https://engineer.company/uk/glossary/feature-flag/","content_markdown":"# Прапорець функції\n\n## Що це таке\n\nПрапорець функції — це точка в коді, де рішення ухвалюється на основі\nналаштування, яке команда може змінити, не збираючи застосунок заново. За\nпрапорцем стоїть новий шлях виконання, який уже працює в продакшні, але\nлишається неактивним, доки налаштування не ввімкне його для всіх або для обраної\nгрупи користувачів. Піт Ходжсон докладно описав цей прийом на сайті Мартіна\nФаулера: статтю публікували частинами з січня 2016 року, а в жовтні 2017 року\nавтор її доопрацював. Він називає такі прапорці feature toggles, а серед інших\nназв того самого згадує feature flags, feature bits і feature flippers.\n\nХоджсон розкладає прапорець на частини. Toggle point — це місце в коді, яке\nпитає, чи ввімкнено новий шлях. Toggle router відповідає на це питання,\nспираючись на конфігурацію прапорців, а коли відповідь залежить від того, хто\nпитає, — ще й на toggle context: зазвичай це поточний користувач або спеціальний\nфайл cookie чи HTTP-заголовок, що його заступає. Ходжсон застерігає від того,\nщоб зв'язувати ці дві частини надто тісно. Код у toggle point має ставити вузьке\nпитання, наприклад, чи містить це підтвердження замовлення нове посилання для\nскасування, а правило, яке це вирішує, живе в одному місці за toggle router, тож\nйого можна змінити, не чіпаючи кожне місце виклику.\n\nПрапорці різняться тим, скільки вони живуть і як часто змінюється їхня\nвідповідь, і Ходжсон ділить їх на чотири види. Release toggles дають змогу\nвідправити в продакшн незавершений і неперевірений код як латентний, тобто\nтакий, що поки не виконується; за словами Ходжсона, зазвичай вони не повинні\nзатримуватися в коді набагато довше, ніж тиждень-два. Experiment toggles ділять\nкористувачів на групи для A/B-тесту, причому кожен користувач щоразу потрапляє в\nту саму групу. Ops toggles дають змогу тим, хто експлуатує систему, змінювати її\nповедінку в продакшні. Багато з них живуть недовго, але кілька довгожителів,\nаварійні вимикачі (kill switches), дозволяють згорнути функціональність, без\nякої система може обійтися, коли навантаження незвично високе, наприклад панель\nрекомендацій, яку дорого генерувати; Ходжсон порівнює їх із запобіжником\n(circuit breaker), яким керують уручну. Permissioning toggles визначають, які\nфункції бачить конкретний користувач, наприклад преміальні функції для тих, хто\nплатить, або альфа-функції для власних працівників компанії, і можуть існувати\nроками.\n\nПрапорець функції — це не канарковий реліз, хоча вони часто працюють у парі.\nКанарковий реліз тримає дві версії сервісу поруч і спрямовує частку трафіку на\nнову; прапорець постачає одну версію, що містить обидва шляхи, і обирає між ними\nпід час кожного запиту. Довгоживуча гілка в системі контролю версій теж тримає\nнову роботу окремо, але тоді код потрапляє в продакшн лише після злиття гілки, і\nто весь одразу.\n\n## Чому це важливо\n\nГоловна причина використовувати прапорці — відокремити розгортання від релізу.\nХоджсон описує release toggles як найпоширеніший спосіб утілити на практиці один\nіз принципів Continuous Delivery: реліз функції — це окремий крок, не те саме,\nщо розгортання її коду. Код може щодня потрапляти в продакшн з однієї спільної\nосновної гілки, а функція, над якою працюють місяць, лишається вимкненою, доки\nне буде готова, і саме це робить розробку в основній гілці (trunk-based\ndevelopment) здійсненною.\n\nОскільки прапорець може давати різним користувачам різні відповіді, реліз можна\nрозширювати поетапно. Ходжсон описує, як нові функції спершу вмикають для\nвнутрішніх користувачів; він називає це Champagne Brunch, бо компанія першою п'є\nвласне шампанське. Далі йде канаркова група: у його прикладі це випадковий 1\nвідсоток користувачів, відібраний за остачею від ділення ідентифікатора\nкористувача, щоб у групі лишалися ті самі люди, тоді як решта 99 відсотків\nзберігає стару поведінку. Якщо ця група натрапляє на проблеми, прапорець\nвимикають, і нікому не доводиться відкочувати розгортання.\n\nУсе це має свою ціну. Кожен прапорець додає в код ще одне розгалуження й ще одну\nкомбінацію, яку треба перевірити, а конфігурація за ним стає частиною продакшну,\nяку можна змінити без нової збірки. Ходжсон радить тримати конфігурацію\nпрапорців у системі контролю версій і змінювати її через повторні розгортання\nвсюди, де прапорець це дозволяє, щоб конфігурація проходила той самий конвеєр,\nщо й код, а зміни в ній переглядали й фіксували. Конфігурація, яку змінюють\nпросто під час роботи системи, виправдовує себе там, де прапорець мусить\nперемикатися за лічені хвилини, як-от в ops toggles.\n\n## Як це виглядає на практиці\n\nflagd — це рушій обчислення прапорців із відкритим кодом, що відповідає\nспецифікації OpenFeature. Він не має інтерфейсу користувача й нічого не зберігає\nсам: він читає визначення прапорців із JSON-файлу або іншого джерела й\nвідповідає на запити — як sidecar, усередині процесу застосунку або як\nцентральний сервіс. Прапорець, що спрямовує на нове оформлення замовлення\nприблизно кожного двадцятого користувача, виглядає так:\n\n```json\n{\n  \"$schema\": \"https://flagd.dev/schema/v0/flags.json\",\n  \"flags\": {\n    \"new-checkout\": {\n      \"state\": \"ENABLED\",\n      \"variants\": {\n        \"on\": true,\n        \"off\": false\n      },\n      \"defaultVariant\": \"off\",\n      \"targeting\": {\n        \"fractional\": [\n          [\"on\", 5],\n          [\"off\", 95]\n        ]\n      },\n      \"metadata\": {\n        \"owner\": \"checkout\",\n        \"expires\": \"2027-01-31\"\n      }\n    }\n  }\n}\n```\n\nКожен прапорець має стан і набір варіантів, які мають бути одного типу; варіант за замовчуванням необов'язковий. Правило `fractional` розподіляє користувачів по сегментах за\nвідносною вагою, тож 5 і 95 спрямовують на `on` приблизно кожного двадцятого. За\nзамовчуванням сегмент обчислюється з ключа прапорця та `targetingKey` у\nконтексті обчислення, а отже, той самий користувач завжди отримує ту саму\nвідповідь, а перейменування прапорця перемішує всіх. У `metadata` лежить усе, що\nкоманда хоче прив'язати до прапорця, тут — власник і дата, до якої прапорець має\nзникнути. Якщо задати `state` значення `DISABLED`, flagd узагалі не поверне\nзначення, і код, що до нього звертається, скористається власним значенням за\nзамовчуванням.\n\nЗапустіть flagd із цим файлом і попросіть відповідь через HTTP:\n\n```sh\nflagd start --uri file:./flags.json\ncurl -X POST \"localhost:8013/flagd.evaluation.v1.Service/ResolveBoolean\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"flagKey\":\"new-checkout\",\"context\":{\"targetingKey\":\"user-4711\"}}'\n```\n\nВідповідь містить значення, варіант і причину `TARGETING_MATCH`. У застосунку\nвиклик іде через клієнт OpenFeature з ключем прапорця, значенням за\nзамовчуванням `false` і контекстом обчислення, і toggle point не бачить нічого,\nкрім булевого значення. Щоб збільшити частку з 5 до 20 відсотків, досить змінити\nфайл прапорців, а не збірку застосунку.\n\n[Робочий простір найму та кар'єрний робочий простір моряків](/uk/portfolio/built-the-hiring-and-seafarer-career-workspaces/) 2025 року показують прапорець релізу в зафіксованому стані реалізації: в описі робочий простір найму названо запущеним, а кар'єрний робочий простір — керованим прапорцем функції та випущеним не повністю. Це історичний знімок стану, а не твердження про поточний стан розгортання. [Операторський бек-офіс](/uk/portfolio/built-the-operator-back-office-for-the-platform/) того самого року — це місце, де такі прапорці змінюють. Оператори перемикають прапорці й вмикають функцію лише для частини користувачів з екрана інтерфейсу замість того, щоб інженер вручну редагував виробничу базу даних, і кожну зміну авторизують і фіксують так само, як будь-яку іншу дію там.\n\n## Де виникають проблеми\n\n**Прапорці, які ніколи не зникають.** Прапорець релізу, що вже виконав свою\nроботу, — це чисті витрати: розгалуження, яке нікому не потрібне, шлях, який\nніхто не тестує, і налаштування, яке хтось може перемкнути помилково. Ходжсон\nпропонує ставитися до прапорців як до запасів, що мають ціну, і тримати ці\nзапаси малими. Серед його засобів — завдання на вилучення в беклозі з тієї миті,\nяк з'являється прапорець релізу, термін придатності, часова бомба, яка валить\nтест або не дає застосунку запуститися, коли прапорець пережив свою дату, і\nфіксована межа кількості прапорців, щоб новий можна було додати, лише вилучивши\nінший. Вилучити прапорець означає видалити не лише перевірку, а й той шлях коду,\nщо програв.\n\n**Старий прапорець із новим значенням.** 1 серпня 2012 року автоматизований\nмаршрутизатор ордерів Knight Capital, SMARS, за 45 хвилин відправив на ринок\nмільйони ордерів, і компанія втратила понад 460 мільйонів доларів. Постанова\nКомісії з цінних паперів і бірж США (SEC) описує, як це сталося. Новий код для\nпрограми Retail Liquidity Program Нью-Йоркської фондової біржі повторно\nвикористав прапорець, який передавався разом із вхідними ордерами й колись\nумикав Power Peg — функцію, якою Knight перестала користуватися у 2003 році, але\nтак і не видалила. Технік не скопіював новий код на один із восьми серверів, тож\nна цьому сервері повторно використаний прапорець розбудив стару функцію. Коли\nспівробітники потім прибрали новий код із решти семи, прапорець активував Power\nPeg і там. Ніколи не надавайте відслуженому прапорцю нового значення, видаляйте\nмертвий код разом із прапорцем, що його охороняв, і перевіряйте, що на всіх\nсерверах працює та сама збірка, перш ніж вмикати прапорець.\n\n**Комбінації, яких ніхто не перевіряв.** Два прапорці дають чотири комбінації, а\nдесять — понад тисячу; Ходжсон називає це комбінаторним вибухом. Перевірити всі\nрідко вдається, тож перевіряйте ті, що можуть потрапити в продакшн: поточну\nконфігурацію продакшну з увімкненими прапорцями, які ось-ось вийдуть у реліз,\nзапасну конфігурацію з тими самими прапорцями вимкненими і, як роблять також\nбагато команд, усе ввімкнене. Допомагає стала домовленість: вимкнено — це завжди\nнаявна поведінка, увімкнено — нова.\n\n**Значення за замовчуванням, якого ніхто не обирав.** Специфікація OpenFeature\nкаже, що обчислення прапорця не повинно кидати виняток. Коли щось іде не так,\nвиклик повертає значення за замовчуванням, яке передав той, хто викликає,\nдетальна форма результату містить код помилки, а клієнтові не слід ще й писати в\nжурнал, бо інакше застосунок, розгорнутий раніше, ніж визначено його прапорець,\nзасипав би журнал повідомленнями `FLAG_NOT_FOUND`. Так застосунок працює далі,\nале це також означає, що одна описка в ключі прапорця непомітно перетворюється\nна значення за замовчуванням для всіх користувачів. Передавайте як значення за\nзамовчуванням стару, безпечну поведінку й підключіть до обчислення обробник,\nякий рахує помилки й здіймає тривогу, щойно вони з'являються; саме в такому\nобробнику специфікація й пропонує вести журналювання.\n\n**Перевизначення, які може задати будь-хто.** Зручно дати тестувальникам змогу\nпримусово вмикати прапорець спеціальним файлом cookie, параметром в URL або\nHTTP-заголовком. Ходжсон зауважує, що допитливі чи зловмисні користувачі можуть\nзадати те саме перевизначення й змінити стан прапорця для себе. Приймайте\nперевизначення лише з внутрішнього трафіку або підписуйте їх криптографічно; це\nзменшує ризик, але, як зазначає Ходжсон, додає власної складності й поверхні\nатаки.\n\n## Що почитати далі\n\n- [Feature Toggles (aka Feature Flags)](https://martinfowler.com/articles/feature-toggles.html)\n  — стаття Піта Ходжсона на сайті Мартіна Фаулера: частини прапорця, чотири\n  категорії, тестування і як тримати запас прапорців малим.\n- [Flag Evaluation API](https://openfeature.dev/specification/sections/flag-evaluation/)\n  — специфікація OpenFeature щодо обчислення прапорця, зокрема значення за\n  замовчуванням, коди помилок і чому обчислення ніколи не кидає виняток.\n- [flagd: Flag Definitions](https://flagd.dev/reference/flag-definitions/) —\n  JSON-формат, який читає flagd: стан, варіанти, варіант за замовчуванням,\n  таргетинг і метадані.\n- [flagd: Fractional Operation](https://flagd.dev/reference/custom-operations/fractional-operation/)\n  — детерміновані відсоткові розподіли і що визначає, до якого сегмента\n  потрапить користувач.\n- [In the Matter of Knight Capital Americas LLC](https://www.sec.gov/files/litigation/admin/2013/34-70694.pdf)\n  — постанова SEC 2013 року про торгові збитки в серпні 2012 року, зокрема про\n  повторно використаний прапорець.\n\n\u003chttps://engineer.company/uk/glossary/feature-flag/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Перемикач у коді, що відокремлює розгортання від релізу: види прапорців, як обчислюється прапорець і який борг прапорці по собі лишають.","formats":{"gemtext":"https://engineer.company/uk/glossary/feature-flag/index.gmi","gopher":"https://engineer.company/uk/glossary/feature-flag/gophermap","html":"https://engineer.company/uk/glossary/feature-flag/","json":"https://engineer.company/uk/glossary/feature-flag/index.json","markdown":"https://engineer.company/uk/glossary/feature-flag/index.md","pdf":"https://engineer.company/uk/glossary/feature-flag/index.pdf"},"kind":"page","language":"uk","title":"Що таке прапорець функції?","url":"https://engineer.company/uk/glossary/feature-flag/","version":1}