DEVWKS-3155-CLUS22 - Building Your Network Programmatically with Nexus Dashboard Fabric Controller

Requirements

For the examples in this repository, you'll need the following elements:

• Python 3.10.x
• Ansible 2.11.x
• Ansible DCNM Collection 2.0.1
• NDFC 12.0.2
• Nexus 9000 Switching
• Postman

As a part of Cisco Live US 2022's in-person event, you'll be provided three resources to assist you in the setup:

• DevNet Learning Lab Environment (Python and Ansible sandbox)
• dCloud Environment (NDFC and Switches)
• Workbench Laptop (Mint with Postman)

Self Paced Usage

The following instructions are for self-paced learning attempts outside the Cisco Live in-person event. If you are in the workshop, do not follow the setup instructions below. You will use the learning lab and its instructions. While similar, the below instructions will derail your DevNet workbench learning experience.

Python/Ansible Environment Setup

There is a setup-python.sh script that you can source to set up your environment, which builds a Python virtual environment ('venv') as well as installs the required Ansible DCNM collection.

Workshop lab environment

In this workshop, we'll be Cisco's dCloud platform - specifically, the Cisco NDFC for VXLAN EVPN Multi-Site Deployments Lab v1. (Note: if newer versions have been released, you have to search for the latest instance.) The dcloud-inventory.yaml files in each of the Ansible directories has all the relevant connection information for the workshop. Due to security issues that have arisen, you must work with your Cisco Account Team to be granted access to an instance of the lab.

Scenarios

There are two scenarios presented here:

• VXLAN EVPN Fabric Management
• Classic Ethernet Fabric Management

References

• NDFC 12.0.x Configuration Guide
• DevNet: NDFC REST API Reference
• Ansible DCNM Collection (GitHub)