Update playbooks/roles

1. Add example dynamic inventory

playbooks/roles/dynamic_inventory.py

2. Update dcnm_vrf/dcnm_tests.yaml with notes for dynamic_inventory.py

3. Add dcnm_vrf/dcnm_hosts.py

playbooks/roles/dcnm_vrf/dcnm_hosts.yaml

@@ -0,0 +1,15 @@
+all:
+  vars:
+    ansible_user: "admin"
+    ansible_password: "password-ndfc"
+    switch_password: "password-switch"
+    ansible_python_interpreter: python
+    ansible_httpapi_validate_certs: False
+    ansible_httpapi_use_ssl: True
+  children:
+    ndfc:
+      vars:
+        ansible_connection: ansible.netcommon.httpapi
+        ansible_network_os: cisco.dcnm.dcnm
+      hosts:
+        192.168.1.1:

playbooks/roles/dcnm_vrf/dcnm_tests.yaml

@@ -0,0 +1,39 @@
+---
+# This playbook can be used to execute integration tests for
+# the roles located in:
+#
+# REPO_ROOT/tests/integration/targets/dcnm_vrf/tests/dcnm/*.yaml
+#
+# Either:
+# 1. Modify the following:
+#    - The vars section below with details for your testing setup.
+#    - dcnm_hosts.yaml in this directory
+#
+# 2. Run the tests
+#    ansible-playbook dcnm_tests.yaml -i dcnm_hosts.yaml
+#
+# OR:
+# 1. Modify ../dynamic_inventory.py to align with your setup
+#    This must contain the vars mentioned below and controller
+#    info from dcnm_hosts.yaml (modified for your setup)
+#  2. Run the tests
+#     ansible-playbook dcnm_tests.yaml -i ../dynamic_inventory.py
+#
+# NOTES:
+- hosts: dcnm
+  gather_facts: no
+  connection: ansible.netcommon.httpapi
+# Uncomment and modify if not using dynamic_inventory.py
+#   vars:
+    # test_fabric: f1
+    # switch_1: 10.1.1.2
+    # switch_2: 10.1.1.3
+    # switch_3: 10.1.1.4
+    # interface_1: Ethernet1/2
+    ## Uncomment ONE of the following testcases
+    # testcase: deleted
+    # testcase: merged
+    # testcase: query
+
+  roles:
+    - dcnm_vrf

playbooks/roles/dynamic_inventory.py

@@ -0,0 +1,147 @@
+#!/usr/bin/env python3
+#
+# Copyright (c) 2024 Cisco and/or its affiliates.
+#
+# 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.
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+__copyright__ = "Copyright (c) 2024 Cisco and/or its affiliates."
+__author__ = "Allen Robel"
+
+import json
+from os import environ
+
+"""
+# Summary
+Dynamic inventory for DCNM Collection integration tests. Inventory
+is built from environment variables.
+
+# Usage
+
+See README.md in the top-level of this repository and define the environment
+variables described there appropriately for your environment.
+"""
+test_fabric = environ.get("ND_FABRIC_NAME")
+nd_ip4 = environ.get("ND_IP4")
+nd_password = environ.get("ND_PASSWORD")
+nd_testcase = environ.get("ND_TESTCASE")
+nd_username = environ.get("ND_USERNAME", "admin")
+nxos_password = environ.get("NXOS_PASSWORD")
+nxos_username = environ.get("NXOS_USERNAME", "admin")
+# These are not used in any integration tests
+bgw_1 = environ.get("ND_BGW_1_IP4", "10.1.1.211")
+bgw_2 = environ.get("ND_BGW_2_IP4", "10.1.1.212")
+leaf_1 = environ.get("ND_LEAF_1_IP4", "10.1.1.106")
+leaf_2 = environ.get("ND_LEAF_2_IP4", "10.1.1.107")
+leaf_3 = environ.get("ND_LEAF_3_IP4", "10.1.1.108")
+leaf_4 = environ.get("ND_LEAF_4_IP4", "10.1.1.109")
+spine_1 = environ.get("ND_SPINE_1_IP4", "10.1.1.112")
+spine_2 = environ.get("ND_SPINE_2_IP4", "10.1.1.113")
+#-----------------
+# dcnm_vrf
+#-----------------
+# switch_1: border switch role
+switch_1 = environ.get("ND_SPINE_1_IP4", "10.1.1.112")
+# switch_2: border switch role
+switch_2 = environ.get("ND_SPINE_2_IP4", "10.1.1.113")
+# switch_3: non-border switch role
+switch_3 = environ.get("ND_LEAF_3_IP4", "10.1.1.108")
+# Interface to use for VRF LITE extensions on switch_1, switch_2
+interface_1 = environ.get("ND_INTERFACE_1", "Ethernet1/2")
+output = {
+    "_meta": {"hostvars": {}},
+    "all": {
+        "children": ["ungrouped", "dcnm", "ndfc", "nxos"],
+        "vars": {
+            "ansible_httpapi_use_ssl": "true",
+            "ansible_httpapi_validate_certs": "false",
+            "ansible_password": nd_password,
+            "ansible_python_interpreter": "python",
+            "ansible_user": nd_username,
+            "bgw1": bgw_1,
+            "bgw2": bgw_2,
+            "leaf1": leaf_1,
+            "leaf2": leaf_2,
+            "leaf_1": leaf_1,
+            "leaf_2": leaf_2,
+            "leaf3": leaf_3,
+            "leaf4": leaf_4,
+            "nxos_username": nxos_username,
+            "nxos_password": nxos_password,
+            "switch_password": nxos_password,
+            "switch_username": nxos_username,
+            "spine1": spine_1,
+            "spine2": spine_2,
+            "switch1": switch_1,
+            "switch2": switch_2,
+            "switch_1": switch_1,
+            "switch_2": switch_2,
+            "switch_3": switch_3,
+            "interface_1": interface_1,
+            "testcase": nd_testcase,
+            "test_fabric": test_fabric
+        },
+    },
+    "dcnm": {
+        "hosts": [nd_ip4],
+        "vars": {
+            "ansible_connection": "ansible.netcommon.httpapi",
+            "ansible_network_os": "cisco.dcnm.dcnm",
+        },
+    },
+    "ndfc": {
+        "hosts": [nd_ip4],
+        "vars": {
+            "ansible_connection": "ansible.netcommon.httpapi",
+            "ansible_network_os": "cisco.dcnm.dcnm",
+        },
+    },
+    "nxos": {
+        "children": [
+            "bgw1",
+            "bgw2",
+            "leaf_1",
+            "leaf_2",
+            "leaf1",
+            "leaf2",
+            "leaf3",
+            "leaf4",
+            "spine1",
+            "spine2",
+            "switch1",
+            "switch2",
+        ],
+        "vars": {
+            "ansible_become": "true",
+            "ansible_become_method": "enable",
+            "ansible_connection": "ansible.netcommon.httpapi",
+            "ansible_network_os": "cisco.nxos.nxos",
+        },
+    },
+    "bgw1": {"hosts": [bgw_1]},
+    "bgw2": {"hosts": [bgw_2]},
+    "leaf_1": {"hosts": [leaf_1]},
+    "leaf_2": {"hosts": [leaf_2]},
+    "leaf1": {"hosts": [leaf_1]},
+    "leaf2": {"hosts": [leaf_2]},
+    "leaf3": {"hosts": [leaf_3]},
+    "leaf4": {"hosts": [leaf_4]},
+    "spine1": {"hosts": [spine_1]},
+    "spine2": {"hosts": [spine_2]},
+    "switch1": {"hosts": [switch_1]},
+    "switch2": {"hosts": [switch_2]},
+}
+
+print(json.dumps(output))