Skip to content

Commit b1eff32

Browse files
committed
Multinode package testing docs update
1 parent 9ce027b commit b1eff32

File tree

1 file changed

+19
-16
lines changed

1 file changed

+19
-16
lines changed

doc/source/contributor/package-updates.rst

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -63,11 +63,13 @@ The following steps describe the process to test the new package and container r
6363
Creating the multinode environments
6464
-----------------------------------
6565

66-
There is a comprehensive guide to setting up a multinode environment with Terraform, found here: https://github.com/stackhpc/terraform-kayobe-multinode. There are some things to note:
66+
The `Multinode deployment workflow <https://github.com/stackhpc/stackhpc-kayobe-config/actions/workflows/stackhpc-multinode.yml>`_ can be used to automatically test changes.
67+
68+
To manually test the changes, there is a comprehensive guide to set up a Multinode environment with Terraform, found here: https://github.com/stackhpc/terraform-kayobe-multinode. There are some things to note:
6769

6870
* OVN is enabled by default, you should override it under ``etc/kayobe/environments/ci-multinode/kolla.yml kolla_enable_ovn: false`` for the OVS multinode environment.
6971

70-
* Remember to set different vxlan_vnis for each.
72+
* Remember to set a different ``vxlan_vni`` for each.
7173

7274
* Before starting any tests, run ``dnf distro-sync -y`` on each host to ensure you are using the same snapshots as in the release train. Option ``-y`` is used to prevent hosts hang waiting for the confirmation input. You can do this using the following commands:
7375

@@ -85,7 +87,7 @@ There is a comprehensive guide to setting up a multinode environment with Terraf
8587
8688
kayobe playbook run --limit seed,overcloud $KAYOBE_CONFIG_PATH/ansible/reboot.yml
8789
88-
* The tempest tests run automatically at the end of deploy-openstack.sh. If you have the time, it is worth fixing any failing tests you can so that there is greater coverage for the package updates. (Also remember to propose these fixes in the relevant repos where applicable.)
90+
* The tempest tests run automatically at the end of the multinode deployment script. If you have the time, it is worth fixing any failing tests you can so that there is greater coverage for the package updates. (Also remember to propose these fixes in the relevant repos where applicable.)
8991

9092
Upgrading host packages
9193
-----------------------
@@ -114,30 +116,31 @@ Install new packages:
114116
Perform a rolling reboot of hosts:
115117

116118
.. note::
117-
For Multinode environment, seed-hypervisor cannot access control plane instances with the Openstack client.
118-
To use Openstack client, connect to the seed instance via SSH first.
119-
For authentication, use scp to copy ``public-openrc.sh`` to seed instance
119+
In the Multinode environment, the seed-hypervisor cannot access control
120+
plane instances with the Openstack client. To use Openstack client, connect
121+
to the Seed instance via SSH first. For authentication, use scp to copy
122+
``public-openrc.sh`` to the Seed
120123

121124
.. code-block:: console
122125
123126
# Check your hypervisor hostname
124-
openstack hypervisor list
127+
(seed) openstack hypervisor list
125128
126129
# Reboot controller instances and zeroth compute instance
127-
export ANSIBLE_SERIAL=1
128-
kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit controllers
129-
kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit compute[0]
130+
(seed-hypervisor) export ANSIBLE_SERIAL=1
131+
(seed-hypervisor) kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit controllers
132+
(seed-hypervisor) kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit compute[0]
130133
131134
# Test live migration
132-
openstack server create --image cirros --flavor m1.tiny --network external --hypervisor-hostname <Your Hypervisor Hostname> --os-compute-api-version 2.74 server1
133-
openstack server migrate --live-migration server1
134-
watch openstack server show server1
135+
(seed) openstack server create --image cirros --flavor m1.tiny --network external --hypervisor-hostname <Your Hypervisor Hostname> --os-compute-api-version 2.74 server1
136+
(seed) openstack server migrate --live-migration server1
137+
(seed) watch openstack server show server1
135138
136-
kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit compute[1]
139+
(seed-hypervisor) kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/reboot.yml --limit compute[1]
137140
138141
# Try and migrate back
139-
openstack server migrate --live-migration server1
140-
watch openstack server show server1
142+
(seed) openstack server migrate --live-migration server1
143+
(seed) watch openstack server show server1
141144
142145
Upgrading containers within a release
143146
-------------------------------------

0 commit comments

Comments
 (0)