techknowlogick 4f79577a9f Reviewed-on: #25 Co-authored-by: techknowlogick <techknowlogick@gitea.com> Co-committed-by: techknowlogick <techknowlogick@gitea.com>
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://docker.gitea.com/runner-images:ubuntu-latest" - "ubuntu-22.04:docker://docker.gitea.com/runner-images:ubuntu-22.04" - "ubuntu-20.04:docker://docker.gitea.com/runner-images:ubuntu-20.04" container: # ... force_pull: true # ... - Restart your runner.