From a8af2ff82c9298bce2456da37968c726c37c3d75 Mon Sep 17 00:00:00 2001 From: melanie witt Date: Wed, 9 Oct 2024 21:52:15 +0000 Subject: [PATCH] docs: Add DevStack configuration example to README Change-Id: Ib3f28c272a5cb82de5b037460da1a55dfeb1c6b9 --- README.rst | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/README.rst b/README.rst index ebe47ade..9f0cfe52 100644 --- a/README.rst +++ b/README.rst @@ -57,6 +57,41 @@ Install, configure and run containers = true max_compute_nodes = 2 # Some tests depend on there being a single (available) compute node + Here is an example for a two-node DevStack deployment: + + .. code-block:: ini + + [whitebox] + nodes_yaml = /opt/stack/whitebox-tempest-plugin/nodes.yaml + ctlplane_ssh_username = vagrant + ctlplane_ssh_private_key_path = /home/vagrant/.ssh/id_rsa + + with a ``nodes.yaml`` file that looks something like: + + .. code-block:: yaml + + controller: + services: + libvirt: + start-command: 'systemctl start libvirtd' + stop_command: 'systemctl stop libvirtd' + nova-compute: + config_path: '/etc/nova/nova-cpu.conf' + start_command: 'systemctl start devstack@n-cpu' + stop_command: 'systemctl stop devstack@n-cpu' + compute1: + services: + libvirt: + start-command: 'systemctl start libvirtd' + stop_command: 'systemctl stop libvirtd' + nova-compute: + config_path: '/etc/nova/nova-cpu.conf' + start_command: 'systemctl start devstack@n-cpu' + stop_command: 'systemctl stop devstack@n-cpu' + + where ``controller`` is the hostname of the controller node and + ``compute1`` is the hostname of the second node running nova-compute. + 3. Execute the tests. :: tempest run --serial --regex whitebox_tempest_plugin.