13.4.5. Автоматическая (offline) регистрация Runner

⁠13.4.5. Автоматическая (offline) регистрация Runner

При автоматизированном развертывании Forgejo и Runner (например, с помощью Ansible или Kubernetes) можно использовать регистрацию без интерактивного режима.

На сервере Forgejo создается секрет:

$ forgejo forgejo-cli actions register \
  --name runner-name \
  --scope organization \
  --secret <40-символьный-секрет>

На сервере Runner создается файл регистрации:

$ forgejo-runner create-runner-file \
  --instance http://192.168.0.206:3000 \
  --secret <40-символьный-секрет>

Секрет должен состоять из 40 шестнадцатеричных символов.

Секрет содержит:

первые 16 символов используются как идентификатор runner;
оставшиеся 24 символа являются секретной частью токена.

Пример:

Создание секрета:

# su - forgejo
$ forgejo forgejo-cli actions register \
  --name my-runner-auto \
  --scope alt-docs \
  --secret 7c31591e8b67225a116d4a4519ea8e507e08f71f

Вывод:

37633331-3539-3165-3862-363732323561

Создание файла регистрации:

# forgejo-runner create-runner-file \
  --instance http://192.168.0.206:3000 \
  --secret 7c31591e8b67225a116d4a4519ea8e507e08f71f

Вывод:

WARN[0000] create-runner-file has been deprecated; declare connections in the runner configuration instead
INFO[0000] Creating runner fil
INFO[0000] No configuration file specified; using default settings.
INFO[0000] Runner name is empty, use hostname 'platform'.

Повторный запуск команды регистрации на стороне Forgejo (с идентификатором Runner) позволяет изменить секрет существующего Runner:

$ forgejo forgejo-cli actions register \
  --name my-runner-auto \
  --scope alt-docs \
  --secret 7c31591e8b67225a84e8e06633b9578e793664c3