48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# Gitea actions in rootless docker containers
|
|
|
|
This package configures a rootless docker instance owned by the `docker-rootless` user
|
|
to enable gitea actions in a non-root docker environment.
|
|
|
|
## Post-installation steps
|
|
|
|
You have to start and register the docker instance with Gitea:
|
|
|
|
```bash
|
|
systemctl -M gitea-runner-rootless@ --user enable --now dockerd-rootless-user
|
|
/usr/share/gitea-runner/register-rootless.sh
|
|
systemctl -M gitea-runner-rootless@ --user enable --now gitea-runner-rootless
|
|
```
|
|
|
|
You will be asked to input:
|
|
|
|
1. Gitea instance URL, like `http://192.168.8.8:3000/`. You should use your gitea instance ROOT_URL as the instance argument and you should not use `localhost` or `127.0.0.1` as instance IP;
|
|
2. Runner token, you can get it from `http://192.168.8.8:3000/admin/actions/runners`;
|
|
3. Runner name, you can just leave it blank;
|
|
4. Runner labels, you can just leave it blank.
|
|
|
|
Apart from registering the docker instance, the script also produces a default config file in the `/home/gitea-runner-rootless/runner` directory.
|
|
|
|
### Configuration
|
|
|
|
The runner can be configured with a configuration file.
|
|
The systemd user service file expects the file to be `/home/gitea-runner/runner/config.yaml`.
|
|
The registration script generates a default config file with the `envs:` and `labels:` values removed in the above-mentioned directory.
|
|
|
|
> **NB**: The value of `labels:` in the config file, if they are specified, override any labels configured during registration on the next startup.
|
|
|
|
The log level is set to debug, to assist first setup and should be changed to `info` during normal operation.
|
|
|
|
The configuration file is a YAML file, which can also generated as a sample configuration file with `gitea-runner generate-config`.
|
|
|
|
```bash
|
|
cd ~gitea-runner-rootless/runner
|
|
gitea-runner generate-config > config.yaml
|
|
chown gitea-runner-rootless:gitea-runner-rootless config.yaml
|
|
chmod 0640 config.yaml
|
|
```
|
|
|
|
> **NB**: The generated config file has the default values of `labels:`, which override any labels configured during registration on the next startup. There are also some default `envs:` values, that result in environment variables in all runs.
|
|
|
|
## Uninstallation
|
|
If you uninstall the package, you need to manually remove the registration in the Gitea UI and remove the /home/gitea-runner-rootless directory, if required.
|