Skip to content

Commit bbed8b8

Browse files
committed
Add playbook and kayobe automation breaking change info
Added more detail about two breaking changes on Epoxy. 1. Any playbook reference other than symlinks can break with new subdirectories of playbooks. 2. Kayobe Automation image needs to be rebuilt with Python 3.12.
1 parent e0d1d6d commit bbed8b8

File tree

1 file changed

+16
-1
lines changed

1 file changed

+16
-1
lines changed

doc/source/operations/upgrading-openstack.rst

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ For example:
132132
enabled: "{{ seed_pulp_container_enabled | bool }}"
133133
134134
Ansible playbook subdirectories
135-
--------------------------------------
135+
-------------------------------
136136

137137
The playbooks under ``etc/kayobe/ansible`` have been subdivided into different
138138
categories to make them easier to navigate. This change may result in merge
@@ -147,6 +147,10 @@ To mitigate the impact of these changes, two scripts have been added:
147147
* ``tools/magic-symlink-fix.sh`` - Uses the previous script to attempt to fix
148148
any broken symlinks in the kayobe configuration.
149149

150+
If playbooks are referenced in different methods other than symlinks, they'll
151+
need to manually resolved by operators. (e.g. Shell scripts running playbooks
152+
with file paths, ``import_playbook`` command in custom playbooks)
153+
150154
Known issues
151155
============
152156

@@ -370,6 +374,17 @@ You can find more information from the :ref:`beokay` documentation.
370374
For Rocky Linux 9, ``beokay create`` must be used with the ``--python python3.12``
371375
option to specify Beokay to use Python 3.12 as it is not the default.
372376

377+
For CI, Kayobe Automation image also needs to be rebuilt with Python 3.12.
378+
When building Kayobe Automation image, use argument ``USE_PYTHON_312``.
379+
380+
For example:
381+
382+
.. code:: bash
383+
384+
docker build $KAYOBE_CONFIG_PATH/../../.automation/docker/kayobe/Dockerfile \
385+
-t kayobe:latest \
386+
-e USE_PYTHON_312=true
387+
373388
Preparation
374389
===========
375390

0 commit comments

Comments
 (0)