54 lines
6.4 KiB
Markdown
54 lines
6.4 KiB
Markdown
# Runner Images
|
|
|
|
|
|
|
|
|
|
Official docker images used by [act_runner](https://gitea.com/gitea/act_runner) to run workflows.
|
|
|
|
You can find the images on [gitea/runner-images](https://hub.docker.com/r/gitea/runner-images).
|
|
|
|
Currently, we have not chosen to build the image ourselves, as [catthehacker/docker_images](https://github.com/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](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-latest&ordering=-name) | `catthehacker/ubuntu:act-latest` |  |  |
|
|
| [ubuntu-22.04](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-22.04&ordering=-name) | `catthehacker/ubuntu:act-22.04` |  |  |
|
|
| [ubuntu-20.04](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-20.04&ordering=-name) | `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](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-latest-slim&ordering=-name) | `node:20-bookworm-slim` |  |  |
|
|
| [ubuntu-22.04-slim](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-22.04-slim&ordering=-name) | `node:20-bookworm-slim` |  |  |
|
|
| [ubuntu-20.04-slim](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-20.04-slim&ordering=-name) | `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](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-latest-full&ordering=-name) | `catthehacker/ubuntu:full-latest` |  |  |
|
|
| [ubuntu-22.04-full](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-22.04-full&ordering=-name) | `catthehacker/ubuntu:full-22.04` |  |  |
|
|
| [ubuntu-20.04-full](https://hub.docker.com/r/gitea/runner-images/tags?name=ubuntu-20.04-full&ordering=-name) | `catthehacker/ubuntu:full-20.04` |  |  |
|