CiscoDevNet · mikewiebe · Jun 2, 2025 · Mar 3, 2025 · Mar 6, 2025 · Mar 7, 2025
diff --git a/.gitignore b/.gitignore
@@ -77,3 +77,6 @@ venv.bak/
 
 # mypy
 .mypy_cache/
+
+# Ignore Integration Tests Files Directories
+tests/integration/targets/ndfc_interface/files
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -8,6 +8,33 @@ This project adheres to `Semantic Versioning <http://semver.org/>`_.
 
 .. contents:: ``Release Versions``
 
+`3.8.0`_
+=====================
+
+**Release Date:** ``2025-06-02``
+
+Added
+-----
+
+- Updated ``dcnm_interface`` module 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
+
+
+Fixed
+-----
+
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/28
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/350
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/368
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/372
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/379
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/395
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/398
+- https://github.com/CiscoDevNet/ansible-dcnm/issues/412
+
+
 `3.7.0`_
 =====================
 
@@ -536,6 +563,7 @@ The Ansible Cisco Data Center Network Manager (DCNM) collection includes modules
 - cisco.dcnm.dcnm_network	 - Add and remove Networks from a DCNM managed VXLAN fabric.
 - cisco.dcnm.dcnm_interface - DCNM Ansible Module for managing interfaces.
 
+.. _3.8.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.7.0...3.8.0
 .. _3.7.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.6.0...3.7.0
 .. _3.6.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.5.1...3.6.0
 .. _3.5.1: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.5.0...3.5.1

diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-[![Actions Status](https://github.com/CiscoDevNet/ansible-dcnm/workflows/CI/badge.svg)](https://github.com/CiscoDevNet/ansible-dcnm/actions)
+[![Actions Status](https://github.com/CiscoDevNet/ansible-dcnm/workflows/CI/badge.svg)](https://github.com/CiscoDevNet/ansible-dcnm/actions?branch=develop)
 
 
 # Cisco DCNM Collection
@@ -71,7 +71,7 @@ You can also include it in a `requirements.yml` file and install it with `ansibl
 ---
 collections:
   - name: cisco.dcnm
-    version: 3.7.0
+    version: 3.8.0
 ```
 ## Using this collection
 

diff --git a/docs/cisco.dcnm.dcnm_interface_module.rst b/docs/cisco.dcnm.dcnm_interface_module.rst
@@ -358,6 +358,51 @@ Parameters
                 </td>
             </tr>
 
+            <tr>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>profile_breakout</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">-</span>
+                    </div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>Though the key shown here is &#x27;profile_breakout&#x27; the actual key to be used in playbook is &#x27;profile&#x27;. The key &#x27;profile_breakout&#x27; is used here to logically segregate the interface objects applicable for this profile</div>
+                        <div>Interface must be parent interface. Ex: Ethernet1/49. Short name is not supported.</div>
+                </td>
+            </tr>
+                                <tr>
+                    <td class="elbow-placeholder"></td>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>map</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                         / <span style="color: red">required</span>
+                    </div>
+                </td>
+                <td>
+                        <ul style="margin: 0; padding: 0"><b>Choices:</b>
+                                    <li>10g-4x</li>
+                                    <li>25g-4x</li>
+                                    <li>50g-2x</li>
+                                    <li>50g-4x</li>
+                                    <li>100g-2x</li>
+                                    <li>100g-4x</li>
+                                    <li>200g-2x</li>
+                        </ul>
+                </td>
+                <td>
+                        <div>type of breakout</div>
+                </td>
+            </tr>
+
             <tr>
                     <td class="elbow-placeholder"></td>
                 <td colspan="2">
@@ -390,7 +435,7 @@ Parameters
                         <b>Default:</b><br/><div style="color: blue">""</div>
                 </td>
                 <td>
-                        <div>Vlan for the interface. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;access&#x27;</div>
+                        <div>Vlan for the interface. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;access&#x27; or &#x27;dot1q&#x27;</div>
                 </td>
             </tr>
             <tr>
@@ -606,10 +651,12 @@ Parameters
                                     <li>routed</li>
                                     <li>monitor</li>
                                     <li>epl_routed</li>
+                                    <li>dot1q</li>
                         </ul>
                 </td>
                 <td>
                         <div>Interface mode</div>
+                        <div>When ethernet interface is a PortChannel or vPC member, mode is ignored. The only properties that can be managed for PortChannel or vPC member interfaces are &#x27;admin_state&#x27;, &#x27;description&#x27; and &#x27;cmds&#x27;. All other properties are ignored.</div>
                 </td>
             </tr>
             <tr>
@@ -631,6 +678,24 @@ Parameters
                         <div>Can be specified with any value within 576 and 9216 for routed interface types. If not specified, it defaults to 9216</div>
                 </td>
             </tr>
+            <tr>
+                    <td class="elbow-placeholder"></td>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>native_vlan</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                </td>
+                <td>
+                        <b>Default:</b><br/><div style="color: blue">""</div>
+                </td>
+                <td>
+                        <div>Vlan used as native vlan. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;trunk&#x27;.</div>
+                </td>
+            </tr>
             <tr>
                     <td class="elbow-placeholder"></td>
                     <td class="elbow-placeholder"></td>
@@ -914,7 +979,7 @@ Parameters
                         <b>Default:</b><br/><div style="color: blue">""</div>
                 </td>
                 <td>
-                        <div>Vlan for the interface. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;access&#x27;</div>
+                        <div>Vlan for the interface. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;access&#x27; or &#x27;dot1q&#x27;</div>
                 </td>
             </tr>
             <tr>
@@ -1066,13 +1131,32 @@ Parameters
                                     <li>trunk</li>
                                     <li>access</li>
                                     <li>l3</li>
+                                    <li>dot1q</li>
                                     <li>monitor</li>
                         </ul>
                 </td>
                 <td>
                         <div>Interface mode</div>
                 </td>
             </tr>
+            <tr>
+                    <td class="elbow-placeholder"></td>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>native_vlan</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                </td>
+                <td>
+                        <b>Default:</b><br/><div style="color: blue">""</div>
+                </td>
+                <td>
+                        <div>Vlan used as native vlan. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;trunk&#x27;.</div>
+                </td>
+            </tr>
             <tr>
                     <td class="elbow-placeholder"></td>
                     <td class="elbow-placeholder"></td>
@@ -2246,6 +2330,24 @@ Parameters
                         <div>Member interfaces that are part of this port channel on first peer</div>
                 </td>
             </tr>
+            <tr>
+                    <td class="elbow-placeholder"></td>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>peer1_native_vlan</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                </td>
+                <td>
+                        <b>Default:</b><br/><div style="color: blue">""</div>
+                </td>
+                <td>
+                        <div>Vlan used as native vlan of first peer. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;trunk&#x27;</div>
+                </td>
+            </tr>
             <tr>
                     <td class="elbow-placeholder"></td>
                     <td class="elbow-placeholder"></td>
@@ -2361,6 +2463,24 @@ Parameters
                         <div>Member interfaces that are part of this port channel on second peer</div>
                 </td>
             </tr>
+            <tr>
+                    <td class="elbow-placeholder"></td>
+                    <td class="elbow-placeholder"></td>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>peer2_native_vlan</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                </td>
+                <td>
+                        <b>Default:</b><br/><div style="color: blue">""</div>
+                </td>
+                <td>
+                        <div>Vlan used as native vlan of second peer. This option is applicable only for interfaces whose &#x27;mode&#x27; is &#x27;trunk&#x27;</div>
+                </td>
+            </tr>
             <tr>
                     <td class="elbow-placeholder"></td>
                     <td class="elbow-placeholder"></td>
@@ -2441,6 +2561,7 @@ Parameters
                                     <li>svi</li>
                                     <li>st-fex</li>
                                     <li>aa-fex</li>
+                                    <li>breakout</li>
                         </ul>
                 </td>
                 <td>
@@ -2506,6 +2627,7 @@ Parameters
                                     <li>svi</li>
                                     <li>st_fex</li>
                                     <li>aa_fex</li>
+                                    <li>breakout</li>
                         </ul>
                         <b>Default:</b><br/><div style="color: blue">[]</div>
                 </td>
@@ -3340,6 +3462,71 @@ Examples
               enable_netflow: false                     # optional, flag to enable netflow, default is false
               mode: port_channel_st                     # choose from [port_channel_st], default is "port_channel_st"
 
+    # Dot1q Tunnel host
+
+    - name: Configure dot1q on interface E1/12
+      cisco.dcnm.dcnm_interface:
+        fabric: "{{ ansible_fabric }}"
+        state: merged
+        config:
+          - name: eth1/12
+            type: eth
+            switch:
+              - "{{ ansible_switch1 }}"
+            deploy: true
+            profile:
+            admin_state: true
+            mode: dot1q
+            access_vlan: 41
+            description: "ETH 1/12 Dot1q Tunnel"
+
+    # Breakout interfaces
+
+    - name: Configure breakout interface
+      cisco.dcnm.dcnm_interface:
+        fabric: "{{ ansible_svi_fabric }}"
+        state: merged
+        config:
+          - name: ethernet1/100
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+            deploy: true
+            profile:
+              map: 10g-4x
+          - name: ethernet1/101
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+            deploy: true
+            profile:
+              map: 10g-4x
+          - name: ethernet1/102
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+            deploy: true
+            profile:
+              map: 10g-4x
+
+    - name: Configure breakout interface
+      cisco.dcnm.dcnm_interface:
+        fabric: "{{ ansible_svi_fabric }}"
+        state: deleted
+        config:
+          - name: ethernet1/100
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+          - name: ethernet1/101
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+          - name: ethernet1/102
+            type: breakout
+            switch:
+              - "{{ ansible_switch1 }}"
+
     # QUERY
 
     - name: Query interface details

diff --git a/galaxy.yml b/galaxy.yml
@@ -1,7 +1,7 @@
 ---
 namespace: cisco
 name: dcnm
-version: 3.7.0
+version: 3.8.0
 readme: README.md
 authors:
   - Shrishail Kariyappanavar <nkshrishail>

diff --git a/playbooks/roles/dcnm_interface/dcnm_hosts.yaml b/playbooks/roles/dcnm_interface/dcnm_hosts.yaml
@@ -0,0 +1,15 @@
+all:
+  vars:
+    ansible_user: "admin"
+    ansible_password: "password"
+    ansible_python_interpreter: python
+    ansible_httpapi_validate_certs: False
+    ansible_httpapi_use_ssl: True
+  children:
+    ndfc:
+      vars:
+        ansible_connection: ansible.netcommon.httpapi
+        ansible_network_os: cisco.dcnm.dcnm
+      hosts:
+        nac-ndfc1:
+          ansible_host: 10.0.55.128