foster/forgejo-docs
0
0
Fork 0
mirror of https://codeberg.org/forgejo/docs.git synced 2024-11-24 18:09:26 -05:00
Code Issues Activity

docs: admin: actions notes on sudo & bookworm

Browse source
This commit is contained in:
Earl Warren 2023-05-29 14:46:48 +02:00 committed by Caesar Schinas
parent a7bd5b74b6
commit 207689f5e8
No known key found for this signature in database
GPG key ID: AE9108461BEA5ACF
1 changed files with 6 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
admin/actions.md
View file

@ -1,6 +1,6 @@
---
layout: '~/layouts/Markdown.astro'
title: 'Forgejo Actions'
title: 'Forgejo Actions administrator guide'
license: 'CC-BY-SA-4.0'
---
@ -35,7 +35,7 @@ For jobs to run in containers, the `Forgejo runner` needs access to [Docker](htt
### LXC
For jobs to run in LXC containers, the `Forgejo runner` needs passwordless sudo access on a Debian GNU/Linux bookworm system where [LXC](https://linuxcontainers.org/lxc/) is installed. The [LXC helpers](https://code.forgejo.org/forgejo/lxc-helpers/) can be used as follows to create a suitable container:
For jobs to run in LXC containers, the `Forgejo runner` needs passwordless sudo access for all `lxc-*` commands on a Debian GNU/Linux `bookworm` system where [LXC](https://linuxcontainers.org/lxc/) is installed. The [LXC helpers](https://code.forgejo.org/forgejo/lxc-helpers/) can be used as follows to create a suitable container:
```shell
$ git clone https://code.forgejo.org/forgejo/lxc-helpers
@ -43,6 +43,8 @@ $ ./lxc-helpers/lxc-helpers.sh lxc_container_create myrunner
$ ./lxc-helpers/lxc-helpers.sh lxc_container_start myrunner
```
> **NOTE:** Multiarch [Go](https://go.dev/) builds and [binfmt](https://github.com/tonistiigi/binfmt) need `bookworm` to produce and test binaries on a single machine for people who do not have access to dedicated hardware. If this is not needed, installing the `Forgejo runner` on `bullseye` will also work.
The `Forgejo runner` can then be installed and run within the `myrunner` container.
```shell
@ -97,7 +99,7 @@ INFO[0000] Starting runner daemon
Adding the `.forgejo/workflows/demo.yaml` file to the test repository:
```
```yaml
on: [push]
jobs:
test:
@ -137,4 +139,4 @@ If `runs-on` is matched to a label that contains `docker://`, the rest of it is
### LXC
If `runs-on` is `self-hosted`, the runner will execute all the steps, as root, within a Debian GNU/Linux bullseye LXC container.
If `runs-on` is `self-hosted`, the runner will execute all the steps, as root, within a Debian GNU/Linux `bullseye` LXC container.