doc: actions/act-runner: document running as a systemd service

[nodiscc]

This documents running act-runner as a systemd service under a dedicated user account.

[nodiscc]

I would link to the specific issue on https://gitea.com/gitea/act_runner/issues/ requesting this, but gitea.com has been extremely slow for a few days, to the point of being unusable. Is this a known problem?

Edit: https://gitea.com/gitea/act_runner/issues/379

[techknowlogick]

@nodiscc if you're comfortable saying, which continent are you located on, and what timezone/time of day are you accessing Gitea.com? I'm running operations for gitea.com and so your feedback is helpful/appreciated :)

[lng2020]

Is there a particular concern to use - instead of _? Because the binary name is act_runner, if use -, then it is required to change its name.

[lunny]

It should be act_runner

[nodiscc]

which continent are you located on, and what timezone/time of day are you accessing Gitea.com

Europe, GMT+1. I just issued a request to https://gitea.com/gitea/act_runner/issues/nonexisting, if that helps you look through the logs (page load took 13s, https://gitea.com/assets/js/index.js?v=1.22.0~dev-233-g796ff26e0 didn't load at all, timeout)

Is there a particular concern to use - instead of _

Most executables from Debian packages use - instead of _, all user/group names use -, also _ is considered a word separator by many programs/editors, for consistency I always use - in file names unless there is a good reason.

$ ls /usr/bin/ | grep '\-' | wc -l
620
$ ls /usr/bin/ | grep '_' | grep -v x86|wc -l
105
$ grep '\-' /etc/passwd|wc -l
9
$ grep _ /etc/passwd | wc -l
0

Do you still want me to change it? Which parts (executable name? directory names? user name?)

[silverwind]

I personally find - more common and friendly than _ and would even go as far as renaming the act_runner project to act-runner. I we check repos in https://gitea.com/gitea, it is certainly an exception from our repo naming schemes.

BTW if we use it for more than just a actions runner, a new name would be good as well. Maybe gitea-runner or gitea-worker.

[techknowlogick]

Using - instead of _ has implications on text selection and copy/paste. By using _ in the binary name, it means when people double click on a part of the string for copying from docs etc, they will get the full act_runner instead of either just act or runner.

Regardless of which is better to use, as the built binary name uses _ right now, I recommend that the docs should use that to stay consistent.

(thanks for the docs PRs btw, they are very appreciated 😄 )

[lunny]

Yes, we can have other PRs to discuss/do the renaming. But currently, please keep consistent on this PR.

[nodiscc]

Changed all occurrences of act-runner to act_runner.