Этот урок — карманный: сюда возвращаются, когда что-то сломалось или забылась команда. Сначала быстрая отладка своего GitLab и раннера, потом шпаргалка на каждый день, потом инструменты, которые ловят ошибки конвейера до push.
Всё здесь ты уже видел в практиках раздела, просто собрано в одном месте.
Быстрая отладка: что сломалось
Когда конвейер «не работает», причина почти всегда на одном из трёх этажей: сам 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 — пятая: раннер с проброшенным сокетом копит образы на диске стенда.
А если упала сама задача — открой её журнал и читай с конца: последняя строка с $ — команда, на которой всё остановилось, под ней её ошибка.
Шпаргалка раздела
Команды, которые нужны чаще всего.
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 — унаследовать общую часть задачи. Здесь достаточно знать, что такое есть: понадобится, когда у тебя будет второй проект.
Словарь урока
Что спросят на собеседовании
- Конвейер падает только на сервере, у себя всё работает. Что проверить?Образ задачи, доступные переменные и защищённость ветки, теги раннера, доступ раннера к сети. Локально этого не воспроизвести — поэтому журнал задачи читают с конца.
- Что входит в резервную копию GitLab?gitlab-backup сохраняет базу, репозитории и загрузки. Файлы gitlab.rb и gitlab-secrets.json копируют отдельно — без второго не расшифровать переменные CI/CD.
Что дальше
Раздел закончен. Дальше — Ansible: та же идея «описать и применить», только для настройки самих серверов.