You can interact directly with your builds by connecting to the runner over SSH. This is helpful for troubleshooting your manifests, or just getting a quick temporary environment to test something in.
When a build fails, the VM stays alive for an extra ten minutes, and you'll be presented with instructions on how to connect to the runner via SSH, e.g.:
$ ssh -t builds@azusa.runners.sr.ht connect 81809
Connected to build job #81809 (failed):
https://builds.sr.ht/jobs/~sircmpwn/81809
Your VM will be terminated 4 hours from now, or when you log out.
bash-5.0 $
In addition to connecting to failed builds over SSH, you can add shell: true
to your manifest to always enable SSH access. Then,
you'll be able to interact with your build as it runs.
commit 96d1f5b90650f055dfc866f4d341b03bf9d20c40 Author: Rens Oliemans <hallo@rensoliemans.nl> Date: 2025-01-15T15:05:17+01:00 git.sr.ht/index: fix hut link