Skip to content

Commit dd16a18

Browse files
committed
Add section about Python 3.12 prerequisite
From Epoxy, Python 3.12 is required for Ansible control host.
1 parent f23ea32 commit dd16a18

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

doc/source/operations/upgrading-openstack.rst

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -353,6 +353,42 @@ After the queue migration is finished, upgrade RabbitMQ to 4.1.
353353
354354
kayobe kolla ansible run "rabbitmq-upgrade 4.1"
355355
356+
Python 3.12
357+
-----------
358+
359+
From OpenStack 2025.1, Kayobe and Kolla-Ansible requires Python 3.12.
360+
361+
Ubuntu 24.04 has default Python of version 3.12.
362+
You can find the upgrade procedure from :ref:`upgrading-to-ubuntu-noble`
363+
364+
For Rocky Linux 9, install Python 3.12 manually.
365+
366+
.. code-block:: bash
367+
368+
dnf install python3.12
369+
370+
For both Operating Systems, Kayobe and Kolla-Ansible Python virtual environments
371+
created with older Python version will not work with OpenStack 2025.1.
372+
Create new Kayobe Python virtual environment with Python 3.12.
373+
374+
.. code-block:: bash
375+
376+
# Ubuntu 24.04
377+
python3 -m venv venvs/kayobe
378+
379+
# Rokcy Linux 9 need to specify python3.12 as it is not the default
380+
python3.12 -m venv venvs/kayobe
381+
382+
Activate Kayobe Python virtual environment then Install Kayobe.
383+
384+
.. code-block:: bash
385+
386+
source venvs/kayobe/bin/activate
387+
pip install -r $KAYOBE_CONFIG_PATH/../../requirements.txt
388+
389+
Run ``kayobe control host bootstrap`` to populate Kolla-Ansible Python virtual
390+
environment and bootstrap Ansible control host.
391+
356392
Preparation
357393
===========
358394

0 commit comments

Comments
 (0)