{"canonical_url":"https://engineer.company/uk/glossary/ci/","content_markdown":"# CI\n\n## Що це таке\n\nCI — скорочення від continuous integration, українською «безперервна\nінтеграція»: спосіб роботи, за якого кожен у команді вливає свої зміни в одну\nспільну основну гілку багато разів на тиждень, а машина щоразу збирає й тестує\nрезультат, щоб помилка проявилася, поки її автор ще пам'ятає, навіщо вніс\nзміну.\n\nЦим словом називають дві різні речі, і якщо їх розрізняти, плутанини стає\nзначно менше. Перша — практика, і вона про людей. Стаття Мартіна Фаулера на цю\nтему, яку зрештою цитує більшість команд, описує її як набір звичок: одна\nосновна гілка, автоматизована збірка, збірка, що сама себе тестує, злиття в\nосновну гілку щонайменше раз на день, збірка на кожне надсилання змін,\nнегайне виправлення зламаної збірки, швидка збірка, приховування незавершеної\nроботи замість відкладання її в окрему гілку і стан збірки, який бачать усі.\nСтаття виводить назву з Extreme Programming і згадує, що Грейді Буч уживав цей\nвислів ще раніше.\n\nДруге значення — машина. Коли кажуть «CI червоний», мають на увазі сервіс, який\nзапустив збірку й повідомив про помилку. GitHub Actions, GitLab CI/CD та\nподібні до них мають однакову будову. Файл у репозиторії описує роботу:\n`.github/workflows/*.yml` на GitHub, `.gitlab-ci.yml` у корені на GitLab. Подія\nзапускає її: push, pull request чи merge request, розклад або натискання кнопки.\nRunner, тобто виділена для цього машина, отримує коміт, виконує команди з файлу\nі повертає до коміту результат: пройшло чи впало.\n\nСам лише сервер ще не є безперервною інтеграцією. Команда, яка місяць тримає\nроботу в гілках і дає серверу збирати кожну з них, автоматизувала збірки, і це\nкорисно, але інтеграція все одно відбувається разом і наприкінці. Практика — це\nчасте злиття, а машина робить його достатньо безпечним, щоб від нього не\nвідмовлялися.\n\nContinuous delivery і continuous deployment — наступні кроки. Delivery тримає\nкожну зелену збірку готовою до релізу, а deployment випускає кожну з них\nавтоматично. Обидва спираються на вже налагоджений CI, тому всі три так часто\nпишуть разом як CI/CD.\n\n## Чому це важливо\n\nЦіна злиття двох ліній роботи зростає швидше, ніж час, який вони провели\nокремо. Двоє розробників, що вчора змінили один і той самий модуль, розв'яжуть\nконфлікт за кілька хвилин, бо обоє пам'ятають свій задум. Двоє, чиї гілки\nрозійшлися шість тижнів тому, відновлюють задум із diff-ів. Невеликі часті\nзлиття тримають кожен конфлікт маленьким, і саме в цьому більша частина користі\nще до того, як з'являється будь-яка машина.\n\nЗбірка на кожен push додає ще одне: чисту машину, яка погоджується. «На моєму\nноутбуці працює» — твердження про один ноутбук із його власними бібліотеками й\nзабутими файлами. Runner, що щоразу починає зі свіжого checkout, або відтворює\nрезультат, або показує, чим ноутбук був особливим.\n\nЦінність — у швидкості. Стаття Фаулера ставить за мету близько десяти хвилин на\nосновну збірку, і на практиці це обґрунтування витримує перевірку. Помилка, про\nяку повідомлено через десять хвилин після push, повертається до того, хто її\nспричинив, поки зміна ще в нього на екрані. Помилка, про яку дізнаються наступного\nранку, дістається тому, хто випадково подивиться, і спершу коштує години\nрозкопок.\n\nВажить і видимість. Коли стан основної гілки бачать усі, ніхто не починає нову\nроботу поверх зламаної збірки, не знаючи про це, а виправлення збірки стає\nпершою справою команди, а не чиєюсь чужою проблемою.\n\nCI також не обов'язково означає хмарний сервіс. pre-commit запускає перевірки\nпроєкту як Git-хуки перед кожним комітом або push, а його документація\nпоказує, як той самий набір виконується на сервері через\n`pre-commit run --all-files`. Task дає кожній перевірці ім'я в одному\n`Taskfile.yml`, тож людина й runner викликають ту саму команду. Перевірки цього\nсайту працюють саме так: на машині, де пишеться сайт, із повною перевіркою перед\nкожним push і без хмарного сервісу збірки посередині.\n\n## Як це виглядає на практиці\n\nВипуск програм на одному проєкті тримався на ручних кроках, які кожен виконував\nтрохи по-своєму.\n[Їх замінили автоматизовані пайплайни збирання, тестування та розгортання](/uk/portfolio/streamlined-ci-cd-processes-saving-4000-hours/),\nі шлях від зміни до production став стандартизованим, а не імпровізованим.\nСторінка оцінює повернений час приблизно в 4 000 годин, а релізи стали\nводночас швидшими й надійнішими.\n\nДля довгоживучої бази даних CI стає охороною. На проєкті з такою базою схему\nописано двічі: один раз початковим налаштуванням і ще раз — 1 022 міграціями,\nпронумерованими від 036 до 1102.\n[CI-задача на кожну зміну збирає базу обома шляхами](/uk/portfolio/1022-migrations-behind-a-schema-drift-gate/):\nзі свіжої схеми і з усіма міграціями, відтвореними по черзі, — а потім порівнює\nі структуру, і початкові дані. Будь-яка розбіжність валить білд із виведеною\nрізницею, тож свіже середовище й довгоживуче — одна й та сама база, і це\nперевіряється, а не припускається.\n\nДві половини застосунку CI тримає в згоді на ще одному проєкті, де опис API і\nклієнт фронтенду генеруються ланцюгом, що починається з бази даних і\nзакінчується типізованим клієнтом TypeScript на 44 076 рядків.\n[Перевірка контракту в CI порівнює те, що надсилає фронтенд, із тим, що очікує API](/uk/portfolio/generated-the-api-contract-from-the-database-out/),\nі завалює білд за розбіжності. Результат, який описує сторінка, — саме те,\nзаради чого існує CI: поле, змінене лише з одного боку, падає у білді за кілька\nхвилин після зміни, а не доходить до користувача помилкою в браузері.\n\n## Де виникають проблеми\n\nБільшість налаштувань CI радше поступово занепадають, ніж ламаються. Кожен із\nцих сценаріїв починається з дрібниці, а закінчується збіркою, яку команда\nнавчилася обходити.\n\n**Збірка триває довше, ніж сама робота.** Коли відповідь на push приходить через\nсорок хвилин, люди перестають чекати, складають кілька змін в один push і\nнадсилають рідше, тобто роблять протилежне до практики. Спершу варто виміряти,\nкуди йде час, а вже потім купувати залізо. Кешуйте залежності, запускайте\nшвидкі перевірки першими, а повільні набори тестів виносьте в окремий етап або\nза розкладом, щоб основна збірка трималася біля десяти хвилин.\n\n**Основна гілка цілий день стоїть червоною.** Зламана збірка, яку ніхто не\nлагодить, стає звичним станом, і нова помилка ховається за старою. Правило, що\nцьому запобігає, просте: хто зламав, той виправляє зараз або відкочує зміну й\nвиправляє її спокійно. Зелена основна гілка — те, на чому будують усі інші.\n\n**Гілки живуть тижнями, а сервер збирає кожну з них.** Кожна гілка світиться\nзеленим, а проблеми приходять разом у день злиття. Це автоматизована збірка без\nінтеграції. Зливайте в основну гілку щонайменше щодня, а незавершені функції\nтримайте вимкненими, а не відокремленими.\n\n**Сервер перевіряє один список, а ноутбук — інший.** Два списки команд, які\nведуть вручну, розходяться. Тоді зміна проходить локально й падає на сервері\nабо навпаки, і довіри не лишається до жодного з них. Дайте перевіркам одну точку\nвходу й викликайте її з обох місць. З pre-commit сервер може запускати саме ті\nхуки, які запускає кожен розробник:\n\n```yaml\n# .gitlab-ci.yml\ncheck:\n    image: python:3.13\n    script:\n        - pip install pre-commit\n        - pre-commit run --all-files --show-diff-on-failure\n```\n\n**Нестабільний тест привчає всіх тиснути «перезапустити».** Тест, що падає раз\nна двадцять запусків із причин, які до зміни стосунку не мають, привчає команду\nперезапускати замість читати. Після цього справжня помилка отримує те саме\nставлення. Ізолюйте такий тест, виправте або видаліть його, а кнопку\nперезапуску, яку натискають часто, вважайте окремою знахідкою.\n\n## Що почитати далі\n\n- [Continuous Integration](https://martinfowler.com/articles/continuousIntegration.html)\n  — довга стаття Мартіна Фаулера: кожна практика, збірка на десять хвилин і\n  походження назви.\n- [Understanding GitHub Actions](https://docs.github.com/en/actions/get-started/understand-github-actions)\n  — робочі процеси, події, завдання й виконавці (runners) так, як їх визначає сам GitHub.\n- [GitLab CI/CD](https://docs.gitlab.com/ci/) — файл `.gitlab-ci.yml`,\n  пайплайни, етапи, завдання й виконавці у термінах самого GitLab.\n- [pre-commit](https://pre-commit.com/) — перевірки, оголошені один раз у\n  конфігураційному файлі, що працюють як Git-хуки і ще раз як крок на\n  CI-сервері.\n- [Task](https://taskfile.dev/) — `Taskfile.yml`, що дає кожній перевірці одне\n  ім'я, тож людина й runner вводять ту саму команду.\n\n\u003chttps://engineer.company/uk/glossary/ci/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Чого безперервна інтеграція вимагає від команди, що додає CI-сервер, як практика виглядає на справжніх проєктах і де вона непомітно розвалюється.","formats":{"gemtext":"https://engineer.company/uk/glossary/ci/index.gmi","gopher":"https://engineer.company/uk/glossary/ci/gophermap","html":"https://engineer.company/uk/glossary/ci/","json":"https://engineer.company/uk/glossary/ci/index.json","markdown":"https://engineer.company/uk/glossary/ci/index.md","pdf":"https://engineer.company/uk/glossary/ci/index.pdf"},"kind":"page","language":"uk","title":"Що таке CI?","url":"https://engineer.company/uk/glossary/ci/","version":1}