All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
Release Versions
Release Date: 2026-03-13
- Added support for External fabric type in the dcnm_fabric module
- Added support for the following parameters in the dcnm_interface module
- enable_qos
- qos_policy
- `queuing_policy
Release Date: 2026-02-05
- Added Multisite Support
- Collection now supports both Multi-Site Domain MSD and Multi-Cluster Fabric Group MCFG
- dcnm_fabric_group - Module for fabric group management
- Added support to dcnm_vrf and dcnm_network modules for Multi-Site fabrics
- Added support for a new dhcp_servers parameter in the dcnm_network module to configure up to 16 DHCP servers
- This parameter replaces the existing dhcp_srvr1_ip, dhcp_srvr2_ip, and dhcp_srvr3_ip parameters
- The old parameters are deprecated but will continue to work for backward compatibility
Release Date: 2025-10-27
- Added support to increase the number of DHCP servers from 3 to 16 using the dcnm_network module
- Added documentation to the dcnm_fabric module for ENABLE_RT_INTF_STATS and INTF_STAT_LOAD_INTERVAL properties
Release Date: 2025-09-22
- Added support for the following parameters in the dcnm_interface module
- disable_lacp_suspend_individual
- enable_cdp
- enable_lacp_vpc_convergence
- enable_monitor
- enable_pfc
- lacp_port_priority
- lacp_rate
- Added support for eBGP fabric type in the dcnm_fabric module
- Added support for the following parameters in the dcnm_vrf module
- l3vni_wo_vlan
- v6_redist_direct_rmap
- Added support for x-www-form-urlencoded encoding in the dcnm_rest module
- Added httpapi connection plugin support for ND4.1
- Refactored and improved various module integration tests
- #26
- #51
- #90
- #179
- #210
- #271
- #308
- #324
- #326
- #337
- #366
- #369
- #389
- #404
- #405
- #411
- #422
- #430
- #432
- #446
- #450
- #455
- #466
- #469
- #473
- #482
- #486
- #488
Release Date: 2025-07-02
- Enhanced integration tests for the dcnm_network and dcnm_interface modules
- Refactored support for breakout interfaces to fix workflow issues in the dcnm_interface module
Release Date: 2025-06-02
- Updated
dcnm_interfacemodule to support the following - Breakout Interfaces
- New properties native_vlan, orphan_port, duplex, peer1_native_vlan, peer2_native_vlan, route_tag
- Ability to manage admin_state, description and cmds properties for PortChannel and vPC member interfaces
- Updated
Release Date: 2025-02-28
- The following new modules are included in this release
dcnm_log- Module for logging messages based on environment variableNDFC_LOGGING_CONFIG
- Dynamic inventory for ansible-dcnm repository integration tests
- Support for virtual peer link in
dcnm_vpc_pairmodule - Support for pre-provision workflows when using
dcnm_vpc_pairanddcnm_interfacemodule - Support for port-channel sub-interfaces in
dcnm_interfacemodule
- Bug when
deployflag set tofalseindcnm_vrfanddcnm_networkmodules - #338
- #343
- #347
- #351
- #353
- #356
- #357
- #358
- #360
Release Date: 2024-11-11
- The following new modules are included in this release
dcnm_bootflash- Module for bootflash management for Nexus switchesdcnm_maintenance_mode- Module for Maintentance Mode Configuration of Nexus switches
- The following new features are added to existing modules in this release
dcnm_policy- Flag to use the description parameter as the unique key for policy managementdcnm_fabric- Added ISN Fabric Type Support
Release Date: 2024-06-13
- Fix for ansible-sanity errors in code and documentation
- Updates to supported ansible version
Release Date: 2024-05-14
- The following new modules are included in this release
dcnm_image_upgrade- Module for managing NDFC image upgradedcnm_image_upload- Module for managing NDFC image uploaddcnm_image_policy- Module for managing NDFC image policydcnm_vpc_pair- Module for managing dcnm NDFC vPC switch pairsdcnm_fabric- Module for managing NDFC fabrics
- #276
- #278
- Fix for inventory issue when non-zero max hop value is set.
- Fix for enhanced error reporting in inventory module.
- Fix for config not required for overridden state.
- Fix for switch role based default ethernet interface policy.
Release Date: 2023-10-26
- Support to attach network to TOR switches paired with leaf and its interfaces
Release Date: 2023-09-11
- Support for following parameters in
dcnm_linksmodule mpls_fabricpeer1_sr_mpls_indexpeer2_sr_mpls_indexglobal_block_rangedci_routing_protoospf_area_iddci_routing_tag
- Support for following parameters in
- Support for
ext_vxlan_mpls_overlay_setupandext_vxlan_mpls_underlay_setuptemplates indcnm_linksmodule - Support for
secondary_ipv4_addrfor loopback interfaces indcnm_interfacemodule - Support for fabric and mpls loopback interfaces in
dcnm_interfacemodule - Support for
import_evpn_rtandexport_evpn_rtindcnm_vrfmodule
Release Date: 2023-08-17
There is no functional difference between collection version 3.4.0 and collection version 3.4.1. This version is only being published as a hotfix to resolve a problem where the wrong
version was inadvertently published to Ansible galaxy.
Release Date: 2023-08-16
- Support for save and deploy options in
dcnm_inventorymodule. - Support for
discovery_usernameanddiscovery_passwordindcnm_inventorymodule. - Support for login domain in connection plugin.
- Fix for deploy flag behaviour in inferface module. Config will not be deployed to switches if deploy flag is set to false. When deploy flag is set to true in task and if any of the switch in that task is not manageable or the fabric in task is read-only, then an error is returned without making any changes in the NDFC corresponding to that task.
Release Date: 2023-07-13
Release Date: 2023-05-23
- Support to configure multiple interfaces for vrf_lite on a vrf
- Added support for more switch roles in inventory module.
- #204
- #205
- #206
- Removed the restriction on netcommon version supported by DCNM collection. The restriction was introduced as fix for #209. Netcommon versions
>=2.6.1is supported.
Release Date: 2023-04-20
- Support for fex interfaces in interface module
Release Date: 2023-03-17
- Restrict installs of netcommon to versions
>=2.6.1,<=4.1.0due to issue: #209
Release Date: 2023-03-14
- Support for all config parameters in network module
- Support for all config parameters in vrf module
Release Date: 2023-02-22
- RMA support in
dcnm_inventorymodule
Release Date: 2022-11-17
- POAP support in
dcnm_inventorymodule - SVI interface support in
dcnm_interfacemodule
- Fix for a problem where networks cannot be deleted when detach/undeploy fails and network is in an out of sync state.
- Fix default value for
multicast_group_addressproperty indcnm_network
Release Date: 2022-10-28
- Added the ability to configure the
multicast_group_addressto thedcnm_networkmodule
Release Date: 2022-10-14
- The following new modules are included in this release
dcnm_links- Module for managing dcnm links
Release Date: 2022-08-18
- Changed the deploy mechanism of policy module for delete state.
Release Date: 2022-07-19
- The following new modules are included in this release
dcnm_resource_manager- Module for managing dcnm resources. Reference Info
- #151
- #143
- #141
- #139
- #137
- #134
- #112
- Fixed Restapi used in version detection mechanism in module utils.
- Fixed Restapi used in various modules to support the latest api's.
- Fixed deploy knob behavior for vrf and network module to align with GUI functionality.
- Fixed idempotence issue in interface module.
- Fixed diff generation issue for network deletion with NDFC.
- Deploy knob for individual attachments in vrf and network modules has been marked for deprecation.
Release Date: 2022-01-28
Fixed httpapi plugin issue preventing connections to latest version of NDFC (Version: 12.0.2f)
Release Date: 2021-12-13
- Nexus Dashboard Fabric Controller (NDFC) support for all collection modules
- The following new modules are included in this release
dcnm_service_route_peering- Module for managing dcnm service route peeringdcnm_service_policy- Module for managing dcnm service policydcnm_service_node- Module for managing dcnm service nodes
- New parameter
check_deployindcnm_interface - Performance improvement of dcnm_inventory module.
Release Date: 2021-12-03
- Added support for configuring the loopback ID for DHCP Relay interface.
- The feature is configured using the
dhcp_loopback_idparameter in thedcnm_networkmodule
Release Date: 2021-11-16
Fixed a problem with dcnm_interface module where VPCID resource was not being created and then reserved properly
Release Date: 2021-10-21
Fixed error code handling that was causing an error during authentication
Release Date: 2021-10
Added support for plain text payloads to dcnm_rest module
Release Date: 2021-07
The following parameters were added to the cisco.dcnm.dcnm_network module:
- New parameter
is_l2only:- New parameter
vlan_name:- New parameter
int_desc:- New parameter
mtu_l3intf:`- New parameter
arp_suppress:- New parameter
dhcp_srvr1_ip:- New parameter
dhcp_srvr1_vrf:- New parameter
dhcp_srvr2_ip:- New parameter
dhcp_srvr2_vrf:- New parameter
dhcp_srvr3_ip:- New parameter
dhcp_srvr3_vrf:
Release Date: 2021-05
Release Date: 2021-04
- The following new modules are included in this release
dcnm_policy- Module for managing dcnm policiesdcnm_template- Module for managing dcnm templates
- The
dcnm_vrfanddcnm_networkmodules have been extended to support multisite fabrics
- Bug fixes
- Support for DCNM
11.5(1)release
Release Date: 2020-09
- cisco.dcnm.dcnm_network:
- New parameter
routing_tag:
- cisco.dcnm.dcnm_network:
- The
vlan_id:parameter must be configured under theconfig:block instead of theattach:block. - A warning will be generated informing the user to move the
vlan_id:under theconfig:block. - If the user does not specify the
vlan_idit will be auto generated by DCNM.
- The
- cisco.dcnm_dcnm_interface:
The various
profile_*:parameters have now been modified to justprofile:.The playbook with the old
profile_*:names will still be accepted but a warning message will be generated to change the playbook.When specifying switches for a
vpcinterface type the switches should be a flat yaml list instead of a nested yaml list. Both formats will still be accepted.Proper Format:
switch: # provide switches of vPC pair - "{{ ansible_switch1 }}" - "{{ ansible_switch2 }}"
Incorrect Format:
switch: # provide switches of vPC pair - ["{{ ansible_switch1 }}", "{{ ansible_switch2 }}"]
- cisco.dcnm.dcnm_rest:
- Module will return a failure now if the return code from DCNM is
400or greater.
Release Date: 2020-07
- Initial release of the Ansible DCNM collection, supporting DCNM release 11.4
The Ansible Cisco Data Center Network Manager (DCNM) collection includes modules to help automate common day 2 operations for VXLAN EVPN fabrics.
- cisco.dcnm.dcnm_rest - Send REST API requests to DCNM controller.
- cisco.dcnm.dcnm_inventory - Add and remove Switches from a DCNM managed VXLAN fabric.
- cisco.dcnm.dcnm_vrf - Add and remove VRFs from a DCNM managed VXLAN fabric.
- cisco.dcnm.dcnm_network - Add and remove Networks from a DCNM managed VXLAN fabric.
- cisco.dcnm.dcnm_interface - DCNM Ansible Module for managing interfaces.