Images

Operating System Images

The Cluster API driver for Magnum relies on specific OpenStack images containing all necessary dependencies for deploying Kubernetes clusters. These images are pre-configured with Kubernetes binaries, container runtimes, networking components, and other required software.

Building Images

The images used by the Cluster API driver for Magnum are built using the vexxhost/capo-image-elements project. This project provides a comprehensive and flexible framework for constructing Kubernetes-specific images.

You can find pre-built images by this project in the vexxhost/capo-image-elements releases. For Ubuntu 24.04 images, use the ubuntu-24.04-v<kubernetes-version>.qcow2 assets and upload them to Glance with --property os_distro=ubuntu.

Deprecated legacy builder

The following is kept documented for the sakes of archiving however this is a deprecated way that uses the image-builder project. This is not supported and the magnum-cluster-api-image-builder is slated to be removed.

The images used by the Cluster API driver for Magnum are built using the kubernetes-sigs/image-builder project. This project provides a comprehensive and flexible framework for constructing Kubernetes-specific images.

In order to simplify the process of building images, the Cluster API driver for Magnum provides a small Python utility which wraps the image-builder project.

To build the images, run the following command:

$ pip install magnum-cluster-api
$ magnum-cluster-api-image-builder --version v1.26.2

In the example above, this command will build the images for Kubernetes version v1.26.2. The --version flag is optional and defaults to v1.26.2.