From e84c19e0a60769ca0fa5aeef0ac1b8fb8fcb5d98 Mon Sep 17 00:00:00 2001 From: Will Szumski Date: Fri, 24 Apr 2026 18:38:37 +0100 Subject: [PATCH 1/4] Add docs for kolla-playbook usage Change-Id: Ie9c1b774e75bd87ef4dfd5ff4e06e26c8da908f3 Closes-Bug: #2143741 Depends-On: https://review.opendev.org/c/openstack/kolla-ansible/+/986152 Signed-off-by: Will Szumski --- doc/source/usage.rst | 76 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/doc/source/usage.rst b/doc/source/usage.rst index 94269f959..52f686684 100644 --- a/doc/source/usage.rst +++ b/doc/source/usage.rst @@ -86,6 +86,82 @@ and tasks. Using tags is not tested in either Kayobe or Kolla-Ansible CI, and as such should only be used if you know what you're doing. Proceed with caution. +Kolla Ansible Playbook +---------------------- + +Some commands that invoke Kolla Ansible support replacing the default +``site.yml`` playbook with a custom one via ``--kolla-playbook``. This may be +used to specify a playbook that replaces or extends the default playbook, and +needs to execute in the Kolla Ansible context. For example:: + + (kayobe) $ kayobe overcloud service deploy --kolla-playbook /path/to/playbook.yml + +The playbook can be called multiple times with different ``kolla_action`` values. You must make the playbook resistant to this, for example by using the ``kolla_action`` variable to conditionally execute tasks. Examples of kolla_action values include: + +- ``backup`` +- ``bootstrap-servers`` +- ``check`` +- ``certificates`` +- ``config`` +- ``config_validate`` +- ``deploy`` +- ``deploy-containers`` +- ``deploy-servers`` +- ``destroy`` +- ``gather-facts`` +- ``migrate-container-engine`` +- ``nova-libvirt-cleanup`` +- ``octavia-certificates`` +- ``post-deploy`` +- ``precheck`` +- ``prune-images`` +- ``pull`` +- ``rabbitmq-reset-state`` +- ``reconfigure`` +- ``stop`` +- ``upgrade`` + +For example, when running ``kayobe overcloud service deploy`` the playbook will be run with ``kolla_action`` set to + +- ``precheck`` +- ``deploy`` +- ``post-deploy`` + +An example of a task only running against a specific kolla_action value is shown below: + +.. code-block:: yaml + + --- + - name: Example custom playbook with precheck and deploy tasks + hosts: all + tasks: + - name: Assert something during precheck + assert: + that: + - some_variable is defined + when: kolla_action == 'precheck' + + - name: Do something during deploy + debug: + msg: "This will only run during deploy" + when: kolla_action == 'deploy' + +Alternatively, you can make the playbook exit if the kolla_action value is not one that the playbook is designed to handle, removing the need for ``when`` conditions on individual tasks: + +.. code-block:: yaml + + --- + - name: Example guarded custom playbook + hosts: all + tasks: + - name: End play if not deploying + meta: end_play + when: kolla_action != 'deploy' + + - name: Do something during deploy + debug: + msg: "This will only run during deploy" + Check and diff mode ------------------- From ce059b3b49c1eee34d0ec279b328715f4f9a2e6b Mon Sep 17 00:00:00 2001 From: Bartosz Bezak Date: Wed, 13 May 2026 15:39:13 +0200 Subject: [PATCH 2/4] CI: disable SLURP jobs on master Change-Id: Id88322ba9222ea25bc1e43263f99b25f2afbad99 Signed-off-by: Bartosz Bezak --- zuul.d/project.yaml | 8 -------- 1 file changed, 8 deletions(-) diff --git a/zuul.d/project.yaml b/zuul.d/project.yaml index 1e7975186..fdf8d6abf 100644 --- a/zuul.d/project.yaml +++ b/zuul.d/project.yaml @@ -25,16 +25,12 @@ - kayobe-overcloud-ubuntu-noble - kayobe-overcloud-ubuntu-noble-podman - kayobe-overcloud-upgrade-rocky10 - - kayobe-overcloud-upgrade-slurp-rocky10 - - kayobe-overcloud-upgrade-slurp-ubuntu-noble - kayobe-overcloud-upgrade-ubuntu-noble - kayobe-seed-rocky10 - kayobe-seed-rocky10-podman - kayobe-seed-ubuntu-noble - kayobe-seed-ubuntu-noble-podman - kayobe-seed-upgrade-rocky10 - - kayobe-seed-upgrade-slurp-rocky10 - - kayobe-seed-upgrade-slurp-ubuntu-noble - kayobe-seed-upgrade-ubuntu-noble - kayobe-seed-vm-rocky10 - kayobe-seed-vm-ubuntu-noble @@ -56,16 +52,12 @@ - kayobe-overcloud-ubuntu-noble - kayobe-overcloud-ubuntu-noble-podman - kayobe-overcloud-upgrade-rocky10 - - kayobe-overcloud-upgrade-slurp-rocky10 - - kayobe-overcloud-upgrade-slurp-ubuntu-noble - kayobe-overcloud-upgrade-ubuntu-noble - kayobe-seed-rocky10 - kayobe-seed-rocky10-podman - kayobe-seed-ubuntu-noble - kayobe-seed-ubuntu-noble-podman - kayobe-seed-upgrade-rocky10 - - kayobe-seed-upgrade-slurp-rocky10 - - kayobe-seed-upgrade-slurp-ubuntu-noble - kayobe-seed-upgrade-ubuntu-noble - kayobe-seed-vm-rocky10 - kayobe-seed-vm-ubuntu-noble From 4f11912d61f1ca86d3c80860a189ef729a0b9553 Mon Sep 17 00:00:00 2001 From: OpenStack Release Bot Date: Tue, 26 May 2026 13:40:25 +0000 Subject: [PATCH 3/4] Update master for stable/2026.1 Add file to the reno documentation build to show release notes for stable/2026.1. Use pbr instruction to increment the minor version number automatically so that master versions are higher than the versions on stable/2026.1. Sem-Ver: feature Change-Id: I2c03a2f299e9c454da7ba09faec55ed59b08350f Signed-off-by: OpenStack Release Bot Generated-By: openstack/project-config:roles/copy-release-tools-scripts/files/release-tools/add_release_note_page.sh --- releasenotes/source/2026.1.rst | 6 ++++++ releasenotes/source/index.rst | 1 + 2 files changed, 7 insertions(+) create mode 100644 releasenotes/source/2026.1.rst diff --git a/releasenotes/source/2026.1.rst b/releasenotes/source/2026.1.rst new file mode 100644 index 000000000..3d2861580 --- /dev/null +++ b/releasenotes/source/2026.1.rst @@ -0,0 +1,6 @@ +=========================== +2026.1 Series Release Notes +=========================== + +.. release-notes:: + :branch: stable/2026.1 diff --git a/releasenotes/source/index.rst b/releasenotes/source/index.rst index 6cd206129..4b784937a 100644 --- a/releasenotes/source/index.rst +++ b/releasenotes/source/index.rst @@ -6,6 +6,7 @@ Kayobe Release Notes :maxdepth: 1 unreleased + 2026.1 2025.2 2025.1 2024.2 From 3e3eafce9b7cb4ee6a47a852bc3a7e206da8bb68 Mon Sep 17 00:00:00 2001 From: Will Szumski Date: Wed, 27 May 2026 17:16:53 +0100 Subject: [PATCH 4/4] Revert "[release] Use OpenStack 2026.1 release" This reverts commit 758516fd05d46fec243b0047c3caefc8a92d03a2. Change-Id: Iece6b0d8373356632857d8f7f7d4ef023e54d52b Signed-off-by: Will Szumski --- ansible/inventory/group_vars/all/openstack | 6 +++--- etc/kayobe/openstack.yml | 4 ++-- requirements.yml | 2 +- tox.ini | 8 ++++---- zuul.d/jobs.yaml | 8 -------- 5 files changed, 10 insertions(+), 18 deletions(-) diff --git a/ansible/inventory/group_vars/all/openstack b/ansible/inventory/group_vars/all/openstack index a7a6e4312..430293d3f 100644 --- a/ansible/inventory/group_vars/all/openstack +++ b/ansible/inventory/group_vars/all/openstack @@ -2,10 +2,10 @@ ############################################################################### # OpenStack release configuration. -# Name of the current OpenStack release. Default is "2026.1". -openstack_release: "2026.1" +# Name of the current OpenStack release. Default is "master". +openstack_release: "master" -# Name of the current OpenStack branch. Default is "stable/2026.1". +# Name of the current OpenStack branch. Default is "master". openstack_branch: >- {% if openstack_release != 'master' %}stable/{% endif %}{{ openstack_release | lower }} diff --git a/etc/kayobe/openstack.yml b/etc/kayobe/openstack.yml index 688b6f4c0..1acfd0756 100644 --- a/etc/kayobe/openstack.yml +++ b/etc/kayobe/openstack.yml @@ -2,10 +2,10 @@ ############################################################################### # OpenStack release configuration. -# Name of the current OpenStack release. Default is "2026.1". +# Name of the current OpenStack release. Default is "master". #openstack_release: -# Name of the current OpenStack branch. Default is "stable/2026.1". +# Name of the current OpenStack branch. Default is "master". #openstack_branch: ############################################################################### diff --git a/requirements.yml b/requirements.yml index 6cdba6264..d96920de6 100644 --- a/requirements.yml +++ b/requirements.yml @@ -2,7 +2,7 @@ collections: - name: https://opendev.org/openstack/ansible-collection-kolla type: git - version: stable/2026.1 + version: master - name: community.docker version: 5.2.0 - name: community.network diff --git a/tox.ini b/tox.ini index 6f173d62d..86f549130 100644 --- a/tox.ini +++ b/tox.ini @@ -19,7 +19,7 @@ setenv = OS_TEST_TIMEOUT=60 ANSIBLE_VERBOSITY=3 deps = - -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2026.1} + -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/requirements.txt -r{toxinidir}/test-requirements.txt commands = stestr run {posargs} @@ -42,7 +42,7 @@ commands = [testenv:venv] deps = - -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2026.1} + -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/test-requirements.txt -r{toxinidir}/doc/requirements.txt commands = {posargs} @@ -60,7 +60,7 @@ commands = [testenv:molecule] deps = - -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2026.1} + -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/requirements.txt -r{toxinidir}/molecule-requirements.txt commands = @@ -130,7 +130,7 @@ commands = [testenv:docs] deps = - -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/2026.1} + -c{env:TOX_CONSTRAINTS_FILE:https://releases.openstack.org/constraints/upper/master} -r{toxinidir}/doc/requirements.txt commands = rm -rf doc/build/html diff --git a/zuul.d/jobs.yaml b/zuul.d/jobs.yaml index 2b889a470..2687d1be0 100644 --- a/zuul.d/jobs.yaml +++ b/zuul.d/jobs.yaml @@ -71,19 +71,11 @@ required-projects: # Include kayobe to ensure other projects can use this job. - name: openstack/ansible-collection-kolla - # TODO(wszumski): Remove when kayobe stable/2026.1 exists. - override-checkout: stable/2026.1 - name: openstack/kayobe - name: openstack/kayobe-config-dev - name: openstack/kolla - # TODO(wszumski): Remove when kayobe stable/2026.1 exists. - override-checkout: stable/2026.1 - name: openstack/kolla-ansible - # TODO(wszumski): Remove when kayobe stable/2026.1 exists. - override-checkout: stable/2026.1 - name: openstack/requirements - # TODO(wszumski): Remove when kayobe stable/2026.1 exists. - override-checkout: stable/2026.1 - name: openstack/tenks irrelevant-files: - ^\..+