All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.
Release Versions
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
- CiscoDevNet#276
- CiscoDevNet#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_links
module mpls_fabric
peer1_sr_mpls_index
peer2_sr_mpls_index
global_block_range
dci_routing_proto
ospf_area_id
dci_routing_tag
- Support for following parameters in
- Support for
ext_vxlan_mpls_overlay_setup
andext_vxlan_mpls_underlay_setup
templates indcnm_links
module - Support for
secondary_ipv4_addr
for loopback interfaces indcnm_interface
module - Support for fabric and mpls loopback interfaces in
dcnm_interface
module - Support for
import_evpn_rt
andexport_evpn_rt
indcnm_vrf
module
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_inventory
module. - Support for
discovery_username
anddiscovery_password
indcnm_inventory
module. - 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.
- CiscoDevNet#204
- CiscoDevNet#205
- CiscoDevNet#206
- Removed the restriction on netcommon version supported by DCNM collection. The restriction was introduced as fix for CiscoDevNet#209. Netcommon versions
>=2.6.1
is 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.0
due to issue: CiscoDevNet#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_inventory
module
Release Date: 2022-11-17
- POAP support in
dcnm_inventory
module - SVI interface support in
dcnm_interface
module
- 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_address
property indcnm_network
Release Date: 2022-10-28
- Added the ability to configure the
multicast_group_address
to thedcnm_network
module
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
- CiscoDevNet#151
- CiscoDevNet#143
- CiscoDevNet#141
- CiscoDevNet#139
- CiscoDevNet#137
- CiscoDevNet#134
- CiscoDevNet#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_deploy
indcnm_interface
- Performance improvement of dcnm_inventory module.
- CiscoDevNet#101
- CiscoDevNet#87
- CiscoDevNet#86
- Fix
dcnm_policy
module configuration deploy issues
Release Date: 2021-12-03
- Added support for configuring the loopback ID for DHCP Relay interface.
- The feature is configured using the
dhcp_loopback_id
parameter in thedcnm_network
module
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_vrf
anddcnm_network
modules 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_id
it 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
vpc
interface 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
400
or 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.