mirror of https://github.com/kubernetes-sigs/kubespray.git synced 2026-03-19 09:57:37 -02:30

Files

Kay Yan 6ce0a1c18e docs: add README for test-infra/image-builder (#13106 )

Document the KubeVirt image build process used by Kubespray CI,
including prerequisites, usage instructions, and how to add new
OS images.

Ref: https://github.com/kubernetes-sigs/kubespray/issues/12383

Made-with: Cursor

Signed-off-by: Kay Yan <kay.yan@daocloud.io>

2026-03-19 08:48:30 +05:30

roles/kubevirt-images

Docs: add rockylinux-10-extra description

2026-01-03 00:52:30 +08:00

cluster.yml

Resolve ansible-lint name errors (#10253 )

2023-07-26 07:36:22 -07:00

hosts.ini

Minor changes

2019-01-03 15:41:31 +01:00

Makefile

Add image builder to create Docker vm's for kube-virt

2019-01-03 15:34:37 +01:00

OWNERS

Cleanup OWNERS files in each folders (#11892 )

2025-01-15 12:10:34 -08:00

README.md

docs: add README for test-infra/image-builder (#13106 )

2026-03-19 08:48:30 +05:30

README.md

KubeVirt Image Builder

Build and push KubeVirt VM disk images to quay.io for Kubespray CI testing.

How It Works

The Ansible playbook downloads upstream cloud images, converts them to qcow2, resizes (+8G), wraps each in a Docker image based on kubevirt/registry-disk-v1alpha, and pushes to quay.io/kubespray/vm-<os-name>:<tag>.

Prerequisites

Docker, qemu-img, Ansible
Push access to quay.io/kubespray (robot account kubespray+buildvmimages)

Image Definitions

All OS images are defined in roles/kubevirt-images/defaults/main.yml.

Each entry specifies:

Field	Description
`filename`	Downloaded file name
`url`	Upstream cloud image URL
`checksum`	Checksum for download verification
`converted`	`true` if the source is already qcow2, `false` if conversion is needed
`tag`	Docker image tag (usually `latest`)

Usage

Build and push all images

cd test-infra/image-builder/
make docker_password=<quay-robot-token>

Add a new OS image

Add a new entry to roles/kubevirt-images/defaults/main.yml:

new-os-name:
  filename: cloud-image-file.qcow2
  url: https://example.com/cloud-image-file.qcow2
  checksum: sha256:<hash>
  converted: true
  tag: "latest"

Build and push the image:

make docker_password=<quay-robot-token>

Submit a PR with the defaults/main.yml change so CI can use the new image. See #12379 for an example.