Cisco NDFC (Nexus Dashboard Fabric Controller)¶
Warning
HIGHLY EXPERIMENTAL: The Cisco NDFC driver is in early development and should be considered experimental. It has NOT been extensively tested in production environments.
Modern NDFC API implementation (
/api/v1/manage/*endpoints)Stateless operations (always queries NDFC for current state)
Uses declarative network attachment model
Limited real-world deployment testing
Recommendation: Thorough testing in non-production environments is strongly recommended before deployment.
The Cisco NDFC driver manages NX-OS switches through NDFC’s REST API instead of direct SSH access. This provides centralized fabric management, audit trails, and policy-based configuration. NDFC handles all underlying switch configuration including BGP EVPN, NVE interfaces, and VXLAN data plane setup.
Prerequisites¶
NDFC instance managing your VXLAN BGP EVPN fabric
NDFC user account with permissions to manage networks and interfaces
Switches added to NDFC fabric inventory
For VXLAN: BGP EVPN configured in the fabric template
Modern NDFC version supporting
/api/v1/manage/*API endpoints
Configuration Parameters¶
Required:
device_type- Must becisco_ndfchost- NDFC hostname or IP address (the NDFC controller, not the managed switch)username- NDFC authentication usernamepassword- NDFC authentication passwordndfc_fabric_name- NDFC fabric name (default:default)
Switch identification:
The config section name (e.g. leaf01 for [genericswitch:leaf01]) must
match the switch hostname in NDFC. This aligns with the Ironic switch_info
used to route ports to this section.
Optional:
ndfc_switch_serial- Explicit switch serial number. When set, skips the hostname lookup (minor performance optimization).ndfc_switch_hostname- Override the hostname if it differs from the section name (rarely needed).
Optional:
ndfc_network_template- Network template (default:Default_Network_Universal)ndfc_vrf- VRF name (default:default)ndfc_interface_policy- Interface policy template (default:int_trunk_host)port- NDFC HTTPS port (default:443)ngs_verify_tls- Verify the NDFC TLS certificate (default:True)ndfc_timeout- Request timeout in seconds (default:30)ngs_max_connections- Session connection pool size (default:1). The requests session is shared across all sections pointing at the same NDFC, so this bounds connections per controller, not per switch.
Known Limitations¶
Security groups are not currently implemented. Support for NDFC policies and contracts is planned for a future release.
Configuration Example¶
[genericswitch:leaf01]
device_type = cisco_ndfc
host = ndfc.example.com
username = admin
password = secure_password
ndfc_fabric_name = prod-vxlan-fabric
ngs_physical_networks = datacenter1
The section name leaf01 automatically becomes the switch hostname for NDFC
lookups.