Provision
—— XP

Практика: раннер рядом с GitLab

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

GitLab уже стоит, но конвейеры в нём выполнять некому. Сейчас ты поставишь раннер — в тот же Compose, рядом с GitLab, — и зарегистрируешь его так, как это делают в 2026 году: через токен из интерфейса.

Убедись, что GitLab запущен: docker compose ps в ~/gitlab показывает (healthy).

Шаг 1. Сервис раннера

Раннер — такой же контейнер, поэтому описываем его вторым сервисом в ~/gitlab/compose.yaml. Допиши в конец файла, с отступом на уровне gitlab:.

дописать в ~/gitlab/compose.yaml
  runner:
    image: gitlab/gitlab-runner:v19.4.1
    container_name: gitlab-runner
    restart: unless-stopped
    volumes:
      - ./runner:/etc/gitlab-runner
      - /var/run/docker.sock:/var/run/docker.sock

Первый том — каталог для config.toml, чтобы регистрация пережила пересоздание контейнера. Второй — сокет Docker хоста: через него раннер запускает контейнеры для задач. Версию раннера берут из той же ветки, что у GitLab: у нас GitLab 19.4, и раннер тоже 19.4. Последнее число у них своё, раннер выпускается отдельно, поэтому 19.4.3 у GitLab и 19.4.1 у раннера — правильная пара.

Шаг 2. Запустить раннер

Поднимаем только новый сервис — GitLab трогать не нужно. Команды Compose работают из каталога с описанием.

ubuntu@stand:~$
cd ~/gitlab
ubuntu@stand:~$
docker compose up -d runner
ubuntu@stand:~$
[+] Running 1/1
 ✔ Container gitlab-runner  Started
ubuntu@stand:~$
docker compose logs --tail 3 runner
ubuntu@stand:~$
gitlab-runner  | Runtime platform    arch=amd64 os=linux pid=7 revision=3c39fceb version=19.4.1
gitlab-runner  | Starting multi-runner from /etc/gitlab-runner/config.toml...  builds=0 max_builds=0

arch=amd64 — процессор стенда. На Mac с M1–M3 стенд работает на ARM, и там будет arch=arm64: это нормально, образы раннера и GitLab есть под обе архитектуры. max_builds=0 честно говорит: раннер запущен, но работать пока не на кого — он ни к чему не привязан.

Шаг 3. Создать раннер в интерфейсе

Новый способ регистрации начинается в GitLab. Открой проект devops/infra → Settings → CI/CD → раздел Runners → Expand → New project runner.

Заполни форму. Tags — docker. Поставь галочку Run untagged jobs: тогда раннер возьмёт и задачи без тегов. Runner description — stand-docker. Нажми Create runner.

GitLab покажет страницу с токеном вида glrt-t3_AbCdEf... и готовой командой. Токен показывается один раз — не закрывай страницу, пока не закончишь следующий шаг.

Шаг 4. Зарегистрировать

Запускаем регистрацию внутри контейнера раннера. Флаги -it у docker exec нужны для диалога: -i держит ввод открытым, -t даёт нормальный терминал.

ubuntu@stand:~$
docker exec -it gitlab-runner gitlab-runner register

Раннер задаст пять вопросов. Ответы — справа:

диалог регистрации
Enter the GitLab instance URL:  http://192.168.1.50:8929
Enter the registration token:   glrt-t3_AbCdEf...
Enter a name for the runner:    stand-docker
Enter an executor:              docker
Enter the default Docker image: alpine:3.20
Runner registered successfully.

Адрес — тот же, что external_url, с IP, а не localhost. Образ по умолчанию нужен для задач, у которых не указан image. Строка Runner registered successfully — готово.

Вернись в браузер и нажми View runners. Рядом со stand-docker горит зелёный кружок: раннер на связи.

Шаг 5. Посмотреть config.toml

Всё, что ты ответил, раннер записал в файл. Посмотрим главные строки: каждый флаг -e у grep добавляет ещё одно искомое слово.

ubuntu@stand:~$
sudo grep -e url -e executor -e volumes runner/config.toml
ubuntu@stand:~$
  url = "http://192.168.1.50:8929"
  executor = "docker"
    volumes = ["/cache"]

sudo нужен, потому что файл создал root внутри контейнера. Строка volumes — тома, которые раннер подключит в каждый контейнер задачи; сейчас там только кеш. Для проверок этого хватает, а что добавить, когда задаче понадобится собирать образы, — в практике про сборку.

Шаг 6. Проверить связь

Команда verify спрашивает у GitLab, знает ли он этот раннер.

ubuntu@stand:~$
docker exec gitlab-runner gitlab-runner verify
ubuntu@stand:~$
Verifying runner... is valid    runner=t3_AbCdE

is valid — GitLab узнал токен. Если видишь is not valid — раннер удалили в интерфейсе или токен вставлен с ошибкой: создай раннер заново.

Шаг 7. Первая задача

Проверим раннер в деле самым маленьким конвейером. Конвейер описывается файлом .gitlab-ci.yml в корне репозитория — подробно о нём в следующем уроке, а пока одна задача из трёх строк. Сделаем её в отдельной ветке.

ubuntu@stand:~$
cd ~/infra
git switch -c ci/hello
nano ~/infra/.gitlab-ci.yml
hello:
  script:
    - echo "привет от $CI_RUNNER_DESCRIPTION"

hello — имя задачи, script — команды. $CI_RUNNER_DESCRIPTION — переменная, которую GitLab сам подставляет в каждую задачу: описание раннера.

ubuntu@stand:~$
git add .gitlab-ci.yml
git commit -m "ci: проверка раннера"
git push -u gitlab ci/hello

Флаг -m задаёт сообщение коммита, -u у push связывает ветку с сервером.

Шаг 8. Прочитать журнал задачи

Открой проект → Build → Pipelines. Сверху новый конвейер по ветке ci/hello. Нажми на него, затем на задачу hello. Откроется журнал — главное место разбора любой красной сборки.

начало журнала задачи
Running with gitlab-runner 19.4.1 (3c39fceb)
  on stand-docker t3_AbCdE, system ID: s_9f8e7d6c5b4a
Preparing the "docker" executor
Using docker image alpine:3.20 ...
Getting source from Git repository
Fetching changes with git depth set to 20...
echo "привет от $CI_RUNNER_DESCRIPTION"
привет от stand-docker
Job succeeded

Читай сверху вниз. Вторая строка — на каком раннере шла задача. Четвёртая — в каком образе. Getting source — раннер склонировал репозиторий в контейнер задачи. Строки с $ — твои команды, под ними их вывод. Job succeeded — код возврата 0.

Если задача упала на Getting source с ошибкой Failed to connect to localhost port 8929, значит в external_url стоит localhost: контейнер задачи ищет GitLab у самого себя.

Шаг 9. Убрать пробную ветку

Пробный конвейер своё отработал. Удалим ветку на сервере — флаг --delete у push.

ubuntu@stand:~$
git switch main
git push gitlab --delete ci/hello

Локальную ветку тоже удалим, флаг -D удаляет её без вопросов о слиянии.

ubuntu@stand:~$
git branch -D ci/hello
ubuntu@stand:~$
Deleted branch ci/hello (was 7c3d9e1).

Шаг 10. Сдать

Выполни команду сдачи: она проверит связь раннера с GitLab и покажет главные строки его настроек.

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

Поднять свой раннер с исполнителем docker, зарегистрировать его новым способом через токен из интерфейса и прочитать журнал первой выполненной задачи.

  • Раннер на связи с GitLab
  • Раннер ходит на IP стенда
  • Исполнитель docker
Команда сдачи — выполни на своей машине
команда
docker exec gitlab-runner gitlab-runner verify 2>&1 | tail -2; docker exec gitlab-runner grep -E 'url|executor' /etc/gitlab-runner/config.toml

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