openstack/tripleo-docs
Code Issues Proposed changes

Update docs for CentOS9

Browse Source 
We still suggest installing on CentOS 8 Stream. This wouldn't be
expected to work as we have moved to CentOS Stream 9 (aka. CentOS 9)
for master now. This patch updates our install guide for CentOS 9.

Note that there are still remaining reference to CentOS 8 Stream, but
this change aims to fix what we can fix easily now.

Change-Id: Icb8c584e1a62278ca2d8239a83f603c2e90ec03a
This commit is contained in:
Brendan Shephard 2022-11-02 15:13:36 +10:00 committed by Takashi Kajinami
parent aa74a99b02
commit 48eaf4cc33
7 changed files with 41 additions and 56 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
deploy-guide/source/deployment/3rd_party.rst
View File

@ -293,7 +293,7 @@ Configure Kolla to build images for TripleO, in `/etc/kolla/kolla-build.conf`::
registry=192.168.24.1:8787
tag=latest
template_override=/usr/share/tripleo-common/container-images/tripleo_kolla_template_overrides.j2
rpm_setup_config=http://trunk.rdoproject.org/centos7/current-tripleo/delorean.repo,http://trunk.rdoproject.org/centos7/delorean-deps.repo
rpm_setup_config=http://trunk.rdoproject.org/centos9/current-tripleo/delorean.repo,http://trunk.rdoproject.org/centos9/delorean-deps.repo
push=True
Use the following command to build all of the container images used in TripleO::
@ -302,10 +302,6 @@ Use the following command to build all of the container images used in TripleO::
--config-file /usr/share/tripleo-common/container-images/overcloud_containers.yaml \
--kolla-config-file /etc/kolla/kolla-build.conf
.. note:: Add --use-buildah argument to use Buildah instead of Docker.
It'll be the default once CentOS8 becomes the testing platform during the Train cycle
and onward.
Or use `kolla-build` to build the images yourself, which provides more
flexibility and allows you to rebuild selectively just the images matching
a given name, for example to build only the heat images with the TripleO

8
deploy-guide/source/deployment/architecture.rst
View File

@ -32,11 +32,9 @@ containerized stateful services, like the messaging system or database.
.. _Containerd: https://github.com/containerd/containerd
.. _Bundle: https://wiki.clusterlabs.org/wiki/Bundle_Walk-Through
Currently we provide a ``ContainerCli`` parameter which can be used to switch
between podman and docker container runtimes. The default for the undercloud
is podman, while the default for the overcloud is docker due to pacemaker
limitations when running under CentOS 7. We expect to switch to podman by
default for the overcloud once CentOS 8 becomes the default.
Currently we provide a ``ContainerCli`` parameter which can be used to change
the container runtimes, but only podman is supported for both undercloud and
overcloud.
We have provided various ``Container*`` configuration parameters in TripleO
Heat Templates for operators to tune some of the container based settings.

47
deploy-guide/source/deployment/install_overcloud.rst
View File

@ -56,7 +56,7 @@ Get Images
delete the older images and restart the process from this step.
Alternatively, images are available via RDO at
https://images.rdoproject.org/centos8/master/rdo_trunk/ which offers images from both the
https://images.rdoproject.org/centos9/master/rdo_trunk/ which offers images from both the
CentOS Build System (cbs) and RDO Trunk (called rdo_trunk or delorean).
However this mirror is slow so if you experience slow download speeds
you should skip to building the images instead.
@ -85,35 +85,35 @@ created on the undercloud, one should use a non-root user.
.. admonition:: CentOS
:class: centos
The image build with no arguments will build CentOS 7. It will include the
The image build with no arguments will build CentOS 8. It will include the
common YAML of
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml``
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml``
and the CentOS YAML at
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos7.yaml``.
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml``.
.. admonition:: CentOS 8
:class: centos8
.. admonition:: CentOS 9
:class: centos9
The default YAML for Centos 8 is
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml``
The default YAML for Centos 9 is
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml``
::
export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos8.yaml"
export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml"
.. admonition:: RHEL
:class: rhel
The common YAML is
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml``.
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml``.
It must be specified along with the following.
The default YAML for RHEL is
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel7.yaml``
``/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel8.yaml``
::
export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel7.yaml"
export OS_YAML="/usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel8.yaml"
#. Install the ``current-tripleo`` delorean repository and deps repository:
@ -134,8 +134,8 @@ created on the undercloud, one should use a non-root user.
export DIB_YUM_REPO_CONF="$DIB_YUM_REPO_CONF /etc/yum.repos.d/tripleo-centos-ceph*.repo"
.. admonition:: CentOS 8
:class: centos8
.. admonition:: CentOS 9
:class: centos9
::
@ -235,20 +235,25 @@ created on the undercloud, one should use a non-root user.
..
.. admonition:: RHEL
:class: rhel
.. admonition:: RHEL 9
:class: rhel9
::
openstack overcloud image build --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images.yaml --config-file $OS_YAML
openstack overcloud image build \
--config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml \
--config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-rhel9.yaml \
--config-file $OS_YAML
.. admonition:: CentOS 8
:class: centos8
.. admonition:: CentOS 9
:class: centos9
::
openstack overcloud image build --config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml --config-file $OS_YAML
openstack overcloud image build \
--config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-python3.yaml \
--config-file /usr/share/openstack-tripleo-common/image-yaml/overcloud-images-centos9.yaml \
--config-file $OS_YAML
See the help for ``openstack overcloud image build`` for further options.

14
deploy-guide/source/deployment/tips_tricks.rst
View File

@ -15,20 +15,6 @@ Prior to Stein, containerized OpenStack deployments used Docker.
Starting with the Stein release, Docker is no longer part of OpenStack,
and Podman has taken its place. The notes here are regarding Stein and later.
sudo
----
On CentOS 7, podman cannot function with administrative privileges due to
user namespaces not being enabled in an older kernel. The workaround is
simply to run podman commands with sudo as a prefix.
If you see the following, simply remember to add sudo to your command::
$ podman ps
cannot clone: Invalid argument
user namespaces are not enabled in /proc/sys/user/max_user_namespaces
ERRO[0000] cannot re-exec process
Monitoring containers
---------------------

6
deploy-guide/source/environments/baremetal.rst
View File

@ -39,8 +39,8 @@ in its glance, one time in /var/lib subdirectories for PXE/TFTP).
TripleO is supporting only the following operating systems:
* RHEL 8 (x86_64)
* CentOS8 Stream (x86_64)
* RHEL 9 (x86_64)
* CentOS Stream 9 (x86_64)
Please also ensure your node clock is set to UTC in order to prevent any issue
when the OS hwclock syncs to the BIOS clock before applying timezone offset,
@ -87,7 +87,7 @@ Setting Up The Undercloud Machine
#. Select a machine within the baremetal environment on which to install the
undercloud.
#. Install RHEL 8 x86_64 or CentOS 8 Stream x86_64 on this machine.
#. Install RHEL 9 x86_64 or CentOS Stream 9 x86_64 on this machine.
#. If needed, create a non-root user with sudo access to use for installing the
Undercloud::

6
deploy-guide/source/features/deploy_cellv2_manage_cell.rst
View File

@ -73,7 +73,8 @@ Delete a compute from a cell
.. code-block:: bash
sudo yum install python2-osc-placement
sudo dnf install python3-osc-placement
source overcloudrc
openstack resource provider list
+--------------------------------------+---------------------------------------+------------+
| uuid | name | generation |
@ -152,11 +153,10 @@ Delete a cell
This step is required as otherwise adding a compute node with the same hostname
will make it to fail to register as a resource with the placement service.
In case of Centos/RHEL 8 the required packages is `python3-osc-placement`:
.. code-block:: bash
sudo yum install python2-osc-placement
sudo dnf install python3-osc-placement
source overcloudrc
openstack resource provider list
+--------------------------------------+---------------------------------------+------------+

10
deploy-guide/source/repositories.rst
View File

@ -2,19 +2,19 @@
.. note::
Python3 is required for current releases of OpenStack which is
supported on CentOS Stream 8.
supported on CentOS Stream 9.
#. Download and install the python-tripleo-repos RPM from
the appropriate RDO repository
.. admonition:: CentOS Stream 8
:class: centos8
.. admonition:: CentOS Stream 9
:class: centos9
Current `Centos 8 RDO repository <https://trunk.rdoproject.org/centos8/component/tripleo/current/>`_.
Current `Centos 9 RDO repository <https://trunk.rdoproject.org/centos9/component/tripleo/current/>`_.
.. code-block:: bash
sudo dnf install -y https://trunk.rdoproject.org/centos8/component/tripleo/current/python3-tripleo-repos-<version>.el8.noarch.rpm
sudo dnf install -y https://trunk.rdoproject.org/centos9/component/tripleo/current/python3-tripleo-repos-<version>.el9.noarch.rpm
.. note::