From 38b5a85c91bd5261235fc1b8441942bdcd70a991 Mon Sep 17 00:00:00 2001 From: Jason Rayne Date: Thu, 9 Oct 2025 12:56:21 -0700 Subject: [PATCH 1/4] fix(docs): correct playbook commands and minor inconsistencies in Ubuntu Noble upgrade guide - Fix incorrect ceph-enter-maintenance.yml usage where ceph-exit-maintenance.yml should be used - Add missing -e flags to pulp-repo-publish.yml and pulp-repo-promote-production.yml commands - Fix typo: "change" -> "chance" in storage section potential issues --- doc/source/operations/ubuntu-noble.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index 4ac5847168..5205f3fa54 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -80,14 +80,14 @@ To sync host packages: .. code-block:: console kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-sync.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-publish.yml + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-publish.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true Once the host package content has been tested in a test/staging environment, it may be promoted to production: .. code-block:: console - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-promote-production.yml + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-promote-production.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true To sync container images: @@ -165,7 +165,7 @@ Always back up the overcloud DB before starting: Potential issues ---------------- -- If the system uses OVS as a network driver, there's a change that kolla +- If the system uses OVS as a network driver, there's a chance that kolla services can struggle to find reply queues from RabbitMQ during the upgrade. Currently this could be observed when rolling reboot of controllers are done or deploying Ubuntu Noble based Kolla containers are deployed after all @@ -236,7 +236,7 @@ Full procedure for one controller .. code-block:: console - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-enter-maintenance.yml --limit + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-exit-maintenance.yml --limit 3. Make sure that everything is back in working condition before moving on to the next host: @@ -321,7 +321,7 @@ Full procedure for one batch of hosts .. code-block:: console - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-enter-maintenance.yml --limit + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/ceph-exit-maintenance.yml --limit 3. Make sure that everything is back in working condition before moving on to the next host: From 550fdfdc6cf76be9b1478f3f1da1e56aaf569243 Mon Sep 17 00:00:00 2001 From: Jason Rayne Date: Thu, 9 Oct 2025 13:12:23 -0700 Subject: [PATCH 2/4] Update doc/source/operations/ubuntu-noble.rst Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- doc/source/operations/ubuntu-noble.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index 5205f3fa54..b7fb27475a 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -87,7 +87,9 @@ may be promoted to production: .. code-block:: console - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-promote-production.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-promote-production.yml \ + -e stackhpc_pulp_sync_ubuntu_jammy=true \ + -e stackhpc_pulp_sync_ubuntu_noble=true To sync container images: From af938b00bba260c7b211fbdf2d46064f0c2d3e03 Mon Sep 17 00:00:00 2001 From: Jason Rayne Date: Thu, 9 Oct 2025 13:12:41 -0700 Subject: [PATCH 3/4] Update doc/source/operations/ubuntu-noble.rst Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- doc/source/operations/ubuntu-noble.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index b7fb27475a..aa00ac3bb3 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -80,7 +80,9 @@ To sync host packages: .. code-block:: console kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-sync.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-publish.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-publish.yml \ + -e stackhpc_pulp_sync_ubuntu_jammy=true \ + -e stackhpc_pulp_sync_ubuntu_noble=true Once the host package content has been tested in a test/staging environment, it may be promoted to production: From 522f8597669feee4c2794a4d6716a49499f32d34 Mon Sep 17 00:00:00 2001 From: Jason Rayne Date: Thu, 9 Oct 2025 13:15:43 -0700 Subject: [PATCH 4/4] fix(docs): linebreak initial playbook command for consistency --- doc/source/operations/ubuntu-noble.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/ubuntu-noble.rst b/doc/source/operations/ubuntu-noble.rst index aa00ac3bb3..f0e89654db 100644 --- a/doc/source/operations/ubuntu-noble.rst +++ b/doc/source/operations/ubuntu-noble.rst @@ -79,7 +79,9 @@ To sync host packages: .. code-block:: console - kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-sync.yml -e stackhpc_pulp_sync_ubuntu_jammy=true -e stackhpc_pulp_sync_ubuntu_noble=true + kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-sync.yml \ + -e stackhpc_pulp_sync_ubuntu_jammy=true \ + -e stackhpc_pulp_sync_ubuntu_noble=true kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/pulp-repo-publish.yml \ -e stackhpc_pulp_sync_ubuntu_jammy=true \ -e stackhpc_pulp_sync_ubuntu_noble=true