kayobe/doc/source/configuration/reference/os-distribution.rst
Jakub Darmach e72688ff11 Add support for Ubuntu Noble Numbat (24.04) LTS
Depends-On: https://review.opendev.org/c/openstack/kolla-ansible/+/925581
Change-Id: Id9d90f424a5b0f7eedd1a11512bb8b72abba8959
2024-10-16 14:58:03 +02:00

49 lines
1.5 KiB
ReStructuredText

.. _os-distribution:
===============
OS Distribution
===============
As of the Wallaby 10.0.0 release, Kayobe supports multiple Operating System
(OS) distributions. See the :ref:`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``, and this is its default value. When ``os_distribution`` is
set to ``ubuntu`` it may be set to ``noble``, and this is its default value.
When ``os_distribution`` is set to ``rocky`` it may be set to ``9``, 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``:
.. code-block:: yaml
:caption: ``globals.yml``
os_distribution: "ubuntu"
Example: using Rocky
====================
In the following example, we set the OS distribution to ``rocky``:
.. code-block:: yaml
:caption: ``globals.yml``
os_distribution: "rocky"