diff --git a/README.md b/README.md index 1f7a341..59b078e 100644 --- a/README.md +++ b/README.md @@ -19,21 +19,24 @@ so I'm able to do everything I want that way. How To Set This Up ------------------ -1. Go get a runner registration token from your forgejo/gitea instance. -2. Decide in advance what tags you want to use. - Don't use the default tags, or it will think you want docker. - `big-builder,go,python3,hugo` isn't an awful choice. -3. Run the code block below. -4. Email me to let me know if these instructions worked for you! +1. Generate an example configuration, and edit it. + Be sure to set tags here: + I use something like `big-builder,go,python3,hugo`, + and then I can say things like `requires: hugo` in my jobs. +2. Go get a runner registration token from your forgejo/gitea instance. +3. Run the interactive registation step. +4. Run the daemon. +5. Email me to let me know if these instructions worked for you! ```sh mkdir /srv/big-builder -docker run --rm -it -u 0:0 -v /srv/big-builder:/app big-builder # This will ask you 3 questions -docker run -d --restart=always -v /srv/big-builder:/app:ro big-builder daemon +podman run --rm big-builder generate-config > /srv/big-builder/config.yaml # This generates a sample config +vim /srv/big-builder/config.yaml # Edit the config to your liking +podman run --rm -it -u 0:0 -v /srv/big-builder:/app big-builder register # Tags here are overridden by config.yaml +podman run -d --restart=always -v /srv/big-builder:/app:ro big-builder daemon ``` -On my raspberry pi, -I used the tags `aarch64,big-builder,go,python3,hugo`. +Docker can be used instead of podman, with the same arguments. More documentation is at [gitea act runner](https://docs.gitea.com/usage/actions/act-runner). @@ -50,8 +53,9 @@ FROM git.woozle.org/neale/big-builder RUN apt-get -y install nethack ``` -Even better, steal this one's Dockerfile and add stuff to it. -You shouldn't trust my image to be malware-free. +Even better, steal this one's Containerfile and add stuff to it. +There's not much to it, and +you shouldn't trust my image to be malware-free. Caveats @@ -65,3 +69,5 @@ This is a problem with the runner that they might fix one day. Just something to bear in mind: I spent a bit of time chasing this one down. +I may have additional bugs/wishlist items open at +https://git.woozle.org/neale/big-builder/issues