{"canonical_url":"https://engineer.company/uk/glossary/quality-gate/","content_markdown":"# Ворота якості\n\n## Що це таке\n\nВорота якості — це набір умов, які зміна має виконати, перш ніж перейти на\nнаступний етап, з одним результатом наприкінці: пройшла або впала. Етапом може\nбути коміт, злиття в основну гілку, реліз чи розгортання. Умовою може бути все,\nщо машина здатна вирішити сама: чистий прогін лінтера, тести, що проходять,\nпоказник покриття, збірка, яка завершується.\n\nГоловне в назві — слово «ворота». Перевірка повідомляє, а ворота вирішують, і\nце рішення виконує те, що керує наступним кроком. Лінтер, який виводить у лог\nсорок попереджень, — це перевірка. Той самий лінтер, підключений так, що кнопка\nзлиття лишається неактивною, доки його вивід не стане чистим, — це вже частина\nворіт.\n\nSonarQube Cloud, де цей термін є назвою окремої функції, описує ворота якості\nяк набір умов, за якими код оцінюють під час аналізу. Кожна умова поєднує\nметрику, оператор порівняння і порогове значення помилки, тож «reliability\nissues greater than 0» — це умова, і якщо справджується хоч одна з умов,\nперевірка якості провалюється. Умова стосується або нового коду, або коду\nзагалом.\n\nПлатформи для хостингу коду вбудовують ту саму ідею у процес злиття:\n\n- **GitHub** має налаштування захисту гілки «Require status checks before\n  merging». Обов'язкова перевірка повинна мати статус success, skipped або\n  neutral, перш ніж зміни потраплять у захищену гілку.\n- **GitLab** має перевірку злиття «Pipelines must succeed». Коли її ввімкнено,\n  merge request неможливо злити, поки його пайплайн падає, а також тоді, коли\n  пайплайна немає зовсім.\n- **На власній машині розробника** pre-commit встановлює перевірки як Git-хуки,\n  що спрацьовують під час коміту або push, а виконавець завдань на кшталт Task\n  дає всьому наборові одне ім'я.\n\n## Чому це важливо\n\nСтандарт, записаний лише в документі, розмивається поступово, щоразу на один\nвиняток. Стандарт, що валить збірку, виконують усі, зокрема й той, хто його\nнаписав, навіть того дня, коли дуже хочеться його пропустити. Ворота роблять\nузгоджені правила виконуваними, тож їх дотримання більше не залежить від пам'яті\nй настрою.\n\nВони також змінюють те, навіщо потрібне рев'ю коду людьми. Коли машина вже\nспіймала форматування, невикористані імпорти, биті посилання й секрети, що\nпотрапили в код, рецензент може зосередитися на задумі й дизайні, а їх машина\nоцінити не здатна.\n\nІдея нового коду дає змогу запровадити ворота на старій кодовій базі. Sonar\nway, стандартні ворота в SonarQube Cloud, зосереджуються на новому коді, а не\nна виправленні старого, з умовами на кшталт покриття тестами щонайменше 80,0% і\nдублювання не більше 3,0% у новому коді. Для pull request використовуються лише\nумови щодо нового коду. Тож проєкт із тисячами наявних зауважень може ввімкнути\nперевірку одразу, не розплачуючись спершу за накопичене.\n\nШвидкість вирішує, чи лишать люди ворота ввімкненими. Task запускає залежності\nзавдання паралельно, тож незалежні перевірки працюють одночасно, а не по черзі.\nДопомагає й поділ за вартістю: дешева половина — на кожен коміт, повний набір —\nперед тим, як код залишить машину.\n\nУ цього сайту є власні ворота якості. Це `task check`, і запускається він на\nтій самій машині, де пишеться сайт, а не в хмарному сервісі збірки. Кожна\nдіагностика вважається помилкою, генератор сайту працює з `--panicOnWarning`,\nтож навіть повідомлення про застарілу функцію зупиняє збірку, а локальні\nвимкнення перевірок у коді на кшталт `# noqa` чи `stylelint-disable` заборонено, тому помилку\nусувають у її причині, а не приглушують. Хук pre-commit запускає перевірки\nокремих файлів під час кожного коміту, а хук pre-push — повний `task check`, що\nтриває хвилини, а не секунди. Зелений прогін із чистого дерева ставить на це\nдерево позначку, і скрипт розгортання відмовляється працювати з деревом без неї.\nОбійти це можна лише змінною середовища, яка виводить гучне попередження, тож\nтой, хто в надзвичайній ситуації пропускає перевірку, мусить сказати про це\nвголос.\n\n## Як це виглядає на практиці\n\n[Сторінка подяк](/uk/credits/) сайту перелічує інструменти всередині цих воріт:\nvnu для HTML, Stylelint, axe-core на одній сторінці від кожного шаблону,\nLighthouse, lychee для посилань, Prettier, markdownlint, ESLint, Ruff,\nbasedpyright, yamllint, ShellCheck, codespell і gitleaks, а Task запускає все це\nпо одній команді на кожне завдання. Сторінка показує й те, що лишається поза\nцими воротами: з перевірок у браузері, якими керує Puppeteer, це вихід за межі\nвікна й візуальна регресія, і їх людина запускає на вимогу.\n\nУ проєкті, який веде одна людина, рецензента немає взагалі, і саме з цієї\nситуації починається одна сторінка портфоліо. Стандарти мали стати\nвиконуваними, щоб порушення блокувало коміт, а не чекало, поки його хтось\nпомітить. На описаному в документації етапі впровадження в серпні 2026 року відповіддю став\n[набір перевірок із 22 лінтерів без рівня попереджень](/uk/portfolio/built-a-22-linter-commit-gate/),\nа також перевірки, специфічні для проєкту, щодо яких готові інструменти не\nмають думки: наприклад, що розгорнуте дерево не містить приватних шляхів чи\nприватних імен хостів і що текст дотримувався правил тону всіма трьома мовами.\nЗбій, який існував і раніше, виправляють у тому самому проході. Ціну сторінка\nназиває прямо: комітити повільно, а ці перевірки — єдиний рецензент у проєкті.\n\nПеревірки можуть розходитися й між собою. Інша сторінка описує проєкт із хуком\nкоміту й повним гейтом якості, документом, де стверджувалося, що хук запускає\nгейт, і двома переліками перевірок, які вели вручну у двох файлах.\n[Тест, що визначає, які перевірки обидва переліки насправді викликають](/uk/portfolio/found-the-hooks-and-the-gate-disagreeing/),\nпоказав п'ять перевірок, що існували лише в гейті, і це були саме ті, що читають\nтекст. Кожна перевірка, що захищала код, запускалася автоматично; кожна, що\nзахищала текст, — лише тоді, коли хтось про неї згадував. П'ять перевірок\nперенесли в хук, дві з них пришвидшили, щоб вони вкладалися в його ліміт часу, а\nтест порівняння залишили, щоб виявляти розбіжності між переліками.\n\n## Де виникають проблеми\n\nБільшість воріт якості дають збій так, що пропускають зайве й далі світяться\nзеленим.\n\n**Попередження накопичуються за зеленим результатом.** Ворота, що падають лише\nна помилках, дають попередженням накопичуватися, доки лог не стане задовгим для\nчитання, і тоді справжня проблема приходить як попередження номер двісті один.\nПриберіть рівень попереджень: правило або варте того, щоб на ньому падати, або\nвимкнене.\n\n**Пропущена перевірка зараховується як пройдена.** На GitHub статус `skipped`\nзадовольняє обов'язкову перевірку, а завдання, пропущене через власну умову `if:`,\nповідомляє статус `success`. Завдання, що залежить від невдалого завдання, також\nпропускається й може не заблокувати злиття. GitHub радить використовувати\n`always()` разом із `needs`: зробіть обов'язковим одне завдання, яке запускається\nзавжди й проходить лише тоді, коли всі його залежності завершилися успішно.\n\n```yaml\n# .github/workflows/check.yml (уривок)\njobs:\n    gate:\n        if: always()\n        needs: [lint, test, build]\n        runs-on: ubuntu-latest\n        steps:\n            - run: |\n                  for result in ${{ join(needs.*.result, ' ') }}; do\n                      test \"$result\" = success || exit 1\n                  done\n```\n\nБуває й протилежна пастка: обов'язковий робочий процес, пропущений через фільтр\nшляхів або гілок, лишає свої перевірки в стані `pending` і блокує кожне злиття.\nНе робіть обов'язковими робочі процеси, які можна пропустити.\n\n**Два переліки розходяться.** Хук запускає один набір, сервер — інший, а документ\nзапевняє, що вони однакові. Дайте перевіркам одне визначення і викликайте його з\nусіх місць або тримайте тест, який порівнює переліки й падає, коли вони\nрізняться.\n\n**Ворота стають повільними, і їх починають обходити.** Прапорець, що пропускає\nхуки, завжди під рукою, а на GitHub захист гілки за замовчуванням не поширюється\nна адміністраторів репозиторію; це змінює налаштування «Do not allow bypassing\nthe above settings». Виміряйте, куди йде час, тримайте частину для коміту\nневеликою, а справді повільну перевірку винесіть у задокументований ручний крок.\n\n**Перевірка проходить, хоча нічого не перевірила.** Лінтер, націлений на glob,\nпід який не потрапляє жоден файл, або шаблон ignore, що поглинає цілу теку,\nзавершується чисто, а чисте завершення виглядає так само, як чистий код.\nПеревіряйте самі ворота: дайте кожній перевірці файл, про який відомо, що він\nхибний, і чекайте, що вона впаде.\n\n## Що почитати далі\n\n- [Introduction to quality gates](https://docs.sonarsource.com/sonarqube-cloud/standards/managing-quality-gates/introduction-to-quality-gates)\n  — умови, стандартні ворота Sonar way і зосередженість на новому коді.\n- [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)\n  — обов'язкові перевірки статусу і те, хто може їх обійти.\n- [Troubleshooting required status checks](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/collaborating-on-repositories-with-code-quality-features/troubleshooting-required-status-checks)\n  — які статуси вважаються успішними і як поводяться пропущені робочі процеси та\n  завдання.\n- [Auto-merge](https://docs.gitlab.com/user/project/merge_requests/auto_merge/)\n  — перевірка GitLab «Pipelines must succeed» і те, як вона трактує пропущені\n  пайплайни.\n- [pre-commit](https://pre-commit.com/) — перевірки, оголошені один раз і\n  встановлені як Git-хуки для етапів коміту й push.\n- [Task dependencies](https://taskfile.dev/docs/guide/dependencies) — як Task\n  запускає залежності завдання паралельно, а команди — по черзі.\n\n\u003chttps://engineer.company/uk/glossary/quality-gate/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як ворота якості перетворюють записані стандарти на рішення «пройшло» чи «впало» перед комітом, злиттям або розгортанням і де вони дають збій.","formats":{"gemtext":"https://engineer.company/uk/glossary/quality-gate/index.gmi","gopher":"https://engineer.company/uk/glossary/quality-gate/gophermap","html":"https://engineer.company/uk/glossary/quality-gate/","json":"https://engineer.company/uk/glossary/quality-gate/index.json","markdown":"https://engineer.company/uk/glossary/quality-gate/index.md","pdf":"https://engineer.company/uk/glossary/quality-gate/index.pdf"},"kind":"page","language":"uk","title":"Що таке ворота якості?","url":"https://engineer.company/uk/glossary/quality-gate/","version":1}