В этой практике ты поставишь на стенд настоящий GitLab CE — тот самый, что стоит в компаниях. Ставить будем так же, как ставил стек в разделе 08: один сервис в файле Compose, данные — в каталогах рядом.
Займёт это минут сорок, из которых пятнадцать — ожидание: GitLab первый раз запускается долго. Не пугайся, если в первые минуты вместо страницы входа видишь ошибку 502, — это нормально.
Шаг 1. Проверить память
GitLab — самая тяжёлая программа курса, поэтому сначала убедимся, что ему есть где развернуться. Команда free показывает память, флаг -h — в понятных единицах.
free -htotal used free shared buff/cache available Mem: 7.7Gi 1.4Gi 4.9Gi 12Mi 1.6Gi 6.1Gi Swap: 2.0Gi 0B 2.0Gi
Смотри на колонку available — сколько память реально можно отдать новым программам. Нужно хотя бы 6 ГБ. Если меньше, останови стенды, которые в этом разделе не нужны: docker compose stop в ~/infra/db, ~/infra/monitoring и ~/infra/logs. Стенд ~/infra/stand не трогай — на него конвейер будет выкатывать приложение. Не хватает и после этого — пройди раздел на gitlab.com.
Шаг 2. Каталог для GitLab
GitLab живёт отдельно от приложения: у него свой каталог, своё описание Compose и свои данные.
mkdir ~/gitlab cd ~/gitlab
Узнай адрес стенда в локальной сети — он понадобится в настройках. Флаг -br у ip значит «коротко» (brief): одна строка на интерфейс.
ip -br alo UNKNOWN 127.0.0.1/8 ::1/128 enp0s3 UP 192.168.1.50/24 fe80::a00:27ff:fe4e:66a1/64
Дальше в уроках адрес стенда — 192.168.1.50. У тебя он свой: подставляй его везде, где встретишь этот.
Этот адрес осядет во многих местах: в настройках GitLab, раннера, реестра, в переменных конвейера. Если стенд получает его от роутера по DHCP, после перезагрузки ноутбука адрес может смениться, и весь раздел молча сломается. Поэтому сейчас закрепи адрес за машиной: в настройках роутера это называется «резервирование DHCP» или «статический адрес по MAC».
Шаг 3. Образ и имя
Начинаем файл compose.yaml с самого сервиса. Версию образа фиксируем точно, как учились в разделе 07: тег latest однажды обновит GitLab на новую мажорную версию без спроса.
services: gitlab: image: gitlab/gitlab-ce:19.4.3-ce.0 container_name: gitlab hostname: gitlab shm_size: 256m
container_name даёт контейнеру короткое имя gitlab — по нему удобно заходить внутрь. shm_size — размер общей памяти внутри контейнера; документация GitLab просит 256 МБ, иначе встроенные службы жалуются. Свежие версии смотри на Docker Hub, на странице gitlab/gitlab-ce.
Шаг 4. Порты
Допиши ниже, с тем же отступом, что у image, порты. Веб-интерфейс будет на 8929, а Git по SSH — на 2424, потому что 22 на стенде уже занят твоим собственным SSH.
ports: - "8929:8929" # веб — тот же порт, что в external_url - "2424:22" # git по SSH
Обрати внимание на первую строку: порт внутри контейнера тоже 8929, а не 80. GitLab слушает тот порт, который написан в его адресе, — разведёшь их, и страница не откроется.
В разделе 07 мы публиковали порты только на петлю 127.0.0.1, потому что опубликованный порт Docker открывает в обход ufw. Здесь порты открыты на всех интерфейсах сознательно: в GitLab ходит браузер с твоего ноутбука, а раннер и Docker стенда — по адресу стенда. Цена — GitLab виден всей домашней сети, поэтому ниже, в шаге 9, сразу меняем пароль root и закрываем регистрацию. В интернет такой GitLab без TLS и файрвола не выставляют.
Шаг 5. Тома
Данные GitLab — репозитории, база, настройки — должны пережить пересоздание контейнера. Кладём их в каталоги рядом с файлом, как делали с базой в разделе 08.
volumes: - ./config:/etc/gitlab # настройки и пароль root - ./logs:/var/log/gitlab # журналы всех служб - ./data:/var/opt/gitlab # репозитории, база, образы
Самый ценный каталог — data: в нём всё, что ты создашь в GitLab. Удалишь его — начнёшь с чистого листа.
Шаг 6. Настройки GitLab
Последний кусок — настройки самого GitLab. Они пишутся строками Ruby в переменную GITLAB_OMNIBUS_CONFIG; знак | в YAML значит «дальше многострочный текст». Без двух строк GitLab не заработает как надо — с них и начнём.
environment: GITLAB_OMNIBUS_CONFIG: | external_url 'http://192.168.1.50:8929' gitlab_rails['gitlab_shell_ssh_port'] = 2424
Первая строка — адрес, по которому GitLab видят все, включая раннер. Вторая говорит GitLab, что SSH снаружи на порту 2424, — так в интерфейсе будут правильные ссылки для git clone.
Перед запуском проверь, что файл собрался без ошибок. Команда config печатает итоговое описание, флаг -q (quiet) — молчит, если всё в порядке.
docker compose config -qПустой вывод — хороший знак. Ошибка отступа выглядит так: yaml: line 9: did not find expected key.
Шаг 7. Запустить и подождать
Поднимаем GitLab в фоне, флаг -d — отцепиться от терминала. Образ весит около 1,5 ГБ, первая загрузка займёт пару минут.
docker compose up -d[+] Running 2/2 ✔ Network gitlab_default Created ✔ Container gitlab Started
«Started» значит только «контейнер запущен». Внутри GitLab ещё минут пять настраивает себя — ставит базу, создаёт таблицы. За этим следит встроенная проверка здоровья.
docker compose psNAME IMAGE STATUS gitlab gitlab/gitlab-ce:19.4.3-ce.0 Up 2 minutes (health: starting)
health: starting — GitLab ещё просыпается. Повторяй команду раз в минуту, пока не появится (healthy). Колонки здесь сокращены, у тебя их будет больше.
Если ждать скучно, посмотри, что он делает. Флаг --tail 5 — последние пять строк журнала.
docker compose logs --tail 5 gitlabgitlab | Recipe: gitlab::database_migrations gitlab | * bash[migrate gitlab-rails database] action run gitlab | ... gitlab | gitlab Reconfigured!
Строка gitlab Reconfigured! — настройка закончена. Через минуту-другую после неё статус станет healthy.
Шаг 8. Пароль root
При первом запуске GitLab сам придумывает пароль администратора root и кладёт его в файл внутри контейнера.
docker exec gitlab cat /etc/gitlab/initial_root_password# WARNING: This value is valid only in the following conditions # 1. If provided manually ... Password: 7Fh2kQ9xLmT4pW1vNsZ8aB3cR6yE0uJdG5oKiHq= # NOTE: This file will be automatically deleted in the first reconfigure run after 24 hours.
Нужна строка Password:. Последняя строка — важное предупреждение: через сутки файл удалится, и пароль больше нигде не найти. Поэтому сразу после входа его меняют.
Шаг 9. Первый вход
Открой в браузере http://192.168.1.50:8929. Если видишь 502 Whoops, GitLab is taking too much time to respond — он ещё просыпается, подожди.
Войди как root с паролем из файла. Затем смени его: аватар в левом верхнем углу → Edit profile → Password. Новый пароль сохрани в менеджере паролей.
И сразу закрой самостоятельную регистрацию: Admin (внизу левого меню) → Settings → General → Sign-up restrictions → сними галочку Sign-up enabled. GitLab в домашней сети не публичный, но привычка правильная: на рабочем сервере открытая регистрация — дыра.
Шаг 10. Сколько он ест
Теперь посмотрим ту цифру, ради которой был первый шаг. docker stats показывает потребление контейнеров, флаг --no-stream — один снимок вместо бегущей таблицы.
docker stats --no-stream gitlabCONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % 3c1f9a2b7d44 gitlab 2.76% 4.486GiB / 7.7GiB 58.3%
Колонка MEM USAGE — четыре с половиной гигабайта, и это в покое, без единого проекта. GitLab по умолчанию рассчитан на сотни пользователей: он запускает по рабочему процессу веб-сервера на каждое ядро, держит большую очередь фоновых задач и свой мониторинг. Стенду с конвейером и приложением столько не отдать.
Шаг 11. Урезать
Для одного человека в документации GitLab есть урезанные настройки. Допиши в GITLAB_OMNIBUS_CONFIG три строки под gitlab_shell_ssh_port:
puma['worker_processes'] = 0 sidekiq['concurrency'] = 10 prometheus_monitoring['enable'] = false
Первая оставляет веб-сервер Puma в одном процессе, вторая сужает очередь фоновых задач Sidekiq, третья выключает встроенный мониторинг — свой у нас уже есть. Полный список — в статье о работе в ограниченной памяти. Настройки окружения читаются только при создании контейнера, поэтому up -d его пересоздаст, данные в томах не пострадают.
docker compose up -d[+] Running 1/1 ✔ Container gitlab Recreated
Подожди (healthy) и ещё пару минут и повтори замер.
docker stats --no-stream gitlabCONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % 3c1f9a2b7d44 gitlab 1.53% 2.585GiB / 7.7GiB 33.6%
Вдвое меньше. Это и есть честная цена своего GitLab на стенде. А что внутри живо, показывает gitlab-ctl status — запускаем его в контейнере через docker exec.
docker exec gitlab gitlab-ctl statusrun: gitaly: (pid 2024) 132s; run: log: (pid 1136) 287s run: gitlab-kas: (pid 1551) 276s; run: log: (pid 1582) 274s run: gitlab-workhorse: (pid 1974) 133s; run: log: (pid 1767) 171s run: logrotate: (pid 1031) 300s; run: log: (pid 1058) 297s run: nginx: (pid 1992) 133s; run: log: (pid 1867) 164s run: postgresql: (pid 1174) 282s; run: log: (pid 1190) 281s run: puma: (pid 1651) 185s; run: log: (pid 1679) 182s run: redis: (pid 1061) 294s; run: log: (pid 1076) 293s run: sidekiq: (pid 1682) 179s; run: log: (pid 1730) 176s run: sshd: (pid 44) 315s; run: log: (pid 43) 315s
Каждая строка — служба из прошлого урока, run: значит «работает», число секунд — сколько она живёт. Если какая-то служба постоянно перезапускается, число у неё будет маленьким, и с неё начинают разбор.
Шаг 12. Подниматься после перезагрузки
Последняя строка — политика перезапуска. Без неё GitLab после перезагрузки стенда останется лежать, и конвейеры молча перестанут запускаться. Допиши в сервис, под container_name:
restart: unless-stoppedПримени тем же docker compose up -d. Если ты остановишь GitLab сам, следующий шаг, он останется остановленным и после перезагрузки — так и задумано.
Шаг 13. Погасить, когда не нужен
Когда закончишь на сегодня, останови GitLab — освободишь два с половиной гигабайта для других разделов.
docker compose stop[+] Stopping 1/1 ✔ Container gitlab Stopped
Данные остались в ~/gitlab/data. Запустить обратно — docker compose start, и снова подождать healthy три-пять минут. Перед сдачей практики запусти его и дождись здоровья: проверка смотрит на живой GitLab.
Шаг 14. Сдать
Выполни команду сдачи из блока ниже. Она покажет статус контейнера, строки настроек из compose.yaml и ответ страницы входа.