kayobe/doc/source/configuration/reference/os-distribution.rst
Mark Goddard dfdff656f5 Ubuntu: add documentation & release note
Change-Id: I3c4d81f59bb61fdd23234777b8d839adecfe86f2
Story: 2004960
Task: 42324
2021-05-05 10:26:31 +01:00

1.2 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 ubuntu, and defaults to centos.

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 8-stream, and this is its default value. When os_distribution is set to ubuntu it may be set to focal, 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"