kayobe/doc/source/configuration/reference/os-distribution.rst
Bartosz Bezak 2f447f6545 Move to Rocky Linux 9
CentOS Stream 8 support has been dropped. Migration path will be present
in Yoga release - as a followup change.

MichaelRigart.interfaces does not support custom routes for
NetworkManager yet. It has been disabled in CI for Rocky Linux 9
temporarily.

Non-voting CentOS Stream 9 CI overcloud job is using RL9 container
images (as kolla CI is not building CS9 images anymore).

Change-Id: Idf5ee822b03ba40179803c981500a6bad37594bf
2022-12-12 22:24:47 +01: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 ``jammy``, 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"