Provision
—— XP

Практика: свой GitLab в Compose

практика~40 минут+525 XP

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

Займёт это минут сорок, из которых пятнадцать — ожидание: GitLab первый раз запускается долго. Не пугайся, если в первые минуты вместо страницы входа видишь ошибку 502, — это нормально.

Шаг 1. Проверить память

GitLab — самая тяжёлая программа курса, поэтому сначала убедимся, что ему есть где развернуться. Команда free показывает память, флаг -h — в понятных единицах.

ubuntu@stand:~$
free -h
ubuntu@stand:~$
               total        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 и свои данные.

ubuntu@stand:~$
mkdir ~/gitlab
cd ~/gitlab

Узнай адрес стенда в локальной сети — он понадобится в настройках. Флаг -br у ip значит «коротко» (brief): одна строка на интерфейс.

ubuntu@stand:~$
ip -br a
ubuntu@stand:~$
lo               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 на новую мажорную версию без спроса.

nano ~/gitlab/compose.yaml
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.

дописать в compose.yaml
    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.

дописать в compose.yaml
    volumes:
      - ./config:/etc/gitlab      # настройки и пароль root
      - ./logs:/var/log/gitlab    # журналы всех служб
      - ./data:/var/opt/gitlab    # репозитории, база, образы

Самый ценный каталог — data: в нём всё, что ты создашь в GitLab. Удалишь его — начнёшь с чистого листа.

Шаг 6. Настройки GitLab

Последний кусок — настройки самого GitLab. Они пишутся строками Ruby в переменную GITLAB_OMNIBUS_CONFIG; знак | в YAML значит «дальше многострочный текст». Без двух строк GitLab не заработает как надо — с них и начнём.

дописать в compose.yaml
    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) — молчит, если всё в порядке.

ubuntu@stand:~$
docker compose config -q

Пустой вывод — хороший знак. Ошибка отступа выглядит так: yaml: line 9: did not find expected key.

Шаг 7. Запустить и подождать

Поднимаем GitLab в фоне, флаг -d — отцепиться от терминала. Образ весит около 1,5 ГБ, первая загрузка займёт пару минут.

ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 2/2
 ✔ Network gitlab_default  Created
 ✔ Container gitlab        Started

«Started» значит только «контейнер запущен». Внутри GitLab ещё минут пять настраивает себя — ставит базу, создаёт таблицы. За этим следит встроенная проверка здоровья.

ubuntu@stand:~$
docker compose ps
ubuntu@stand:~$
NAME     IMAGE                            STATUS
gitlab   gitlab/gitlab-ce:19.4.3-ce.0   Up 2 minutes (health: starting)

health: starting — GitLab ещё просыпается. Повторяй команду раз в минуту, пока не появится (healthy). Колонки здесь сокращены, у тебя их будет больше.

Если ждать скучно, посмотри, что он делает. Флаг --tail 5 — последние пять строк журнала.

ubuntu@stand:~$
docker compose logs --tail 5 gitlab
ubuntu@stand:~$
gitlab  | Recipe: gitlab::database_migrations
gitlab  |   * bash[migrate gitlab-rails database] action run
gitlab  | ...
gitlab  | gitlab Reconfigured!

Строка gitlab Reconfigured! — настройка закончена. Через минуту-другую после неё статус станет healthy.

Шаг 8. Пароль root

При первом запуске GitLab сам придумывает пароль администратора root и кладёт его в файл внутри контейнера.

ubuntu@stand:~$
docker exec gitlab cat /etc/gitlab/initial_root_password
ubuntu@stand:~$
# 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 — один снимок вместо бегущей таблицы.

ubuntu@stand:~$
docker stats --no-stream gitlab
ubuntu@stand:~$
CONTAINER 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:

дописать в GITLAB_OMNIBUS_CONFIG
        puma['worker_processes'] = 0
        sidekiq['concurrency'] = 10
        prometheus_monitoring['enable'] = false

Первая оставляет веб-сервер Puma в одном процессе, вторая сужает очередь фоновых задач Sidekiq, третья выключает встроенный мониторинг — свой у нас уже есть. Полный список — в статье о работе в ограниченной памяти. Настройки окружения читаются только при создании контейнера, поэтому up -d его пересоздаст, данные в томах не пострадают.

ubuntu@stand:~$
docker compose up -d
ubuntu@stand:~$
[+] Running 1/1
 ✔ Container gitlab  Recreated

Подожди (healthy) и ещё пару минут и повтори замер.

ubuntu@stand:~$
docker stats --no-stream gitlab
ubuntu@stand:~$
CONTAINER ID   NAME     CPU %   MEM USAGE / LIMIT     MEM %
3c1f9a2b7d44   gitlab   1.53%   2.585GiB / 7.7GiB     33.6%

Вдвое меньше. Это и есть честная цена своего GitLab на стенде. А что внутри живо, показывает gitlab-ctl status — запускаем его в контейнере через docker exec.

ubuntu@stand:~$
docker exec gitlab gitlab-ctl status
ubuntu@stand:~$
run: 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:

дописать в compose.yaml
    restart: unless-stopped

Примени тем же docker compose up -d. Если ты остановишь GitLab сам, следующий шаг, он останется остановленным и после перезагрузки — так и задумано.

Шаг 13. Погасить, когда не нужен

Когда закончишь на сегодня, останови GitLab — освободишь два с половиной гигабайта для других разделов.

ubuntu@stand:~$
docker compose stop
ubuntu@stand:~$
[+] Stopping 1/1
 ✔ Container gitlab  Stopped

Данные остались в ~/gitlab/data. Запустить обратно — docker compose start, и снова подождать healthy три-пять минут. Перед сдачей практики запусти его и дождись здоровья: проверка смотрит на живой GitLab.

Шаг 14. Сдать

Выполни команду сдачи из блока ниже. Она покажет статус контейнера, строки настроек из compose.yaml и ответ страницы входа.

Практика 01+525 XP

Поставить настоящий GitLab CE в Docker Compose, найти пароль root, войти в интерфейс и понимать, сколько памяти он забирает и как его гасить.

  • Контейнер GitLab здоров
  • Адрес задан IP-адресом стенда
  • Puma урезана
  • Встроенный мониторинг выключен
  • Страница входа отвечает
Команда сдачи — выполни на своей машине
команда
cd ~/gitlab; docker compose ps gitlab; grep -E 'external_url|worker_processes|prometheus_monitoring' compose.yaml; curl -s -o /dev/null -w 'HTTP=%{http_code}\n' http://localhost:8929/users/sign_in

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