Add 3-nodes job - experimental trigger

Also add AI generated documentation to stages in:
test-operator/automation-vars.yml

Assisted-By: calude-4-sonnet

Author: hjensas

scenarios/3-nodes/test-operator/automation-vars.yml

@@ -1,6 +1,10 @@
 ---
 stages:
   - name: Set a multiattach volume type and create it if needed
+    documentation: >-
+      Creates and configures a multiattach volume type in OpenStack that allows
+      volumes to be attached to multiple instances simultaneously. This is essential
+      for shared storage scenarios and high-availability configurations.
     shell: |
       set -xe -o pipefail
       oc project openstack
@@ -11,6 +15,10 @@ stages:
       oc rsh openstackclient openstack volume type set --property multiattach="<is> True" multiattach
 
   - name: Create public network if needed
+    documentation: >-
+      Creates an external public network that provides connectivity to the outside world.
+      This network uses a flat provider network type mapped to the 'datacentre' physical
+      network and serves as the gateway for floating IP assignments.
     shell: |
       set -xe -o pipefail
       oc project openstack
@@ -24,6 +32,10 @@ stages:
           --provider-physical-network datacentre
 
   - name: Create subnet on public network if needed
+    documentation: >-
+      Creates a subnet on the public network with a specific IP range (192.168.122.0/24)
+      and allocation pool. This subnet provides DHCP services and defines the gateway
+      for external connectivity. The allocation pool reserves IPs 171-250 for floating IPs.
     shell: |
       set -xe -o pipefail
       oc project openstack
@@ -37,6 +49,10 @@ stages:
           --dhcp
 
   - name: Create private network if needed
+    documentation: >-
+      Creates a shared private network for internal communication between OpenStack instances.
+      This network is shared across tenants and provides isolated internal connectivity
+      separate from the external public network.
     shell: |
       set -xe -o pipefail
       oc project openstack
@@ -45,6 +61,10 @@ stages:
         oc rsh openstackclient openstack network create private --share
 
   - name: Create subnet on private network if needed
+    documentation: >-
+      Creates a subnet on the private network with IP range 10.2.0.0/24 for internal
+      instance communication. This subnet includes DHCP services and allocates IPs
+      from 10.2.0.10 to 10.2.0.250 for instance assignments.
     shell: |
       set -xe -o pipefail
       oc project openstack
@@ -58,4 +78,16 @@ stages:
           --dhcp
 
   - name: Run tempest
+    documentation: >-
+      Executes comprehensive OpenStack validation tests using the Tempest framework.
     manifest: tempest-tests.yml
+    wait_conditions:
+      - >-
+        oc wait -n openstack tempests.test.openstack.org tempest-tests
+        --for condition=ServiceConfigReady --timeout=120s
+      - >-
+        oc wait -n openstack pod
+        -l operator=test-operator
+        -l service=tempest
+        -l workflowStep=0
+        --for jsonpath='{.status.phase}'=Succeeded --timeout=60m

zuul.d/jobs.yaml

@@ -67,4 +67,67 @@
       - ci/playbooks/run-tests.yml
     files:
       - ^scenarios/sno-2-bm/.*
+
+- job:
+    name: vexxhost-hotstack-3-nodes
+    parent: base-hotstack
+    nodeset: hotstack-image-vexxhost
+    description: |
+      Hotstack scenario: 3-nodes
+    timeout: 10800
+    attempts: 1
+    vars:
+      cloud_name: vexxhost
+      scenario: 3-nodes
+      scenario_dir: >-
+        {{
+          [
+            ansible_user_dir,
+            zuul.projects['github.com/openstack-k8s-operators/hotstack'].src_dir,
+            'scenarios'
+          ] | ansible.builtin.path_join
+        }}
+      hotstack_overrides:
+        stack_parameters:
+          dns_servers:
+            - 199.204.44.24
+            - 199.204.47.54
+          ntp_servers: []
+          router_external_network: public
+          floating_ip_network: public
+          controller_params:
+            image: hotstack-controller
+            # vpu: 1 ram 2GB disk: 20GB
+            flavor: ci.m1.small
+          ocp_master_params:
+            image: ipxe-boot-usb
+            # vpu: 16 ram 48GB disk: 200GB
+            flavor: 16vcpu_48GB
+          ocp_worker_params:
+            image: ipxe-boot-usb
+            # vpu: 12 ram 32GB disk: 200GB
+            flavor: 12vcpu_32GB
+          compute_params:
+            image: cs9stream-genericcloud
+            # vpu: 2 ram 4GB disk: 40GB
+            flavor: ci.m1.medium
+          networker_params:
+            image: cs9stream-genericcloud
+            # vpu: 2 ram 4GB disk: 40GB
+            flavor: ci.m1.medium
+          bmh_params:
+            image: sushy-tools-blank-image
+            cd_image: sushy-tools-blank-image
+            # vpu: 2 ram 4GB disk: 40GB
+            flavor: ci.m1.medium
+          ironic_params:
+            image: sushy-tools-blank-image
+            cd_image: sushy-tools-blank-image
+            # vpu: 1 ram 2GB disk: 20GB
+            flavor: ci.m1.small
+    run:
+      - ci/playbooks/run-deploy.yml
+      - ci/playbooks/run-tests.yml
+    files:
+      - ^scenarios/3-nodes/.*
       - ^roles/.*

zuul.d/projects.yaml

@@ -10,3 +10,4 @@
     github-experimental-trigger:
       jobs:
         - vexxhost-hotstack-sno-2-bm
+        - vexxhost-hotstack-3-nodes