Provision
—— XP

GitLab: что внутри и сколько он ест

теория~5 минут+210 XP

Открой вакансию DevOps в российской компании, которая держит код у себя, — банк, маркетплейс, госпроект, студия, — и почти наверняка найдёшь строчку «поддерживать наш GitLab и раннеры». По сути GitLab — общий дом для кода команды: в нём лежат репозитории, коллеги читают правки друг друга, хранятся образы контейнеров и крутятся конвейеры CI/CD. Знать его исходники не обязательно, а вот поставить, настроить и понять, почему он лёг, — обязательно. Этим урок и занят.

Делает его компания GitLab Inc., первая версия вышла в 2011 году как открытая замена GitHub для своих серверов. Бесплатная редакция называется CE (Community Edition), платная — EE; для нашего раздела хватает CE целиком. Главное, что надо знать перед установкой: GitLab — не одна программа, а целый комбайн из десятка служб в одной коробке. Отсюда и его сила (всё готово из коробки), и его вес.

Что внутри коробки

Официальный способ поставить GitLab — пакет Omnibus: один пакет, в котором собраны все нужные службы и их настройки. Docker-образ gitlab/gitlab-ce — это тот же Omnibus, запакованный в контейнер. Внутри работают:

Службы GitLab
Puma
Веб-сервер на Ruby: отдаёт интерфейс и API. Главный потребитель памяти.
Sidekiq
Фоновые задачи: письма, обработка push, очистка. Тоже ест много.
Gitaly
Хранилище Git-репозиториев: через него идут все clone и push.
PostgreSQL и Redis
База данных и кеш — те же, что в разделе про базы, только встроенные.
nginx
Принимает HTTP-запросы снаружи и раздаёт их службам внутри.
Prometheus и экспортёры
Встроенный мониторинг самого GitLab. На стенде не нужен — его выключим.

Все эти службы запускает и сторожит одна программа внутри контейнера, 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. Вот три главные строки оттуда:

фрагмент GITLAB_OMNIBUS_CONFIG
puma['worker_processes'] = 0
sidekiq['concurrency'] = 10
prometheus_monitoring['enable'] = false

Первая строка переводит Puma в режим одного процесса без отдельных рабочих: медленнее под нагрузкой, но на одного человека хватает. Вторая уменьшает число параллельных фоновых задач Sidekiq. Третья выключает встроенный Prometheus и все его экспортёры — свой мониторинг ты уже ставил в разделе 10.

По документации эти правки экономят несколько сотен мегабайт. Чуда не будет: GitLab всё равно останется самой тяжёлой программой на стенде.

Ещё одна настройка обязательна, а не желательна: external_url — адрес, по которому GitLab доступен снаружи. По нему он строит все ссылки в интерфейсе, адрес для git clone и адрес, который получит раннер. Укажешь localhost — интерфейс откроется у тебя в браузере, а контейнеры задач пойдут на localhost самих себя и ничего не найдут. Поэтому адрес пишут таким, каким его видят все: IP стенда и порт.

Словарь урока

Omnibus
Пакет GitLab, в котором собраны все его службы и настройки. Docker-образ — тот же Omnibus. ↩ к тексту
gitlab.rb
Главный файл настроек GitLab на языке Ruby. В Docker его строки передают через GITLAB_OMNIBUS_CONFIG.
external_url
Адрес GitLab снаружи. От него строятся ссылки, адрес клонирования и адрес для раннера.
gitlab-ctl
Программа внутри контейнера, которая запускает и сторожит службы GitLab.

Что спросят на собеседовании

  • Из каких частей состоит GitLab?
    Puma отдаёт веб и API, Sidekiq выполняет фоновые задачи, Gitaly хранит репозитории, PostgreSQL и Redis — база и кеш, nginx принимает запросы. Задачи CI выполняет не он, а отдельный раннер.
  • GitLab тормозит и падает на маленькой машине. Что делать?
    Проверить память через docker stats и gitlab-ctl status, урезать Puma и Sidekiq, выключить встроенный мониторинг по официальной странице про малую память. Если не помогло — добавить памяти: на 2–3 ГБ он работает на пределе.

Что дальше

Дальше — поставить его на стенд своими руками, по шагам.

Проверь себя+210 XPдве попытки
1
Что внутри
Что лежит внутри официального образа gitlab/gitlab-ce?
2
Адрес
Зачем GitLab нужна настройка external_url?
3
Аппетит
Что из этого снижает память, которую ест GitLab?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.