ContainerImage.ActRunnerExtended/README.md

ContainerImage.ActRunnerExtended

This image extends catthehacker/ubuntu:act-24.04 by including the following utilities:

• File templating
  • gettext (provides envsubst)
• ISO creation
  • genisoimage (generate cloud-init seed images)
• VM image building
  • qemu-system-x86
  • qemu-utils (provides qemu-img)
• VM image filesystem access
  • supermin (prerequisite)
  • libguestfs-tools (provides guestfish, virt-sparsify, etc)

It’s designed for use in self-hosted act-runners, to operate in environments similar to local QEMU/KVM-based pipelines.

---

Usage in an Actions Workflow

To use this image in a job/step, add the container: directive:

jobs:
  build-vm:
    runs-on: ubuntu-latest
    container:
      image: code.spamasaurus.com/djpbessems/act-runner-extended:1.0.0-cth250815
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Build virtual disk image
        run: |
          qemu-img create -f qcow2 disk.qcow2 2G
          # other build steps here

---

Available Tags

Tags follow the format:

<semver>-cth<YYMMDD>

Example:

• 1.0.0-cth250815 → Version 1.0.0 of the image, based on catthehacker/ubuntu:act-24.04-20250815
  See catthehacker/ubuntu

Browse available tags

---

License

This repository and the Dockerfiles, scripts, and custom files provided here are licensed under the GNU General Public License v3.0 (GPLv3).

The included packages are licensed under free software licenses compatible with GPLv3, including GPLv2, LGPL, and related licenses. This license applies only to the custom files and Docker configurations you find in this repository, not to the upstream base image or the precompiled binaries installed within the image.

Please refer to the individual package documentation and upstream repositories for their specific licensing terms.