Files
kayobe/doc/source/configuration/reference/os-distribution.rst
Pierre Riteau f23cb602df Support CentOS Stream 10 and Rocky Linux 10 images
This bumps the jriguera.configdrive role to the latest commit to support
generating a configdrive with xorriso instead of genisoimage.

Depends-On: https://review.opendev.org/c/openstack/kayobe-config-dev/+/962548

Change-Id: Ia2881915531a74414cda44b676167cf9360c55b7
Signed-off-by: Pierre Riteau <pierre@stackhpc.com>
2025-09-30 11:51:14 +02:00

1.5 KiB

OS Distribution

As of the Wallaby 10.0.0 release, Kayobe supports multiple Operating System (OS) distributions. See the support matrix <support-matrix-supported-os> for a list of supported OS distributions. The same OS distribution should be used throughout the system.

The os_distribution variable in etc/kayobe/globals.yml can be used to set the OS distribution to use. It may be set to either centos or or rocky or ubuntu, and defaults to rocky.

The os_release variable in etc/kayobe/globals.yml can be used to set the release of the OS. When os_distribution is set to centos it may be set to 9-stream or 10-stream, and 9-stream is its default value. When os_distribution is set to rocky it may be set to 9 or 10, and 9 is its default value. When os_distribution is set to ubuntu it may be set to noble, and this is its default value.

These variables are used to set various defaults, including:

  • Bootstrap users
  • Overcloud host root disk image build configuration
  • Seed VM root disk image
  • Kolla base container image

Example: using Ubuntu

In the following example, we set the OS distribution to ubuntu:

os_distribution: "ubuntu"

Example: using Rocky

In the following example, we set the OS distribution to rocky:

os_distribution: "rocky"