Skip to content

CHANGELOG.rst

Latest commit

 

History

History
535 lines (438 loc) · 22 KB

CHANGELOG.rst

File metadata and controls

535 lines (438 loc) · 22 KB

Cisco Ansible NetworkAsCode DC VXLAN Collection Release Notes

All notable changes to this project will be documented in this file.

This project adheres to Semantic Versioning.

Release Versions

0.7.2

Release Date: 2026-05-01

Added

  • Added support for network attachments on TOR devices that are part of Multisite fabrics

Fixed

0.7.1

Release Date: 2026-03-17

Fixed

0.7.0

Release Date: 2026-03-13

Added

  • NEW Feature: ToR Pairing support
    • ToR switch with port channel directly connected to the leaf switch (standalone)
    • ToR switch connected to leaf switches in a vPC pair
    • ToR switches with back-to-back vPC connections with leaf and ToR switches in vPC pair
  • Added discovery credentials support
  • Added MPLS Hand-off fabric settings for VXLAN iBGP EVPN fabric
  • Added interface QoS settings support for the following interface types:
    • access
    • trunk
    • port-channel access
    • port-channel trunk
    • vPC access
    • vPC trunk
  • Added MVPN VRI ID range support in VXLAN iBGP and eBGP EVPN fabric types
  • Added various fabric setting freeform support for VXLAN iBGP and eBGP fabric types under vxlan.global.ibgp or vxlan.global.ebgp:
    • pre-interface leaf freeform
    • pre-interface spine freeform
    • pre-interface tor freeform
    • post-interface leaf freeform
    • post-interface spine freeform
    • post-interface tor freeform
    • infra fabric link freeform
    • aaa freeform
    • banner freeform
    • bootstrap freeform (iBGP VXLAN, eBGP VXLAN, and also External fabric type)
    • spine ibgp peer template freeform (iBGP VXLAN only)
    • leaf ibgp peer template freeform (iBGP VXLAN only)
  • Added MTU support under edge_connections

Modified

  • Updated External fabric type to leverage base collection fabric module
    • Backwards compatibility maintained for previously created External fabrics
  • Moved enable_mvpn_vri_id_range from residing under vxlan.global.ibgp or vxlan.global.ebgp to reside under vxlan.underlay.multicast
    • Aligns support for added MVPN VRI ID range under vxlan.underlay.multicast
    • New data model path: vxlan.underlay.multicast.enable_mvpn_vri_id_range

Fixed

0.6.0

Release Date: 2026-02-05

Added

  • NEW Feature: Support for Multi-Cluster Fabric Groups (MCFG)
    • Support for MCFG Parent Fabric Group
    • Support for VXLAN Child Fabric
    • Support for ISN Child Fabric
  • NEW Feature: Support for up to 16 DHCP servers. Increased from 3 to 16.
  • NEW Feature: Support for service account / discovery credentials for POAP
  • Added support monitor mode for interfaces in data model
  • Added native vlan support for vPC interfaces

Fixed

0.5.1

Release Date: 2025-10-27

Modified

  • Deprecated keys under vxlan.global that are now available only under the following fabric types:
    • iBGP EVPN fabric type: vxlan.global.ibgp
    • External fabric type: vxlan.global.external
  • Improved performance when managing interfaces, fabric links, networks, VRFs, vPC peers, vPC Domain IDs, and underlay IP addresses when the force_run_all flag is set to false. These performance improvements are not currently supported for pipeline workflows.

Fixed

0.5.0

Release Date: 2025-09-22

Added

  • Added initial support for VXLAN eBGP EVPN fabric type that includes:
    • Fabric management
    • Underlay & Overlay configuration using provided documentation and examples: https://netascode.cisco.com/docs/data_models/vxlan/global/global/
    • Device discovery
    • vPC
    • Interfaces
    • Overlay (VRFs and Networks)
    • Policy
    • Note: eBGP EVPN fabric type introduces and only supports global configuration under vxlan.global.ebgp
  • Added additional backwards compatiability support for NDFC 3.1
  • Added support for creating and managing vPC domain / vPC pair in data model for external fabric
  • Added support for L3VNI without VLAN for iBGP and eBGP EVPN fabric types
  • Added support for additional LACP attributes in data model for port-channels
  • Added support for individual per-switch credentials
  • Added support for breakout interfaces with pre-provision device workflows
  • Added initial support for unified Nexus Dashboard 4.1 via legacy, backwards compatiable NDFC APIs

Modified

  • Updated iac-validate to use nac-validate in validate role
  • Updated vxlan.global keys to align with supported fabric types
    • iBGP EVPN fabric type should use: vxlan.global.ibgp
    • External fabric type should use: vxlan.global.external
    • eBGP EVPN fabric type introduces properties vxlan.global.ebgp starting in this release, 0.5.0
    • Backwards compatiability is provided for vxlan.global keys for iBGP and External fabric types
  • Updated pointer to defaults used for ISN and MSD fabric types to use defaults.vxlan.multisite keys

Fixed

0.4.3

Release Date: 2025-07-02

Added

  • Added support for manual underlay IP address allocation
  • Added support for manually allocating vPC domain IDs
  • Added support for breakout interfaces
  • Added support for dot1q interface type
  • Added support for orphan ports, duplex, and native VLAN for interface types access, access port-channel, trunk, and trunk port-channel

Modified

  • Updated defaults to include domain_id and lb_id defaults for PTP
  • Removed the requirement to have ports defined for vxlan.overlay.networks.network_attach_groups in VXLAN fabrics
  • Updated POAP and pre-provision workflow
    • This update allows devices to be discovered using discovery mode, poap and pre-provision workflows. Previously the solution did not allow both poap and pre-provision in the same datafile.
    • Note: The poap.boostrap setting under the device is only used for POAP mode without pre-provision first. It is not used by a pre-provision or pre-provision + POAP workflow.

Fixed

0.4.2

Release Date: 2025-06-02

Added

  • Added support for the following model properties:
    • vxlan.multisite.layer2_vni_range
    • vxlan.multisite.layer3_vni_range
    • vxlan.global.layer2_vni_range
    • vxlan.global.layer3_vni_range
    • vxlan.global.layer2_vlan_range
    • vxlan.global.layer3_vlan_range
    • vxlan.underlay.ipv6.underlay_routing_loopback_ip_range
    • vxlan.underlay.ipv6.underlay_vtep_loopback_ip_range
    • vxlan.underlay.ipv6.underlay_rp_loopback_ip_range
    • vxlan.underlay.ipv6.underlay_subnet_ip_range
    • vxlan.underlay.multicast.ipv4.authentication_enable
    • vxlan.underlay.multicast.ipv4.authentication_key
    • vxlan.underlay.multicast.ipv6.group_subnet
    • vxlan.underlay.multicast.ipv6.trmv6_enable
    • vxlan.underlay.multicast.ipv6.trmv6_default_group

Modified

  • The following keys have been relocated under vxlan.underlay.ipv4 and data model files will need to be updated accordingly:
    • vxlan.underlay.ipv4.fabric_interface_numbering
    • vxlan.underlay.ipv4.subnet_mask
  • The following keys have been relocated under vxlan.underlay.multicast.ipv4 and data model files will need to be updated accordingly:
    • vxlan.underlay.multicast.ipv4.group_subnet
    • vxlan.underlay.multicast.ipv4.trm_enable
    • vxlan.underlay.multicast.ipv4.trm_default_group

Fixed

0.4.1

Release Date: 2025-04-24

Added

  • Added ability to manage edge connections to external fabrics
  • Added support for checking if a fabric is in a multisite domain and disallow management of vxlan.overlay.vrfs and vxlan.overlay.networks under the child fabric

Modified

  • Added various multisite fixes and introduced new child_fabrics model key under vxlan.multisite.overlay.vrfs and vxlan.multisite.overlay.networks for defining site-specific attributes

Fixed

0.4.0

Release Date: 2025-02-28

Added

  • NEW Feature: Support for data model defined policy based VRF-LITE
  • NEW Feature: Support for data model defined policy based Route-Control
  • NEW Feature: Support for Multi-Site Domain (MSD)
    • Support for VXLAN Child Fabric
    • Support for ISN Child Fabric
    • Support for MSD Parent Fabric
    • Support for new multisite child fabric, vrf and network delete mode protection flags
    • Only MSD is supported for MultiSite deployments. MFD will be supported in a future release.
  • NEW Feature: Support for managing inter-fabric links and External fabrics with ansible tag support to limit execution
  • Enhanced data model validation and preprocessing
  • Added new model keys for defining fabric name and type

Example:

vxlan:
    fabric:
        name: nac-fabric1
        type: VXLAN_EVPN # Other allowed fabric types: MSD, ISN, External
    global:
        # name: nac-fabric1
        # fabric_type: VXLAN_EVPN

The name and fabric keys under vxlan.global are still supported but will be deprecated in future releases.

Modified

  • Updated model key vxlan.overlay_services to be vxlan.overlay (backwards compatible)

Fixed

0.3.0

Release Date: 2024-11-12

Added

  • Support for selective execution based on data model changes
  • Support for defining custom default values for data model
  • Support for defining custom NDFC Policies
  • Performance improvements for adding devices to a fabric
  • Support for POAP when adding devices to a fabric
  • New connectivity_check role for verifying connectivity and authentication to NDFC
  • Updated tag support to include the following tags:
    • cc_verify
    • cr_manage_policy
    • rr_manage_policy
  • Update to service model keys:
    • VRF attach_group changes to vrf_attach_group` under vxlan.overlay_services.vrfs
    • Network attach_group changes to network_attach_group` under vxlan.overlay_services.networks
  • Support for Spanning-Tree in data model and fabric creation in NDFC 12.2.2 or later
  • Support for IPv6 fabric underlay
  • Support new and update pre-validation rules:
    • 201: Verify a spanning tree protocol mutually exclusive parameters
    • 202: Verify Fabric Underlay Supports Multicast for TRM
    • 203: Verify Fabric Underlay ISIS Authentication
    • 401: Cross Reference VRFs and Networks items in the Service Model
    • 402: Verify VRF elements are enabled in fabric overlay services
    • 403: Verify Network elements are enabled in fabric overlay services
    • 501: Verify Policy Cross Reference Between Policies, Groups, and Switches

Fixed

0.2.0

Release Date: 2024-06-28

Added

  • Support for the following device inventory roles. Only applies to adding devices to a fabric with these role types.
    • border_spine
    • border_gateway
    • border_gateway_spine
    • super_spine
    • border_super_spine
    • border_gateway_super_spine
  • Added SysLog Server Support - Fabric Creation Stage
  • Added DHCP Support and Secondary IP Address Support - Network Creation Stage
  • Support for Ansible Tags
    • Tags to limit execution and target specific roles in the collection
    • Tags to limit execution and target specific stages inside a role

Fixed

0.1.0

Release Date: 2024-06

  • Initial release of the Ansible NetworkAsCode DC VXLAN collection

Added

The following roles have been added to the collection:

This version of the collection includes support for an IPv4 Underlay only. Support for IPv6 Underlay will be available in the next release.