Provision
—— XP

Инструменты: отладка конвейера и шпаргалка

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

Этот урок — карманный: сюда возвращаются, когда что-то сломалось или забылась команда. Сначала быстрая отладка своего GitLab и раннера, потом шпаргалка на каждый день, потом инструменты, которые ловят ошибки конвейера до push.

Всё здесь ты уже видел в практиках раздела, просто собрано в одном месте.

Быстрая отладка: что сломалось

Когда конвейер «не работает», причина почти всегда на одном из трёх этажей: сам GitLab, раннер или диск стенда. Эти пять команд проходят их сверху вниз.

в каталоге ~/gitlab
docker compose ps                         # GitLab и раннер живы? healthy?
docker exec gitlab gitlab-ctl status      # какая служба GitLab лежит
docker compose logs --tail 50 runner      # что раннер пишет об ошибках
docker exec gitlab-runner gitlab-runner verify  # GitLab знает раннер?
docker system df                          # сколько диска съели образы

Страница 502 в браузере — GitLab просыпается или упала служба: первые две команды. Задача висит в pending — раннер не на связи или теги не совпали: третья и четвёртая. Сборка падает с no space left on device — пятая: раннер с проброшенным сокетом копит образы на диске стенда.

Флаг --tail 50 — последние пятьдесят строк журнала.

А если упала сама задача — открой её журнал и читай с конца: последняя строка с $ — команда, на которой всё остановилось, под ней её ошибка.

Шпаргалка раздела

Команды, которые нужны чаще всего.

на каждый день
docker compose start                      # поднять GitLab после паузы
docker compose stop                       # погасить, освободить ~6 ГБ
docker stats --no-stream gitlab           # сколько он ест сейчас
git push -u gitlab ci/my-change           # отправить ветку на ревью
git log --merges -1 --format=%B           # последнее слияние и номер MR
docker image prune -a --filter until=72h  # чистка старых образов
docker builder prune                      # чистка кеша сборки

Флаги знакомы по практикам: --no-stream — один снимок вместо бегущей таблицы, -u у push — связать ветку с сервером, --merges и --format=%B у log — только слияния и полное сообщение. Флаг -a у image prune удаляет все неиспользуемые образы, а --filter until=72h оставляет те, что моложе трёх суток. Запускай чистку, когда docker system df показывает гигабайты в колонке RECLAIMABLE.

Отдельно про сохранность. Резервную копию GitLab делает docker exec gitlab gitlab-backup create: она ложится в ~/gitlab/data/backups. Файлы gitlab.rb и gitlab-secrets.json из ~/gitlab/config в неё не входят — их копируют рядом, иначе бэкап не восстановится.

Проверить до push

Самая дорогая привычка — править .gitlab-ci.yml, отправлять и ждать минуту, чтобы узнать об опечатке. Есть два способа узнать раньше.

Pipeline editor в GitLab (Build → Pipeline editor) проверяет синтаксис и показывает, какие задачи попадут в конвейер, — прямо в браузере, ничего ставить не надо. Там же вкладка Visualize рисует граф по needs.

gitlab-ci-local — программа, которая выполняет задачи .gitlab-ci.yml на твоей машине в тех же образах. Ставится через npm, а дальше:

в каталоге репозитория
gitlab-ci-local --list      # какие задачи есть, ничего не запуская
gitlab-ci-local yaml-lint   # прогнать одну задачу у себя

Он не знает про раннеры, защищённые переменные и события merge request, поэтому настоящий GitLab не заменяет. Но опечатку в команде находит за секунды. Для GitHub Actions то же самое делает act.

Когда проектов станет несколько, конвейеры начнут повторяться. Для этого есть include — подключить кусок описания из другого файла или репозитория — и extends — унаследовать общую часть задачи. Здесь достаточно знать, что такое есть: понадобится, когда у тебя будет второй проект.

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

Pipeline editor
Редактор конвейера в GitLab: проверяет синтаксис и показывает граф до запуска. ↩ к тексту
gitlab-ci-local
Программа, которая выполняет задачи .gitlab-ci.yml на своей машине. ↩ к тексту
gitlab-backup
Команда резервной копии GitLab. Секреты из config копируют отдельно.
include
Подключение куска конвейера из другого файла или репозитория.

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

  • Конвейер падает только на сервере, у себя всё работает. Что проверить?
    Образ задачи, доступные переменные и защищённость ветки, теги раннера, доступ раннера к сети. Локально этого не воспроизвести — поэтому журнал задачи читают с конца.
  • Что входит в резервную копию GitLab?
    gitlab-backup сохраняет базу, репозитории и загрузки. Файлы gitlab.rb и gitlab-secrets.json копируют отдельно — без второго не расшифровать переменные CI/CD.

Что дальше

Раздел закончен. Дальше — Ansible: та же идея «описать и применить», только для настройки самих серверов.

Проверь себя+210 XPдве попытки
1
Быстрая отладка
Задача висит в pending. С какой команды начать?
2
Быстрая отладка
Сборки начали падать с «no space left on device». Что посмотреть?
3
До push
Как проверить .gitlab-ci.yml до отправки?
ответь на все вопросы, чтобы проверить

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