{"canonical_url":"https://engineer.company/uk/glossary/gitlab/","content_markdown":"# GitLab\n\n## Що це таке\n\nGitLab — це єдиний застосунок, побудований довкола git-репозиторіїв: він\nзберігає код і додає до нього merge request для рев'ю, issues для планування та\nвбудовану систему CI/CD, яка збирає, тестує й розгортає з того самого місця. Від\nінших його відрізняє вибір того, де він працює. Той самий продукт доступний як\nGitLab.com, сервіс, який GitLab веде сам; як GitLab Self-Managed, який\nвстановлюють на власні сервери; і як GitLab Dedicated, окремий екземпляр для\nодного клієнта, який GitLab розміщує й обслуговує в регіоні AWS, обраному цим\nклієнтом.\n\nПід усім цим лежить звичайний git. Кожен проєкт — це git-репозиторій, який можна\nклонувати, надсилати в нього зміни й отримувати їх звичними командами, а історія\nв клоні повна. Усе, що GitLab додає зверху, від обговорень під час рев'ю та\nissues до результатів конвеєрів і прав доступу, зберігає сам GitLab поза\nрепозиторієм, і клон нічого з цього не несе.\n\nMerge request — це назва, яку GitLab дає запропонованій зміні, що чекає на\nзлиття; інші платформи називають ту саму ідею pull request. Документація описує\nйого як центральне місце, де переглядають код, ведуть обговорення і відстежують\nзміну. На одній сторінці видно опис, зміни в коді з коментарями до окремих\nрядків, стан конвеєрів CI/CD, звіти про те, чи можна зміну злити, і список\nкомітів. Merge request можна пов'язати з issue, і тоді він автоматично закриє це\nissue під час злиття. Усталено основну гілку проєкту, зазвичай main, захищено, і\nзливати в неї можуть лише люди з роллю Maintainer або вищою.\n\nСистему CI/CD налаштовують у файлі `.gitlab-ci.yml` у корені проєкту. Він\nвизначає етапи, завдання та скрипти, з яких складається конвеєр: етапи задають\nпорядок, наприклад збирання, потім тести, потім розгортання, а завдання — це\nроботи, які виконуються на кожному етапі. Завдання виконує GitLab Runner, окрема\nпрограма, написана мовою Go й поширювана як один бінарний файл. Runner\nпід'єднується до екземпляра GitLab, чекає на завдання, виконує кожне просто на\nмашині, у контейнері Docker або на віддаленому сервері через SSH і повідомляє\nрезультат назад.\n\n## Чому це важливо\n\nБільшість того, що команда розробників робить між написанням коду та його\nвипуском, може відбуватися в одному екземплярі GitLab: код, рев'ю, конвеєр, що\nйого тестує, issue, у якому про нього попросили, і запис про те, хто що схвалив.\nОдин застосунок означає один набір облікових записів і прав, одне місце для\nпошуку і зв'язки, які тримаються між issue, merge request, що його закрив, і\nконвеєром, що зміну перевірив.\n\nМожливість вести GitLab самостійно — причина, через яку багато організацій\nузагалі його обирають. Коли код має лишатися на власній інфраструктурі компанії\nчерез договір, регулятора чи внутрішні правила, хостинговий сервіс відпадає, а\nGitLab можна встановити всередині тієї мережі, яка має цей код берегти.\nДокументація вважає це повноцінним сценарієм: вона публікує еталонні архітектури\nдля встановлень на 1 000–50 000 користувачів, поруч із пакетом для Linux і\nHelm-чартом для Kubernetes.\n\nЦей контроль має ціну, і платять її роботою з експлуатації, а не лише\nліцензіями. Вести GitLab самостійно означає підібрати для нього сервер,\nпідтримувати в доброму стані базу PostgreSQL і сховище Redis або Valkey,\nвиділити машини для runner-ів, робити резервні копії, з яких справді можна\nвідновитися, і проходити оновлення в тому порядку, якого вимагає проєкт.\nХостингові варіанти передають цю роботу GitLab; самостійний лишає її вам.\n\n## Як це виглядає на практиці\n\nРобота компанії стикалася з GitLab з обох боків.\n\nПротягом кількох років роботи з даними\n[практики CI/CD на основі GitHub і GitLab](/uk/portfolio/saved-4000-hours-with-github-and-gitlab-ci-cd/),\nде саму автоматизацію забезпечували Bash і Python, замінили ручні кроки і в\nаналізі даних, і в розробці. Шлях роботи від розробки до постачання\nстандартизували, щоб він щоразу був однаковим, а не вигадувався заново для\nкожного проєкту, а аналітичний напрям, який довго вважали окремим і більш ручним\nсвітом, увійшов у той самий конвеєр, що й розробка. Сторінка називає приблизно\n4 000 заощаджених годин і більш узгоджені результати постачання, бо роботу\nбільше не виконували щоразу трохи по-різному.\n\nВласний код компанії показує інший бік самостійного хостингу. Після відмови від стороннього хостингового сервісу його перенесли на [форджу, яку компанія обслуговує сама: це один бінарний файл, орієнтований насамперед на SSH, без адміністративного вебінтерфейсу](/uk/portfolio/your-code-on-your-own-hardware/), обрану за принципом: що менше інтерфейсу, то менше треба захищати. Ця форджа ділить [хост публічних сервісів із 512 МБ пам'яті](/uk/portfolio/a-whole-company-on-one-small-server/), з яких близько 464 МБ придатні до використання, з вебсервером для семи доменів, onion-сервісом Tor, сервером Gemini, сервером Gopher і блокуванням спроб вторгнення. Автоматизацію резервного копіювання реалізовано окремо; реалізація автоматизації не означає наявності активних резервних копій.\n\nЖодна з цих двох сторінок не згадує GitLab, і подальше порівняння — власна\nарифметика цієї статті. GitLab називає 8 ГБ пам'яті мінімумом, з яким може\nпрацювати встановлення на одному вузлі; увесь той сервер має шістнадцяту частину\nцього обсягу. Вести GitLab самостійно означає мати сервер, розрахований на\nGitLab, а невелика форджа з однією метою — інший шлях тримати код на власних\nмашинах.\n\nМінімальний файл конвеєра показує форму налаштувань CI/CD: два етапи, що\nвиконуються по черзі, і по одному завданню в кожному:\n\n```yaml\nstages:\n    - build\n    - test\n\nbuild-site:\n    stage: build\n    script:\n        - make build\n\nrun-tests:\n    stage: test\n    script:\n        - make test\n```\n\n## Де виникають проблеми\n\n- **Малий сервер сповільнює весь екземпляр.** Документація GitLab називає 16 ГБ\n  пам'яті базовим рівнем для встановлення на одному вузлі, а 8 ГБ — найменшим\n  обсягом, з яким воно може працювати в середовищі з обмеженою пам'яттю. Вона\n  також попереджає, що swap може суттєво знизити продуктивність під\n  навантаженням, і просить вимикати swap, де це можливо, або дати стільки\n  пам'яті, щоб GitLab ніколи ним не користувався.\n- **Резервна копія відновлюється в екземпляр, що не може прочитати власні\n  дані.** Команда резервного копіювання не включає каталог конфігурації\n  `/etc/gitlab`, а з ним і `gitlab-secrets.json` — ключі, що розшифровують\n  зашифровані значення в базі даних. Без цього файлу ці значення у відновленій\n  базі лишаються замкненими. Документація просить робити резервну копію\n  конфігурації окремо, щонайменше `gitlab-secrets.json` і `gitlab.rb`.\n- **Оновлення перескакує через обов'язкову зупинку.** Шляхи оновлення містять\n  обов'язкові зупинки, тобто версії, які треба встановити перед будь-якою\n  пізнішою, і починаючи з GitLab 17.5 вони припадають на x.2, x.5, x.8 і x.11.\n  Фонові міграції кожної зупинки мають завершитися до початку наступного\n  оновлення, тож екземпляр, що відстав на кілька версій, наздоганяє їх по одній\n  зупинці за раз.\n- **Кероване сховище даних виявляється непідтримуваним.** PostgreSQL — єдина\n  підтримувана база даних. Redis або Valkey зберігає сесії та фонові задачі й\n  має бути окремим самостійним екземпляром: Redis Cluster і serverless-варіанти\n  Redis і Valkey не підтримуються. Керований хмарний сервіс дозволено, якщо він\n  саме самостійного типу.\n- **Конвеєри чекають на машини, які ніхто не запланував.** GitLab.com надає\n  готові runner-и, а на самостійному екземплярі адміністратор сам забезпечує й\n  обслуговує інфраструктуру, де виконуються завдання CI/CD, зокрема стежить, щоб\n  runner-и мали достатньо потужності для навантаження організації. Завантажена\n  команда з одним малим runner-ом стоїть за ним у черзі.\n\n## Що почитати далі\n\n- [GitLab Docs](https://docs.gitlab.com/) — повна документація про використання,\n  встановлення та адміністрування GitLab.\n- [Installation requirements](https://docs.gitlab.com/install/requirements/) —\n  пам'ять, процесор, сховище та підтримувані версії PostgreSQL і Redis.\n- [Back up GitLab](https://docs.gitlab.com/administration/backup_restore/backup_gitlab/)\n  — що містить резервна копія, чого в ній немає і як зберігати секрети поруч із\n  нею.\n- [Upgrade paths](https://docs.gitlab.com/update/upgrade_paths/) — обов'язкові\n  зупинки оновлення і чому фонові міграції мають завершитися між ними.\n- [Get started with GitLab CI/CD](https://docs.gitlab.com/ci/) — файл\n  `.gitlab-ci.yml`, етапи, завдання й конвеєри.\n- [GitLab Runner](https://docs.gitlab.com/runner/) — програма, що виконує\n  завдання, і способи, якими вона може їх виконувати.\n\n\u003chttps://engineer.company/uk/glossary/gitlab/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Що GitLab збирає довкола git, чому команди ставлять його на власні сервери і яку роботу з пам'яттю, резервними копіями та оновленнями це за собою тягне.","formats":{"gemtext":"https://engineer.company/uk/glossary/gitlab/index.gmi","gopher":"https://engineer.company/uk/glossary/gitlab/gophermap","html":"https://engineer.company/uk/glossary/gitlab/","json":"https://engineer.company/uk/glossary/gitlab/index.json","markdown":"https://engineer.company/uk/glossary/gitlab/index.md","pdf":"https://engineer.company/uk/glossary/gitlab/index.pdf"},"kind":"page","language":"uk","title":"Що таке GitLab?","url":"https://engineer.company/uk/glossary/gitlab/","version":1}