Official Gitea Actions runner images

Go to file

Lunny Xiao 6d16b62977 Some checks failed release / release-slim (push) Successful in 1m13s Details release / release-full (push) Failing after 53m21s Details release / release-default (push) Failing after 3h14m56s Details Add license (#9 ) Reviewed-on: #9		2024-04-07 02:56:11 +00:00
.gitea/workflows	fix: use right tags	2024-04-02 14:07:35 +08:00
dockerfiles	fix: copy full images	2024-04-02 11:56:11 +08:00
CONTRIBUTING.md	Add license (#9 )	2024-04-07 02:56:11 +00:00
DCO	Add license (#9 )	2024-04-07 02:56:11 +00:00
LICENSE	Add license (#9 )	2024-04-07 02:56:11 +00:00
README.md	Add Migration to README (#5 )	2024-04-02 07:37:24 +00:00

README.md

Runner Images

Official docker images used by act_runner to run workflows.

You can find the images on gitea/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.

Images

Here are three types of images: "default", "slim", and "full".

Default images

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

Tag	Base	Size	Version
ubuntu-latest	`catthehacker/ubuntu:act-latest`
ubuntu-22.04	`catthehacker/ubuntu:act-22.04`
ubuntu-20.04	`catthehacker/ubuntu:act-20.04`

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.

Tag	Base	Size	Version
ubuntu-latest-slim	`node:20-bookworm-slim`
ubuntu-22.04-slim	`node:20-bookworm-slim`
ubuntu-20.04-slim	`node:20-bullseye-slim`

Full images

Full images are based on catthehacker/ubuntu:full-*, which contains all tools provided by GitHub Actions runners. They have huge sizes, but are useful if you need to run workflows in a GitHub Actions compatible environment. Please note that full images support amd64 architecture only.

Tag	Base	Size	Version
ubuntu-latest-full	`catthehacker/ubuntu:full-latest`
ubuntu-22.04-full	`catthehacker/ubuntu:full-22.04`
ubuntu-20.04-full	`catthehacker/ubuntu:full-20.04`

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:

Ensure your Gitea's version is v1.21.0 or later.
Ensure your act_runner's version is v0.2.9 or later.

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

# ...

runner:
  # ...
  labels:
    - "ubuntu-latest:docker://gitea/runner-images:ubuntu-latest"
    - "ubuntu-22.04:docker://gitea/runner-images:ubuntu-22.04"
    - "ubuntu-20.04:docker://gitea/runner-images:ubuntu-20.04"

container:
  # ...
  force_pull: true

# ...

Restart your runner.