{"canonical_url":"https://engineer.company/uk/glossary/canary-release/","content_markdown":"# Канарковий реліз\n\n## Що це таке\n\nКанарковий реліз — це спосіб випускати нову версію сервісу так, щоб спершу вона\nобслуговувала лише невелику частку справжнього трафіку, а версія, яку вона\nзамінює, тим часом обслуговувала всіх інших. Якщо нова версія працює як слід,\nчастку крок за кроком збільшують, доки вона не обслуговуватиме весь трафік, а\nстару версію можна буде вивести з роботи. Якщо ні, трафік повертається на стару\nверсію, яка весь цей час працювала, і збій зачепив лише ту невелику частку.\nДаніло Сато описав цей прийом у блозі-вікі Мартіна Фаулера в червні 2014 року й\nзазначив, що його ще називають поетапним (phased) або інкрементним (incremental)\nрозгортанням. У світі Kubernetes частіше кажуть canary deployment, а українською\n— канаркове розгортання. Argo Rollouts, контролер Kubernetes, що додає такі\nстратегії розгортання, називає відповідне налаштування `canary`.\n\nНазва походить із вугільних шахт. Шахтарі брали з собою під землю канарку в\nклітці, бо від витоку газу птах слабшав раніше, ніж його вплив відчували люди, і це було\nдля них сигналом вчасно вибиратися нагору. Невелика частка трафіку відіграє ту саму\nроль: вона першою натрапляє на проблему, поки ще є час діяти.\n\nСклад цієї частки — питання вибору. Сато називає випадкову вибірку користувачів,\nспершу власних працівників компанії, а вже потім усіх інших, і користувачів,\nвідібраних за профілем чи демографічними ознаками. Великі системи часто ділять\nтрафік за вже наявними межами: спершу один регіон, одне місце або один бренд. За\nсловами Сато, Facebook запускав кілька канаркових груп, і першу з них бачили\nлише працівники компанії, причому з усіма ввімкненими прапорцями функцій, щоб\nпроблеми з новими можливостями виявлялися якомога раніше.\n\nВід синьо-зеленого розгортання канарковий реліз відрізняється тим, як рухається\nтрафік. Синьо-зелене розгортання будує повну другу копію й переносить увесь\nтрафік одним перемиканням, тримаючи стару копію як шлях назад. Канарковий реліз\nпереносить трафік поступово, тож певний час дві версії обслуговують справжніх\nкористувачів поруч. Поступове оновлення (rolling update) теж якийсь час тримає в\nроботі дві версії, але замінює екземпляри так швидко, як вони стають готовими,\nбез пауз, щоб оцінити, як справляється нова версія. Канарковий реліз\nзупиняється на кожному кроці й чекає відповіді.\n\n## Чому це важливо\n\nДеякі збої проявляються лише в продакшні: під справжнім навантаженням, на\nсправжніх даних і з тим набором клієнтів, який є насправді. Середовище staging\nможе бути дуже схожим, але ніколи не буде таким самим. Канарковий реліз це\nвизнає й натомість обмежує шкоду. Якщо до нової версії потрапляє кожен двадцятий\nзапит, поганий реліз шкодить кожному двадцятому запиту доти, доки його не\nпомітять, а щоб це виправити, досить повернути цю частку назад.\n\nСато вказує ще на одну користь: перевірку потужності. Повільно збільшуючи\nчастку, можна побачити, як нова версія поводиться під зростаючим\nпродакшн-навантаженням, маючи безпечний шлях назад, замість будувати окреме\nсередовище лише для навантажувальних тестів, яке ніколи не буде настільки\nсхожим на продакшн, як сам продакшн.\n\nЗаковика в тому, що канарковий реліз вартий рівно стільки, скільки сигнал, за\nяким його оцінюють. Помилки, затримки й бізнесові показники, що справді мають\nзначення, як-от реєстрації, платежі чи замовлення, мають бути видимі окремо для\nкожної версії й досить рано, щоб зупинити наступний крок. Без цього канарковий\nреліз — це просто повільне розгортання з додатковим очікуванням. Сато зазначає,\nщо IMVU першою застосувала так звану «cluster immune system», тобто імунну\nсистему кластера: стежити за бізнесовими показниками й автоматично відкочувати\nреліз у разі статистично значущої регресії.\n\nЄ й постійні витрати. Дві або більше версій працюють одночасно, і все спільне\nдля них (база даних, кеш, черга, API, який викликають клієнти) має працювати з\nобома, поки триває розгортання. Сато радить тримати кількість одночасних версій\nмінімальною. Цей прийом також погано підходить для програм, установлених на\nвласних комп'ютерах чи телефонах користувачів, де постачальник не вирішує, коли\nвідбудеться оновлення. Для таких випадків він радить зберігати на бекенді\nпідтримку обох версій, стежити, які версії клієнтів досі в ужитку, і прибирати\nстару лише тоді, коли її частка стане достатньо малою.\n\n## Як це виглядає на практиці\n\nУ найпростішому вигляді канарковий реліз у Kubernetes — це два Service, один з\nяких обирає стабільні поди, а другий — канаркові, і маршрут, що розподіляє\nтрафік між ними за вагами. У Gateway API ваги задають у HTTPRoute:\n\n```yaml\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n  name: web\nspec:\n  parentRefs:\n    - name: prod-web\n  hostnames:\n    - \"www.example.com\"\n  rules:\n    - backendRefs:\n        - name: web-stable\n          port: 8080\n          weight: 95\n        - name: web-canary\n          port: 8080\n          weight: 5\n```\n\nВаги — це пропорції, а не відсотки: кожен бекенд отримує свою вагу, поділену на\nсуму ваг у правилі, тож 95 і 5 спрямовують на канаркову версію кожен двадцятий\nзапит. Не вказана вага дорівнює 1, а вага 0 не спрямовує нічого. Посібник\nGateway API з розподілу трафіку також показує правило, яке зіставляє заголовок\nзапиту (у прикладі це `traffic: test`) і спрямовує на нову версію лише такі\nзапити, тож тестувальники можуть дістатися до неї раніше за будь-якого клієнта.\nЩоб просунути канаркову версію далі, досить змінити два числа, а для\nвідкликання — виставити їй вагу 0.\n\nArgo Rollouts автоматизує ці кроки. `Rollout` займає місце `Deployment` з тим\nсамим шаблоном подів і перелічує кроки, які контролер проходить щоразу, коли\nшаблон змінюється:\n\n```yaml\napiVersion: argoproj.io/v1alpha1\nkind: Rollout\nmetadata:\n  name: web\nspec:\n  replicas: 10\n  selector:\n    matchLabels:\n      app: web\n  template:\n    metadata:\n      labels:\n        app: web\n    spec:\n      containers:\n        - name: web\n          image: registry.example.com/web:1.4.2\n  strategy:\n    canary:\n      maxSurge: \"25%\"\n      maxUnavailable: 0\n      steps:\n        - setWeight: 10\n        - pause:\n            duration: 1h\n        - setWeight: 20\n        - pause: {}\n```\n\nБез маршрутизатора трафіку Argo наближено відтворює вагу кількістю подів: за\nваги 10 відсотків десять реплік дають один канарковий под і дев'ять стабільних.\nПерша пауза триває годину, друга — доки хтось не ухвалить рішення. Реліз і два\nйого можливі завершення виглядають так:\n\n```sh\nkubectl argo rollouts set image web web=registry.example.com/web:1.5.0\n# на паузі без терміну: або далі ...\nkubectl argo rollouts promote web\n# ... або зупинитися й знову віддати весь трафік стабільній версії\nkubectl argo rollouts abort web\n```\n\nУсе в цій послідовності залежить від того, чи видно під час паузи, що канаркова\nверсія працює гірше за ту, яку замінює. Саме на цьому побудовано послугу\n[Надійність та моніторинг (SRE)](/uk/services/site-reliability/), що зводиться\nдо сповіщень, які попереджають, поки збій ще малий. Власний\n[моніторинг помилок і трасування](/uk/portfolio/built-first-party-error-monitoring-and-tracing/)\n2025 року показує, як виглядає такий сигнал: помилки групуються в повторювані\nпроблеми замість плаского списку, а сплески й регресії виявляються з паузою між\nсповіщеннями, щоб через одне невдале розгортання чергового не піднімали сорок\nразів. Саме цього потребує крок канаркового релізу: регресії, що сама дає про\nсебе знати в межах паузи, а не тієї, на яку користувач наткнеться наступного\nранку.\n\n## Де виникають проблеми\n\n**Канаркова версія замала, щоб щось показати.** Один под із десяти в тихі години\nможе за свою паузу обслужити лише кілька сотень запитів, і збій, що зачіпає один\nзапит із тисячі, так і не проявиться. Годинник — неправильна мірка; правильна —\nкількість запитів, які канаркова версія обслужила. Добирайте частку й паузу\nразом, щоб рідкісна помилка мала шанс проявитися кілька разів, і тримайте крок\nуночі довше, ніж опівдні.\n\n**Дашборди не відрізняють канаркову версію від стабільної.** Канаркова версія,\nчий рівень помилок на два відсоткові пункти вищий, ніж у стабільної, за частки\nу 5 відсотків додає до загального рівня помилок лише приблизно одну помилку на\nтисячу запитів. На дашборді з одним рівнем помилок для всього сервісу цього не\nвидно. Дайте канарковим і стабільним подам різні мітки, які Argo Rollouts додає\nчерез `canaryMetadata` і `stableMetadata`, перенесіть мітку в показники й\nпорівнюйте канаркову версію зі стабільною, а не з фіксованим порогом. Фоновий\n`analysis` на об'єкті Rollout перериває оновлення, якщо аналіз провалюється.\n\n**Обидві версії пишуть у ті самі дані.** Поки триває розгортання, старий і новий\nкод читають і пишуть одну базу даних, а за випадкового розподілу запити одного\nкористувача можуть протягом хвилини потрапити на обидві. Новий стовпець, який\nстара версія ніколи не заповнює, або формат, якого вона не вміє прочитати,\nперетворюються на помилки на стабільному боці, тобто там, де мало бути безпечно.\nВідповідь Сато — parallel change, паралельна зміна: база даних підтримує обидві\nверсії застосунку протягом усього розгортання, а стару структуру прибирають лише\nтоді, коли старої версії вже немає.\n\n**Переривання зупиняє трафік, а не зміну.** `kubectl argo rollouts abort`\nповертає трафік на стабільний ReplicaSet, але специфікація об'єкта `Rollout`\nдосі вказує на новий образ, і якщо об'єкт вийде з перерваного стану, він знову\nрушить до цієї версії. Відкат завершено лише тоді, коли шаблон повернуто до\nпопередньої версії. Якщо специфікація зберігається в репозиторії, виправляйте\nїї там, щоб джерело й кластер погоджувалися, що саме має працювати.\n\n**Канаркову версію заодно використовують як A/B-тест.** Маршрутизація однакова,\nтож кортить виміряти вплив нової функції на конверсію за допомогою канаркового\nтрафіку. Сато радить тримати ці речі окремо: канарковий реліз шукає проблеми й\nмає завершуватися за хвилини чи години, а експеримент перевіряє гіпотезу й може\nпотребувати даних за кілька днів, щоб результат став статистично значущим. Якщо\nканаркову версію оцінюють за бізнесовими показниками, ефект, який мав би\nвикликати експеримент, ще й затьмарює вердикт. Випускайте версію через\nканарковий реліз, а експеримент запускайте вже після її виходу, з окремим\nрозподілом трафіку, наприклад через прапорець функції.\n\n## Що почитати далі\n\n- [Canary Release](https://martinfowler.com/bliki/CanaryRelease.html)\n  — опис, який Даніло Сато 2014 року опублікував у блозі-вікі Мартіна Фаулера:\n  вибір користувачів, перевірка потужності, A/B-тести й база даних.\n- [Argo Rollouts: Canary](https://argo-rollouts.readthedocs.io/en/stable/features/canary/)\n  — кроки й паузи, ваги, наближені кількістю подів, і масштабування з\n  маршрутизатором трафіку.\n- [HTTP traffic splitting](https://gateway-api.sigs.k8s.io/guides/user-guides/traffic-splitting/)\n  — посібник Gateway API про бекенди з вагами й канарковий маршрут, що\n  спрацьовує за заголовком.\n- [kubectl argo rollouts abort](https://argo-rollouts.readthedocs.io/en/stable/generated/kubectl-argo-rollouts/kubectl-argo-rollouts_abort/)\n  — що переривання робить із трафіком і що лишає в специфікації.\n\n\u003chttps://engineer.company/uk/glossary/canary-release/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Нова версія спершу отримує малу частку справжнього трафіку: як цю частку спрямовують, що її оцінює і коли мала частка нічого не доводить.","formats":{"gemtext":"https://engineer.company/uk/glossary/canary-release/index.gmi","gopher":"https://engineer.company/uk/glossary/canary-release/gophermap","html":"https://engineer.company/uk/glossary/canary-release/","json":"https://engineer.company/uk/glossary/canary-release/index.json","markdown":"https://engineer.company/uk/glossary/canary-release/index.md","pdf":"https://engineer.company/uk/glossary/canary-release/index.pdf"},"kind":"page","language":"uk","title":"Що таке канарковий реліз?","url":"https://engineer.company/uk/glossary/canary-release/","version":1}