Provision
—— XP

GitLab тяжёлый — какие есть альтернативы

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

Шесть гигабайт памяти — столько держит свой GitLab на стенде, и это мы честно измерили в уроке установки. У кого-то на машине восемь гигабайт, у кого-то четыре, а у кого-то домашний мини-сервер на два. Отсюда вопрос, который рано или поздно задаёт себе каждый: можно ли обойтись чем-то полегче и при этом не потерять смысл раздела?

Можно, но с оговорками, и их стоит знать заранее. Основа курса остаётся прежней — классический GitLab: на работе почти наверняка будет он или GitHub, и вакансии спрашивают именно их. Этот урок — для тех, у кого мало памяти, и для кругозора: какие лёгкие замены бывают, что каждая из них повторяет и чего в ней не найдёшь. Руками ничего ставить не нужно, достаточно понимать, из чего выбирать.

Пять вариантов в одной таблице

Сравнивать варианты удобнее всего по двум вопросам: сколько памяти они просят и чему ты на них научишься. Цифры в таблице — по документации и замерам сообщества, это ориентир, а не обещание: на твоей машине они будут немного другими.

ВариантПамятьЧто повторяетЧего нет
gitlab.com + свой раннер на стенде~100 МБ (только раннер)Всё один в один: тот же .gitlab-ci.yml, MR, реестр, переменные, окруженияНе увидишь установку и обслуживание сервера GitLab
Forgejo (открытый форк Gitea) + Forgejo Actions~150–300 МБРепозитории, pull request и ревью, задачи, wiki, реестр образов, CI с раннеромСинтаксис CI как у GitHub Actions, а не GitLab; меньше готовых интеграций
Gitea + Gitea Actions~150–300 МБТо же, что ForgejoТо же; Forgejo — более открытая ветка того же проекта
Forgejo + Woodpecker CI~300–400 МБРепозитории и отдельный CIТретий синтаксис CI — файл .woodpecker.yml
Урезанный GitLab (официальный режим для малой памяти)2,5–3 ГБВсёРаботает на пределе, медленнее, без встроенного мониторинга

Прочитай первую строку. На gitlab.com — облачном GitLab, которым компания GitLab Inc. разрешает пользоваться бесплатно, — сервер уже кто-то держит за тебя. У себя ты ставишь только раннер, тот самый, что выполняет задачи конвейера, а он весит около сотни мегабайт. Всё, что ты писал в .gitlab-ci.yml, работает без единой правки. Теряешь одно: опыт поднять GitLab самому и разобраться, почему он лёг.

Таблица показывает цифры, но не объясняет, почему внизу нет варианта «то же самое, только лёгкое».

Почему лёгкая замена не повторяет GitLab

Причина в файле конвейера. Формат .gitlab-ci.yml понимает только GitLab — свой, облачный или урезанный. Ни один из лёгких серверов его не читает, поэтому конвейеры из этого раздела на них придётся переписать.

Зато у Forgejo и Gitea встроенный CI — Forgejo Actions и Gitea Actions — сделан по образцу GitHub Actions. Те же on, jobs, steps, тот же uses с готовыми действиями. Значит, словарь соответствий из прошлого урока переносится почти целиком: читаешь workflow от GitHub — прочитаешь и от Forgejo.

Откуда два почти одинаковых проекта? Forgejo — форк Gitea, то есть копия её исходного кода, которую другая команда стала развивать сама. В октябре 2022 года домен и товарный знак Gitea перешли коммерческой компании Gitea Ltd без согласия сообщества. Часть разработчиков с этим не согласилась, и в декабре 2022 года вышел Forgejo под присмотром некоммерческой организации Codeberg. С тех пор проекты развиваются параллельно, а с 2024 года Forgejo идёт своим путём и уже не копирует каждую правку Gitea.

Woodpecker CI стоит особняком: это отдельный сервер конвейеров, который подключают к Forgejo или Gitea вместо встроенного CI. Он вырос из форка Drone CI и описывает конвейер своим файлом .woodpecker.yml — третьим синтаксисом после GitLab и GitHub. Для кругозора полезно, для вакансий — почти не встречается.

Остался последний вариант из таблицы — тот же GitLab, только на голодном пайке.

Урезанный GitLab

У GitLab есть официальная страница Running GitLab in a memory-constrained environment — как запустить его там, где памяти мало. Три её главные строки ты уже ставил в уроке про GitLab, а здесь видна вся картина: что выключают и что это даёт.

Настройки — строки на языке Ruby в файле gitlab.rb. Это кусок конфига, а не команды для терминала:

фрагмент gitlab.rbскрипт подготовки, выполняется целиком
puma['worker_processes'] = 0
sidekiq['concurrency'] = 10
prometheus_monitoring['enable'] = false
gitlab_rails['env'] = { 'MALLOC_CONF' => 'dirty_decay_ms:1000,muzzy_decay_ms:1000' }

Первая строка оставляет веб-сервер Puma в одном процессе вместо нескольких — по документации это сотня-другая мегабайт. Вторая уменьшает число фоновых задач, которые Sidekiq выполняет одновременно. Третья выключает встроенный мониторинг и его экспортёры — ещё около 300 МБ. Четвёртая просит распределитель памяти jemalloc быстрее возвращать системе то, что уже не нужно: без неё процесс держит освободившуюся память «про запас».

Пятое условие стоит не в конфиге, а на машине: подкачка (swap) от 1 ГБ обязательна. Подкачка — кусок диска, куда система выгружает редко нужное, когда кончилась оперативная память; без неё GitLab на 2–3 ГБ просто убьют при первом пике. В Docker эти строки задаются переменной GITLAB_OMNIBUS_CONFIG в compose.yaml — ровно так, как в уроке установки.

Цена у такой экономии понятная. Интерфейс открывается медленнее, фоновые задачи (письма, обработка push) идут дольше, а обновление на новую версию может упереться в память и зависнуть посреди миграции базы. Для одного человека на стенде это терпимо, для команды — нет.

Осталось решить, какой вариант нужен именно тебе.

Как выбрать

Начинать стоит с вопроса, зачем ты всё это делаешь. Ответ почти всегда один из трёх.

Учишь DevOps под вакансии — бери GitLab: полный, если памяти хватает, или gitlab.com со своим раннером, если нет. Это то, что спросят на собеседовании и что будет на работе. Держишь свой домашний сервер на 1–2 ГБ и хочешь хранить на нём код — ставь Forgejo, он поместится рядом с другими сервисами. Уже живёшь на GitHub — пользуйся GitHub Actions, свой сервер вообще не нужен.

Какой бы путь ты ни выбрал, полезно уметь за секунду проверить, сколько что ест.

Быстрая проверка памяти

Спорить о цифрах из таблицы бессмысленно, когда можно посмотреть на свои. docker stats показывает, сколько ресурсов берут запущенные контейнеры, а флаг --no-stream просит один снимок вместо таблицы, которая обновляется каждую секунду.

ubuntu@stand:~$
docker stats --no-stream
CONTAINER ID   NAME      CPU %   MEM USAGE / LIMIT     MEM %
3c1f9a2b7d44   gitlab    3.87%   5.74GiB / 7.7GiB      74.5%
8e21d0c4a913   runner    0.02%   38.1MiB / 7.7GiB      0.48%
5b7a19f3e602   forgejo   0.15%   182MiB / 7.7GiB       2.31%
a04c6e88d1f7   app       0.01%   21.4MiB / 7.7GiB      0.27%

Читать нужно колонку MEM USAGE. Число до косой черты — сколько контейнер держит прямо сейчас, после — сколько ему разрешено; если лимит не задан, там вся память машины. MEM % — то же самое в процентах. Здесь видна вся разница: GitLab — почти шесть гигабайт, Forgejo — меньше двухсот мегабайт, раннер — сорок.

Обрати внимание на единицы: GiB — гигабайты, MiB — мегабайты. Новички иногда сравнивают 182 и 5.74 как числа и пугаются не того контейнера.

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

Форк
Копия исходного кода проекта, которую другая команда развивает сама, отдельно от оригинала. ↩ к тексту
Forgejo
Лёгкий сервер для репозиториев с ревью, задачами и встроенным CI в стиле GitHub Actions. Форк Gitea под присмотром некоммерческой Codeberg. ↩ к тексту
Gitea
Лёгкий сервер для репозиториев, из которого вырос Forgejo. Развивается компанией Gitea Ltd. ↩ к тексту
Woodpecker CI
Отдельный сервер конвейеров для Forgejo и Gitea со своим файлом .woodpecker.yml. Вырос из форка Drone CI. ↩ к тексту
Режим малой памяти
Официальные настройки GitLab для машин на 2–3 ГБ: Puma в одном процессе, меньше Sidekiq, без мониторинга, подкачка от 1 ГБ.

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

  • На сервере 4 ГБ, команде нужен GitLab. Что посоветуешь?
    Свой GitLab на 4 ГБ будет жить на пределе даже урезанным. Проще gitlab.com или GitLab, которым управляет облако, а у себя держать только раннеры. Если нужен именно свой сервер — добавить памяти до 8 ГБ.
  • Чем Forgejo отличается от GitLab для CI?
    Forgejo намного легче, но его CI использует синтаксис как у GitHub Actions, поэтому .gitlab-ci.yml придётся переписать. Интеграций и встроенных функций у него меньше.
  • Как быстро понять, какой контейнер съел память?
    docker stats --no-stream и колонка MEM USAGE. Если виноват GitLab — внутри смотреть gitlab-ctl status и урезать его по странице про малую память.

Что дальше

Дальше — миссия раздела: провести новую версию от коммита до стенда в своём GitLab, со всеми шагами, которые ты прошёл.

Проверь себя+210 XPдве попытки
1
Варианты
Какой вариант повторяет весь раздел почти один в один, если памяти мало?
2
Синтаксис
На какой синтаксис похож файл конвейера в Forgejo Actions?
3
Форк
Почему Forgejo отделился от Gitea?
4
Проверка памяти
Какая колонка docker stats показывает, сколько памяти занял контейнер?
ответь на все вопросы, чтобы проверить

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