Regularly built VM images for FreeIPA testing, published to this repository's container registry.
A scheduled GitHub Actions workflow takes the upstream cloud image of each
release listed in images.yaml, brings it up to date (Fedora:
with updates-testing), installs a FreeIPA server on it with
ci-freeipa, and only if that passes
pushes the image to ghcr.io/<owner>/<repo>/<image>. A broken update never
reaches the registry.
Entries that share a name with different arch are merged into one
multi-arch manifest list, and one preset ref
(containerdisk:ghcr.io/.../fedora-45:latest) then works on both host
architectures. aarch64 members are built for Fedora rawhide and the
current release only; older releases keep their x86_64-only tag.
The images are containerdisks: a FROM scratch image that holds one file,
/disk/disk.qcow2. ci-freeipa pulls one with podman, copies the disk out, and
boots VMs from it:
# a ci-freeipa preset
vm:
backend: qemu
image: containerdisk:ghcr.io/freeipa/ci-freeipa-vm-images/fedora-45:latest| Step | Script | |
|---|---|---|
| Fetch | scripts/fetch-image.sh |
newest upstream image of the release and arch; SHA-256 checked against the upstream checksum file |
| Update | scripts/update-image.sh |
boots it under qemu/KVM of the image's arch, runs the update command, records the packages it changed, cleans the guest (cloud-init state, ssh keys and host keys, machine id, caches), flattens and compresses it. Skipped for an entry without update |
| Test | ci-freeipa | scripts/render-preset.py writes a one-server preset; freeipa-env up installs the distro FreeIPA packages in a VM started from the image; run executes ipatests' TestInstallMaster::test_install_master. Skipped for an entry without update |
| Publish | scripts/publish.sh |
builds the containerdisk, labels it, pushes :<date>-<arch> |
| Merge | scripts/merge-manifests.sh |
one manifest job per run: merges the per-arch tags into the multi-arch :latest and :<date> |
Each (image, arch) in images.yaml is one matrix job, so a failing release
does not stop the others. An image marked experimental may fail without
failing the workflow. The per-arch job runs on a runner of its own arch; the
manifest job then publishes latest from the arches that succeeded, keeping
the previous member (by digest) for an arch that did not.
The upstream sources are dl.fedoraproject.org (Fedora Cloud Base Generic;
not the download. redirector, whose mirrors lag and answer 404) and
cloud.centos.org (CentOS Stream GenericCloud).
- Push this repository to GitHub and enable Actions.
- Nothing to configure for publishing: the workflow uses the repository's
GITHUB_TOKENwithpackages: write. The first publish creates the package as private and links it to the repository (the image carriesorg.opencontainers.image.source). Make the package public in its settings if others should pull it without a login. - The test checks out
freeipa/ci-freeipaatmain. To use another, set the repository variablesCI_FREEIPA_REPOandCI_FREEIPA_REF. - The schedule is in
.github/workflows/build.yml(cron, Mondays 03:17 UTC). Every run pushes about one image per release, so a daily schedule uses registry storage quickly.
Run it by hand from the Actions tab: Build and publish VM images >
Run workflow. only names images (fedora-45), and publish can be
switched off for a dry run. A pull request builds and tests fedora-45 only,
and publishes nothing.
Edit images.yaml; one entry is one image.
| Field | |
|---|---|
name |
the image name in the registry; entries that share it become one multi-arch tag |
distro, release |
fedora and a release number, or centos and a Stream major version |
arch |
x86_64 (default) or aarch64: the upstream image, the runner and the manifest member |
update |
the command that updates the VM. Optional: without it the fetched image is published as it is (no update, no test) |
guest_packages |
what the test installs (a ci-freeipa vm.guest_packages) |
experimental |
a failure does not fail the workflow |
Tags: an (image, arch) job pushes YYYYMMDD-<arch>; the manifest job merges
them into the multi-arch latest and YYYYMMDD. The image labels record the
upstream file and its SHA-256 and the update command, and the SHA-256 of the
disk.
On a machine with KVM, qemu, xorriso and podman:
scripts/fetch-image.sh fedora 45 work # add aarch64 for the arm image
. work/base.env
scripts/update-image.sh "$BASE_FILE" work/image.qcow2 \
'dnf -y --refresh --enablerepo=updates-testing upgrade' work/report
scripts/render-preset.py --name fedora-45 --image "$PWD/work/image.qcow2" > work/preset.yaml
~/src/ci-freeipa/env/freeipa-env up work/preset.yaml
~/src/ci-freeipa/env/freeipa-env run work/preset.yaml
~/src/ci-freeipa/env/freeipa-env down work/preset.yaml
scripts/publish.sh work/image.qcow2 localhost/fedora-45:test # add --push to pushscripts/matrix.py prints the job matrix;
MATRIX="$(scripts/matrix.py)" REPO=$USER/images scripts/merge-manifests.sh REGISTRY merges per-arch tags into multi-arch lists (any registry works;
ghcr.io is the default); python3 -m pytest tests runs the checks (they
need podman and qemu-img for the publish tests and skip without).
- The test installs FreeIPA from the stable repositories. The image has
updates-testingapplied, so the packages it already holds are the newer ones, but FreeIPA itself comes fromfedoraandupdates. Testing afreeipabuild fromupdates-testingneeds that repository enabled in the test VM; the workflow does not do it. - CentOS Stream has no
updates-testing. Its update is the latest Stream content. Its entries use theipa-distro-elpackage set and need a ci-freeipa that has it. Rawhide isexperimental: it breaks now and then. - aarch64 members are the pristine upstream image. The GitHub arm
runners have no
/dev/kvm(and no nested virtualization), so the update and the FreeIPA test cannot run there; entries withoutupdatepublish the checksum-verified upstream image, markedexperimental. Giving aarch64 the same update-and-test lane needs a KVM-capable arm runner (self-hosted, or GitHub enabling KVM there). - A GitHub-hosted runner needs
/dev/kvmfor the update and test steps only (an entry withoutupdateruns neither). The workflow enables KVM with a udev rule and fails with a clear message when the runner has none. - The image keeps the upstream partition layout, grown to 20 GB so that the
update has room. A VM started from it needs a disk of at least 20 GB: in
ci-freeipa that is
vm.disk(default 40G), which grows the filesystem to match. ci-freeipa refuses a smallervm.disk; a smaller overlay would cut the end of the image off and the VM would not boot.