WIP: Add networking-lab with devstack-nxsw-vxlan

Introduces a new networking-lab directory for network-focused scenarios
that don't require full OpenShift deployments. Includes first scenario:
devstack-nxsw-vxlan with spine-and-leaf topology featuring:

- 4 Cisco NX-OS switches (2 spine + 2 leaf) with OSPF underlay
- Devstack node with trunk port for VLAN-tagged traffic
- 2 Ironic baremetal nodes attached to leaf switches
- Individual POAP scripts and configs per switch
- VXLAN/EVPN ready configuration
- SVG topology diagram
- Automated POAP md5sum management script and pre-commit hook

Point-to-point links consolidated in 10.1.1.0/24 to preserve
10.1.2.0/24+ address space for future use.

Signed-off-by: Harald Jensås <hjensas@redhat.com>

Author: hjensas

.gitignore

@@ -1,3 +1,5 @@
 **/__pycache__/
 .ansible/*
 .venv/*
+*.gz.b64
+*.tar.gz

.pre-commit-config.yaml

@@ -57,6 +57,12 @@ repos:
       language: system
       files: ^scenarios/sno-nxsw/poap\.py$
       pass_filenames: false
+    - id: networking-lab-poap-md5sums
+      name: Format networking-lab POAP scripts with md5sum management
+      entry: scenarios/networking-lab/manage-poap-md5sums.sh
+      language: system
+      files: ^scenarios/networking-lab/.*-poap\.py$
+      pass_filenames: false
 
   - repo: https://github.com/ansible/ansible-lint
     rev: v6.22.2

03-redfish_vbmc_podman.yml

@@ -0,0 +1,37 @@
+---
+# Copyright Red Hat, Inc.
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Install RedFish Virtual BMC (Podman)
+  hosts: localhost
+  gather_facts: true
+  strategy: linear
+  pre_tasks:
+    - name: Load stack output vars from file
+      ansible.builtin.include_vars:
+        file: "{{ hotstack_work_dir | default(playbook_dir) }}/{{ stack_name }}-outputs.yaml"
+        name: stack_outputs
+
+    - name: Add controller-0 to the Ansible inventory
+      ansible.builtin.add_host: "{{ stack_outputs.controller_ansible_host }}"
+
+  roles:
+    - role: redfish_vbmc_podman
+      when:
+        - stack_outputs.sushy_emulator_uuids | default({}) | length > 0
+      delegate_to: controller-0
+      vars:
+        redfish_vbmc_podman_instances_uuids: "{{ stack_outputs.sushy_emulator_uuids.values() }}"
+        redfish_vbmc_podman_os_cloud: default

04-install_devstack.yml

@@ -0,0 +1,35 @@
+---
+# Copyright Red Hat, Inc.
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Install Devstack
+  hosts: localhost
+  gather_facts: true
+  strategy: linear
+  pre_tasks:
+    - name: Load stack output vars from file
+      ansible.builtin.include_vars:
+        file: "{{ hotstack_work_dir | default(playbook_dir) }}/{{ stack_name }}-outputs.yaml"
+        name: stack_outputs
+
+    - name: Add controller-0 to the Ansible inventory
+      ansible.builtin.add_host: "{{ stack_outputs.controller_ansible_host }}"
+
+  roles:
+    - role: devstack_installer
+      vars:
+        devstack_ansible_host: "{{ stack_outputs.devstack_ansible_host }}"
+        devstack_netplan_config: "{{ stack_outputs.devstack_netplan_config }}"
+        devstack_genericswitch_config: "{{ stack_outputs.genericswitch_config | default('') }}"

05-hotloop-stages.yml

@@ -0,0 +1,39 @@
+---
+# Copyright Red Hat, Inc.
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Run HotLoop Stages
+  hosts: localhost
+  gather_facts: true
+  strategy: linear
+  pre_tasks:
+    - name: Load stack output vars from file
+      ansible.builtin.include_vars:
+        file: "{{ hotstack_work_dir | default(playbook_dir) }}/{{ stack_name }}-outputs.yaml"
+        name: stack_outputs
+
+    - name: Add controller-0 to the Ansible inventory
+      ansible.builtin.add_host: "{{ stack_outputs.controller_ansible_host }}"
+
+    - name: "Load automation vars - store in variable: automation"
+      ansible.builtin.include_vars:
+        file: "{{ automation_vars_file }}"
+        name: automation
+
+  roles:
+    - role: hotloop
+      delegate_to: controller-0
+      vars:
+        work_dir: "{{ scenario_dir }}/{{ scenario }}"

bootstrap_devstack.yml

@@ -0,0 +1,30 @@
+---
+# Copyright Red Hat, Inc.
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Bootstrap virtual infrastructure on Openstack cloud
+  ansible.builtin.import_playbook: 01-infra.yml
+
+- name: Bootstrap controller node
+  ansible.builtin.import_playbook: 02-bootstrap_controller.yml
+
+- name: Deploy RedFish Virtual BMC (Podman)
+  ansible.builtin.import_playbook: 03-redfish_vbmc_podman.yml
+
+- name: Install DevStack
+  ansible.builtin.import_playbook: 04-install_devstack.yml
+
+- name: Run HotLoop Stages
+  ansible.builtin.import_playbook: 05-hotloop-stages.yml

roles/controller/defaults/main.yml

@@ -6,6 +6,7 @@ bin_dir: "{{ base_dir }}/bin"
 ssh_key_dir: "{{ base_dir }}/.ssh"
 data_dir: "{{ base_dir }}/data"
 cloud_config_dir: "{{ base_dir }}/.hotcloud"
+controller_install_openstack_client: false
 hotstack_cloud_secrets:
   auth_url: http://cloud.example.com:5000
   application_credential_id: app_credential_id

roles/controller/tasks/install_openstack_client.yml

@@ -0,0 +1,36 @@
+---
+# Copyright Red Hat, Inc.
+# All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+- name: Create virtualenv for OpenStack client
+  become: true
+  ansible.builtin.pip:
+    name:
+      - python-openstackclient
+      - python-ironicclient
+      - python-heatclient
+    virtualenv: /opt/openstackclient-venv
+    virtualenv_command: python3 -m venv
+
+- name: Create wrapper script in /usr/local/bin
+  become: true
+  ansible.builtin.copy:
+    content: |
+      #!/bin/bash
+      exec /opt/openstackclient-venv/bin/openstack "$@"
+    dest: /usr/local/bin/openstack
+    mode: '0755'
+    owner: root
+    group: root

roles/controller/tasks/main.yml

@@ -192,3 +192,7 @@
             [data_dir, 'ironic_nodes.yaml']
             | ansible.builtin.path_join
           }}
+
+    - name: Install OpenStack client
+      when: controller_install_openstack_client | bool
+      ansible.builtin.include_tasks: install_openstack_client.yml