Skip to content

Add playbook and kayobe automation breaking change info #1977

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: stackhpc/2025.1
Choose a base branch
from
Open

Add playbook and kayobe automation breaking change info #1977

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4e17510
Add playbook and kayobe automation breaking change info
seunghun1ee Nov 11, 2025
c189f2b
Reword to add equal guidance to GitLab CI users
seunghun1ee Nov 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion doc/source/operations/upgrading-openstack.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ For example:
enabled: "{{ seed_pulp_container_enabled | bool }}"

Ansible playbook subdirectories
--------------------------------------
-------------------------------

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

If playbooks are referenced in different methods other than symlinks, they'll
need to be manually resolved by operators. (e.g. Shell scripts running
playbooks with file paths, ``import_playbook`` command in custom playbooks)

Known issues
============

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

Kayobe Automation
~~~~~~~~~~~~~~~~~

For deployments using Kayobe Automation CI, the Kayobe Docker image also needs
to be rebuilt with Python 3.12. In GitHub, run the ``Build Kayobe Docker
Image`` workflow. In GitLab, run the ``build_kayobe_image`` pipeline. In either
case, the image will automatically be rebuilt with Python 3.12.

Preparation
===========

Expand Down
Loading