GitLab уже стоит, но конвейеры в нём выполнять некому. Сейчас ты поставишь раннер — в тот же Compose, рядом с GitLab, — и зарегистрируешь его так, как это делают в 2026 году: через токен из интерфейса.
Убедись, что GitLab запущен: docker compose ps в ~/gitlab показывает (healthy).
Шаг 1. Сервис раннера
Раннер — такой же контейнер, поэтому описываем его вторым сервисом в ~/gitlab/compose.yaml. Допиши в конец файла, с отступом на уровне gitlab:.
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 работают из каталога с описанием.
cd ~/gitlabdocker compose up -d runner[+] Running 1/1 ✔ Container gitlab-runner Started
docker compose logs --tail 3 runnergitlab-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 даёт нормальный терминал.
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 добавляет ещё одно искомое слово.
sudo grep -e url -e executor -e volumes runner/config.tomlurl = "http://192.168.1.50:8929" executor = "docker" volumes = ["/cache"]
sudo нужен, потому что файл создал root внутри контейнера. Строка volumes — тома, которые раннер подключит в каждый контейнер задачи; сейчас там только кеш. Для проверок этого хватает, а что добавить, когда задаче понадобится собирать образы, — в практике про сборку.
Шаг 6. Проверить связь
Команда verify спрашивает у GitLab, знает ли он этот раннер.
docker exec gitlab-runner gitlab-runner verifyVerifying runner... is valid runner=t3_AbCdEis valid — GitLab узнал токен. Если видишь is not valid — раннер удалили в интерфейсе или токен вставлен с ошибкой: создай раннер заново.
Шаг 7. Первая задача
Проверим раннер в деле самым маленьким конвейером. Конвейер описывается файлом .gitlab-ci.yml в корне репозитория — подробно о нём в следующем уроке, а пока одна задача из трёх строк. Сделаем её в отдельной ветке.
cd ~/infra git switch -c ci/hello
hello: script: - echo "привет от $CI_RUNNER_DESCRIPTION"
hello — имя задачи, script — команды. $CI_RUNNER_DESCRIPTION — переменная, которую GitLab сам подставляет в каждую задачу: описание раннера.
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.
git switch main git push gitlab --delete ci/hello
Локальную ветку тоже удалим, флаг -D удаляет её без вопросов о слиянии.
git branch -D ci/helloDeleted branch ci/hello (was 7c3d9e1).Шаг 10. Сдать
Выполни команду сдачи: она проверит связь раннера с GitLab и покажет главные строки его настроек.