michaelsasser89/runner-images repository overview

⁠Runner Images

Our official docker images used by our act_runner⁠ instance to run workflows.

You can find the images on michaelsasser89/runner-images⁠.

Currently, we have not chosen to build the image ourselves, as catthehacker/docker_images⁠ has done an excellent job of this. We don't need to reinvent the wheel.

Images are built from catthehacker/ubuntu:* or node:*. Additional packages will be installed if they are needed by act_runner or often used by us.

⁠Images

Here are two types of images: "default" and "slim".

⁠Default images

Default images are based on catthehacker/ubuntu:rust-*, and are used by default in act_runner. They contain most of the tools we need to run workflows and are always recommended if your runner is not disk-space constrained.

We have added the following additional packages:

• Base Image - catthehacker/ubuntu:rust-*
  • Rust: rustup, cargo, rustc, rust-analyzer, clippy, rustfmt, rustdoc
• APT
  • python3-openssl
  • python3-socks
  • python3-docker
  • python3-dockerpty
  • yamllint
  • pnpm
  • rye
• APT - ppa:ansible/ansible
  • ansible (ansible, ansible-lint, ansible-test)
• rye
  • poetry
  • git-cliff
  • pre-commit
  • tox

⁠Slim images

Slim images are based on node:20-*-slim. They contain Node.js to run basic workflows and set up more development tools if needed. Their size is much smaller, which is friendly to disk-space constrained runners.

⁠Migration

If you have already installed a runner which uses node:16-* or node:20-* as default images, you can migrate to the new images by following the steps:

1. Ensure your Gitea's version is v1.21.0 or later.

2. Ensure your act_runner's version is v0.2.9 or later.

3. Update your runner's configuration file like config.yaml:

   # ...
   
   runner:
     # ...
     labels:
       # Default Images
       - "ubuntu-latest:docker://michaelsasser89/runner-images:ubuntu-latest"
       - "ubuntu-22.04:docker://michaelsasser89/runner-images:ubuntu-22.04"
       # Slim Images
       - "ubuntu-latest-slim:docker://michaelsasser89/runner-images:ubuntu-latest-slim"
       - "ubuntu-22.04-slim:docker://michaelsasser89/runner-images:ubuntu-22.04-slim"
   
   container:
     # ...
     force_pull: true
   # ...
   

   Copy

4. Restart your runner.