13.4.2. Регистрация Runner

⁠13.4.2. Регистрация Runner

Для регистрации Runner используется команда:

forgejo-runner register

Команда запускает интерактивный мастер настройки, в котором необходимо указать:

URL сервера Forgejo;
токен регистрации Runner;
имя Runner;
метки (labels), определяющие типы заданий, которые может выполнять Runner.

Пример регистрации:

# cd /var/lib/forgejo-runner/
# forgejo-runner register

Диалог мастера настройки:

INFO Registering runner, arch=amd64, os=linux, version=v12.10.1.
INFO No configuration file specified; using default settings.
INFO Enter the Forgejo instance URL (for example, https://next.forgejo.org/):
http://192.168.0.206:3000
INFO Enter the runner token:
0SO7Fb3m4ldmvvBdT88ZyRrudh9Oo8U7KmIPq1zj
INFO Enter the runner name (if set empty, use hostname: host-203):
my-runner
INFO Enter the runner labels, leave blank to use the default labels (comma-separated, for example, ubuntu-20.04:docker://node:20-bookworm,ubuntu-18.04:docker://node:20-bookworm,alt-latest:docker://registry.altlinux.org/alt/node:latest,alt-p10:docker://registry.altlinux.org/alt/node:p10,alt-sisyphus:docker://registry.altlinux.org/alt/node:sisyphus):
alt-latest:docker://registry.altlinux.org/alt/node:latest
INFO Registering runner, name=my-runner, instance=http://192.168.0.203:3000, labels=[alt-latest:docker://registry.altlinux.org/alt/node:latest].
DEBU Successfully pinged the Forgejo instance server
INFO Runner registered successfully

Runner можно зарегистрировать без запуска интерактивного мастера:

# forgejo-runner register --no-interactive \
  --instance http://192.168.0.206:3000 \
  --name my-runner \
  --token 0SO7Fb3m4ldmvvBdT88ZyRrudh9Oo8U7KmIPq1zj \
  --label alt-latest:docker://registry.altlinux.org/alt/node:latest

После успешной регистрации в текущем каталоге создается файл .runner. Он содержит параметры подключения Runner:

{
  "WARNING": "This file is automatically generated by forgejo-runner. Do not edit it manually unless you know what you are doing. Removing this file will cause act runner to re-register as a new runner.",
  "id": 1,
  "uuid": "17a153e7-9a4a-4102-99fb-482e112189d5",
  "name": "my-runner",
  "token": "0SO7Fb3m4ldmvvBdT88ZyRrudh9Oo8U7KmIPq1zj",
  "address": "http://192.168.0.206:3000",
  "labels": [
    "alt-latest:docker://registry.altlinux.org/alt/node:latest"
  ]
}

Файл .runner создается автоматически. Не рекомендуется изменять его вручную. Удаление файла приводит к необходимости повторной регистрации Runner.