From 4e17510d1b2c7079ef0bb9f02f4e043dfcb1c195 Mon Sep 17 00:00:00 2001 From: Seunghun Lee Date: Tue, 11 Nov 2025 10:43:24 +0000 Subject: [PATCH 1/2] 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. --- doc/source/operations/upgrading-openstack.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 28526afa9..345a4a6b0 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -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 @@ -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 ============ @@ -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 CI, Kayobe Automation image also needs to be rebuilt with Python 3.12. +Running the workflow from ``.github/workflows/build-kayobe-docker-image.yml`` +(For GitLab CI, use the workflow from ``.gitlab/workflows/build-kayobe-docker-image.yml``) +will automatically rebuild the image with Python 3.12. + Preparation =========== From c189f2b8b7d40913bd1540ce746b67f42b15c400 Mon Sep 17 00:00:00 2001 From: Seunghun Lee <45145778+seunghun1ee@users.noreply.github.com> Date: Mon, 24 Nov 2025 10:54:51 +0000 Subject: [PATCH 2/2] Reword to add equal guidance to GitLab CI users Co-authored-by: Alex Welsh <112560678+Alex-Welsh@users.noreply.github.com> --- doc/source/operations/upgrading-openstack.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 345a4a6b0..78d8d0691 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -377,10 +377,10 @@ You can find more information from the :ref:`beokay` documentation. Kayobe Automation ~~~~~~~~~~~~~~~~~ -For CI, Kayobe Automation image also needs to be rebuilt with Python 3.12. -Running the workflow from ``.github/workflows/build-kayobe-docker-image.yml`` -(For GitLab CI, use the workflow from ``.gitlab/workflows/build-kayobe-docker-image.yml``) -will automatically rebuild the image with Python 3.12. +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 ===========