Building Images for MaaS

The image is built using the KVM hypervisor (QEMU).

Building Images

The build prerequisites for using image-builder to create QEMU images are installed with:

cd image-builder
make deps-qemu

Building a MaaS Image

From the image-builder directory, run:

make build-maas-ubuntu-xxxx-efi

The image will be located in images/capi/output/BUILD_NAME+kube-KUBERNETES_VERSION. Replace xxxx with 2204 or 2404, depending on the Ubuntu version.

To build a Ubuntu 22.04-based CAPI image:

git clone https://github.com/kubernetes-sigs/image-builder.git
cd image-builder
make build-qemu-ubuntu-2204-efi

Uploading to MaaS

Prerequisites

Ubuntu 22.04 (required for the MaaS client)
Command-line MaaS client installed

Installing the MaaS Client

apt update && apt install -y tzdata software-properties-common
apt-add-repository -y ppa:maas/3.5
apt install -y maas-cli python3-openssl

Logging into MaaS

maas login admin <MAAS_HTTP_ENDPOINT>/MAAS/ '<TOKEN>'

Creating a Token

Log into the MaaS interface, go to your preferences (your username), click “API Keys,” and copy an existing key or generate a new one.

Uploading the Image

Navigate to images/capi/output/, find the generated image, and enter its directory. Inside, you will see two files:

cd images/capi/output/ubuntu-2204-efi-kube-v1.30.5/

ls -l
total 7165084
-rw-r--r-- 1 vasartori vasartori 5132255232 Feb 25 08:33 ubuntu-2204-efi-kube-v1.30.5
-rw-r--r-- 1 root      root      2203701699 Feb 25 08:33 ubuntu-2204-efi-kube-v1.30.5.tar.gz

Use the .tar.gz file for the upload:

maas admin boot-resources create name=custom/your-image architecture=amd64/generic title=your-image subarches=generic base_image=ubuntu/jammy content@=./ubuntu-2204-efi-kube-v1.30.5.tar.gz

Note: Set base_image=ubuntu/jammy for Ubuntu 22.04 or ubuntu/noble for 24.04.

The Image Builder Book