mirror of
https://codeberg.org/forgejo/docs.git
synced 2024-11-24 18:09:26 -05:00
admin: more details about action runner offline registration (#769)
This PR - adds more details regarding the nature of the secret used when registering runners offline using `forgejo-cli actions register`, - explains how to change the secret for an existing runner ([Forgejo PR #4619](https://codeberg.org/forgejo/forgejo/pulls/4619)), - explains how to keep the Forgejo-side command idempotent if the labels aren't known ([Forgejo PR #4610](https://codeberg.org/forgejo/forgejo/pulls/4610)) Reviewed-on: https://codeberg.org/forgejo/docs/pulls/769 Reviewed-by: twenty-panda <twenty-panda@noreply.codeberg.org> Co-authored-by: Emmanuel BENOÎT <tseeker@nocternity.net> Co-committed-by: Emmanuel BENOÎT <tseeker@nocternity.net>
This commit is contained in:
parent
46a3f68002
commit
65f556b638
1 changed files with 20 additions and 0 deletions
|
@ -339,6 +339,26 @@ The `Forgejo runner` needs to connect to a `Forgejo` instance and must be regist
|
||||||
--secret 7c31591e8b67225a116d4a4519ea8e507e08f71f
|
--secret 7c31591e8b67225a116d4a4519ea8e507e08f71f
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The secret must be a 40-character long string of hexadecimal numbers.
|
||||||
|
The first 16 characters will be used as an identifier for the runner, while
|
||||||
|
the rest is the actual secret. It is possible to update the secret of an
|
||||||
|
existing runner by running the command again on the Forgejo machine, with
|
||||||
|
the last 24 characters updated.
|
||||||
|
|
||||||
|
For instance, the command below would change the secret set by the previous
|
||||||
|
command:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
$ forgejo forgejo-cli actions register --name runner-name --scope myorganization \
|
||||||
|
--secret 7c31591e8b67225a84e8e06633b9578e793664c3
|
||||||
|
# ^^^^^^^^^^^^^^^^ This part is identical
|
||||||
|
```
|
||||||
|
|
||||||
|
The registration command on the Forgejo side is mostly idempotent, with the
|
||||||
|
exception of the runner labels. If the command is run without `--labels`, they
|
||||||
|
will be reset, and the runner won't set them back until it is restarted. The
|
||||||
|
`--keep-labels` option can be used to preserve the existing labels.
|
||||||
|
|
||||||
### Configuration
|
### Configuration
|
||||||
|
|
||||||
The default configuration for the runner can be
|
The default configuration for the runner can be
|
||||||
|
|
Loading…
Reference in a new issue