How to configure runner storage
To prevent GitHub Action job from exhausting the disk IO of the juju machine hosting the charm, the charm provides two storage options to be configured as the LXD instance root disk:
- Random access memory as disk
- Storage provided by juju
This is configured with the runner-storage option. The configuration should be set during deployment and cannot be changed.
Random access memory as disk
The random access memory of the juju machine is configured as LXD storage and used as the root disk for the LXD instances.
The runner-storage configuration needs to be set to memory during deployment, and the juju machine constraints should have enough memory for the virtual machine memory and disk. See Managing resource usage.
An example deployment:
juju deploy github-runner --constraints="cores=4 mem=16G root-disk=20G virt-type=virtual-machine" --config token=<TOKEN> --config path=<OWNER/REPO> --config runner-storage=memory --config vm-memory=2GiB --config vm-disk=10GiB
Storage provided by juju
The juju storage needs to be mounted during deployment, and the runner-storage configuration should be set to juju-storage during deployment.
An example deployment:
juju deploy github-runner --constraints="cores=4 mem=6G root-disk=30G virt-type=virtual-machine" --config token=<TOKEN> --config path=<OWNER/REPO> --config runner-storage=juju-storage --config vm-memory=2GiB --config vm-memory=10GiB --storage runner=rootfs
The above example uses rootfs, which is using the root disk of the juju machine. Hence the root-disk size was increase to 30G.