Открой вакансию DevOps в российской компании, которая держит код у себя, — банк, маркетплейс, госпроект, студия, — и почти наверняка найдёшь строчку «поддерживать наш GitLab и раннеры». По сути GitLab — общий дом для кода команды: в нём лежат репозитории, коллеги читают правки друг друга, хранятся образы контейнеров и крутятся конвейеры CI/CD. Знать его исходники не обязательно, а вот поставить, настроить и понять, почему он лёг, — обязательно. Этим урок и занят.
Делает его компания GitLab Inc., первая версия вышла в 2011 году как открытая замена GitHub для своих серверов. Бесплатная редакция называется CE (Community Edition), платная — EE; для нашего раздела хватает CE целиком. Главное, что надо знать перед установкой: GitLab — не одна программа, а целый комбайн из десятка служб в одной коробке. Отсюда и его сила (всё готово из коробки), и его вес.
Что внутри коробки
Официальный способ поставить GitLab — пакет Omnibus: один пакет, в котором собраны все нужные службы и их настройки. Docker-образ gitlab/gitlab-ce — это тот же Omnibus, запакованный в контейнер. Внутри работают:
Все эти службы запускает и сторожит одна программа внутри контейнера, gitlab-ctl. Это твой первый инструмент отладки: gitlab-ctl status показывает, какие службы живы, — почти как systemctl status, только для GitLab.
Из этого состава сразу видно, куда уходит память.
Сколько он ест
Официальная страница про машины с малой памятью обещает, что урезанный GitLab запустится и на 2,5 ГБ с гигабайтом подкачки, — но это предел, на котором он еле дышит. Замер на живом стенде честнее: работающий GitLab CE держит около 6 ГБ. Вместе с раннером, сборкой образов и стендом из раздела про Compose на машине нужно 8 ГБ.
Отсюда простое правило гигиены: когда GitLab не нужен, его гасят командой docker compose stop в его каталоге. Данные лежат в томах на диске и никуда не денутся, а память освободится для других разделов. Запуск обратно занимает три-пять минут — GitLab долго просыпается, это нормально.
Если на машине меньше 8 ГБ, раздел можно пройти на gitlab.com: бесплатный аккаунт, тот же интерфейс, тот же файл конвейера, раннер ставишь у себя. Честно о цене такого пути: шаги практик и автопроверка написаны под свой GitLab. На gitlab.com раннер регистрируется в настройках проекта на gitlab.com, реестр уже работает по HTTPS (registry.gitlab.com), и шаги про registry_external_url и insecure-registries не нужны. Адреса в выводе будут другими, поэтому проверка сдачи такие практики не засчитает — сверяйся с описанием шагов сам.
Но шесть гигабайт — это GitLab со всеми службами на полном ходу, а одному человеку на стенде столько не нужно.
Как снизить аппетит
У GitLab есть официальная страница «Running GitLab in a memory-constrained environment». Все настройки пишутся на языке Ruby в файл /etc/gitlab/gitlab.rb, а в Docker их удобнее передать переменной окружения GITLAB_OMNIBUS_CONFIG прямо в описании Compose. Вот три главные строки оттуда:
puma['worker_processes'] = 0 sidekiq['concurrency'] = 10 prometheus_monitoring['enable'] = false
Первая строка переводит Puma в режим одного процесса без отдельных рабочих: медленнее под нагрузкой, но на одного человека хватает. Вторая уменьшает число параллельных фоновых задач Sidekiq. Третья выключает встроенный Prometheus и все его экспортёры — свой мониторинг ты уже ставил в разделе 10.
По документации эти правки экономят несколько сотен мегабайт. Чуда не будет: GitLab всё равно останется самой тяжёлой программой на стенде.
Ещё одна настройка обязательна, а не желательна: external_url — адрес, по которому GitLab доступен снаружи. По нему он строит все ссылки в интерфейсе, адрес для git clone и адрес, который получит раннер. Укажешь localhost — интерфейс откроется у тебя в браузере, а контейнеры задач пойдут на localhost самих себя и ничего не найдут. Поэтому адрес пишут таким, каким его видят все: IP стенда и порт.
Словарь урока
Что спросят на собеседовании
- Из каких частей состоит GitLab?Puma отдаёт веб и API, Sidekiq выполняет фоновые задачи, Gitaly хранит репозитории, PostgreSQL и Redis — база и кеш, nginx принимает запросы. Задачи CI выполняет не он, а отдельный раннер.
- GitLab тормозит и падает на маленькой машине. Что делать?Проверить память через docker stats и gitlab-ctl status, урезать Puma и Sidekiq, выключить встроенный мониторинг по официальной странице про малую память. Если не помогло — добавить памяти: на 2–3 ГБ он работает на пределе.
Что дальше
Дальше — поставить его на стенд своими руками, по шагам.