Skip to content

Release 3.8.1 #458

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jul 2, 2025
Merged

Release 3.8.1 #458

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
894038c
Fix for Issue #428 "dcnm_fabric returns incorrect results when queryi…
AKDRG Jun 17, 2025
f030c4a
From the ports parameter in the DCNM Network Class, remove "required"…
AKDRG Jun 17, 2025
ae2b9ce
It dcnm network sanity (#418)
neiljohn-gh Jun 18, 2025
c7885d7
Workflow Sanity - Ignore Files Sorting (#439)
AKDRG Jun 25, 2025
1d6f11c
Fix dcnm_network when MSD (#437)
ccoueffe Jun 27, 2025
e8ac65e
dcnm_inventory: Device not reachable fixes (#444)
mikewiebe Jun 27, 2025
cf970b6
Refactor breakout interface part on dcnm_interface.py (#445)
ccoueffe Jun 30, 2025
96fc9f7
3.8.1 Release Prep (#453)
mikewiebe Jul 2, 2025
05f4359
Update galaxy.yml
mikewiebe Jul 2, 2025
a7cc47d
Merge branch 'main' into 3.8.1
mikewiebe Jul 2, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 21 additions & 9 deletions .github/workflows/main.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,15 +21,15 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
ansible: [2.15.12, 2.16.7]
ansible: [2.15.13, 2.16.14, 2.17.12, 2.18.6]
steps:
- name: Check out code
uses: actions/checkout@v2

- name: Set up Python "3.10"
- name: Set up Python "3.11"
uses: actions/setup-python@v1
with:
python-version: "3.10"
python-version: "3.11"

- name: Install ansible-base (v${{ matrix.ansible }})
run: pip install https://github.com/ansible/ansible/archive/v${{ matrix.ansible }}.tar.gz --disable-pip-version-check
Expand All @@ -52,11 +52,17 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
ansible: [2.15.12, 2.16.7]
ansible: [2.15.13, 2.16.14, 2.17.12, 2.18.6]
python: ["3.9", "3.10", "3.11"]
exclude:
- ansible: 2.16.7
- ansible: 2.16.14
python: "3.9"
- ansible: 2.17.12
python: "3.9"
- ansible: 2.18.6
python: "3.9"
- ansible: 2.18.6
python: "3.10"
steps:
- name: Set up Python (v${{ matrix.python }})
uses: actions/setup-python@v1
Expand Down Expand Up @@ -87,15 +93,21 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
ansible: [2.15.12, 2.16.7]
ansible: [2.15.13, 2.16.14, 2.17.12, 2.18.6]
steps:
- name: Set up Python "3.10"
- name: Set up Python "3.11"
uses: actions/setup-python@v1
with:
python-version: "3.10"
python-version: "3.11"

- name: Install ansible-base (v${{ matrix.ansible }})
run: pip install https://github.com/ansible/ansible/archive/v${{ matrix.ansible }}.tar.gz --disable-pip-version-check

- name: Install Pydantic (v2)
run: pip install pydantic==2.11.4

- name: Install DeepDiff (v8.5.0)
run: pip install deepdiff==8.5.0

- name: Install coverage (v7.3.4)
run: pip install coverage==7.3.4
Expand All @@ -120,4 +132,4 @@ jobs:

- name: Generate coverage report
run: coverage report
working-directory: /home/runner/.ansible/collections/ansible_collections/cisco/dcnm
working-directory: /home/runner/.ansible/collections/ansible_collections/cisco/dcnm
3 changes: 2 additions & 1 deletion .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -79,4 +79,5 @@ venv.bak/
.mypy_cache/

# Ignore Integration Tests Files Directories
tests/integration/targets/ndfc_interface/files
tests/integration/targets/ndfc_interface/files
tests/integration/targets/dcnm_network/files
24 changes: 24 additions & 0 deletions CHANGELOG.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,29 @@ This project adheres to `Semantic Versioning <http://semver.org/>`_.

.. contents:: ``Release Versions``

`3.8.1`_
=====================

**Release Date:** ``2025-07-02``

Added
-----

- 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

Fixed
-----

- https://github.com/CiscoDevNet/ansible-dcnm/issues/80
- https://github.com/CiscoDevNet/ansible-dcnm/issues/149
- https://github.com/CiscoDevNet/ansible-dcnm/issues/216
- https://github.com/CiscoDevNet/ansible-dcnm/issues/239
- https://github.com/CiscoDevNet/ansible-dcnm/issues/279
- https://github.com/CiscoDevNet/ansible-dcnm/issues/407
- https://github.com/CiscoDevNet/ansible-dcnm/issues/428
- https://github.com/CiscoDevNet/ansible-dcnm/issues/436

`3.8.0`_
=====================

Expand Down Expand Up @@ -563,6 +586,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.1: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.8.0...3.8.1
.. _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
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.8.0
version: 3.8.1
```
## Using this collection

Expand Down
104 changes: 104 additions & 0 deletions docs/cisco.dcnm.dcnm_interface_module.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -540,6 +540,28 @@ Parameters
<div>Description of the interface</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>duplex</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>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>auto</b>&nbsp;&larr;</div></li>
<li>full</li>
<li>half</li>
</ul>
</td>
<td>
<div>Duplex of the interface. Speed must be set to use duplex.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
Expand Down Expand Up @@ -696,6 +718,27 @@ Parameters
<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>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>orphan_port</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>interface orphan port behavior when switch is in vPC</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
Expand Down Expand Up @@ -1040,6 +1083,28 @@ Parameters
<div>Description of the interface</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>duplex</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>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>auto</b>&nbsp;&larr;</div></li>
<li>full</li>
<li>half</li>
</ul>
</td>
<td>
<div>Duplex of the interface. Speed must be set to use duplex.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
Expand Down Expand Up @@ -1157,6 +1222,27 @@ Parameters
<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>
<td colspan="1">
<div class="ansibleOptionAnchor" id="parameter-"></div>
<b>orphan_port</b>
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
<div style="font-size: small">
<span style="color: purple">boolean</span>
</div>
</td>
<td>
<ul style="margin: 0; padding: 0"><b>Choices:</b>
<li><div style="color: blue"><b>no</b>&nbsp;&larr;</div></li>
<li>yes</li>
</ul>
</td>
<td>
<div>interface orphan port behavior when switch is in vPC</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
Expand Down Expand Up @@ -1577,6 +1663,24 @@ Parameters
<div>Minimum Value (567), Maximum Value (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>route_tag</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>Route tag associated with the interface IP.</div>
</td>
</tr>
<tr>
<td class="elbow-placeholder"></td>
<td class="elbow-placeholder"></td>
Expand Down
2 changes: 1 addition & 1 deletion galaxy.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
namespace: cisco
name: dcnm
version: 3.8.0
version: 3.8.1
readme: README.md
authors:
- Shrishail Kariyappanavar <nkshrishail>
Expand Down
3 changes: 3 additions & 0 deletions playbooks/roles/dcnm_interface/ansible.cfg
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[defaults]
# This ansible.cfg file is only used for testing purposes in this directory.
roles_path = <path to targets>/collections/ansible_collections/cisco/dcnm/tests/integration/targetslh
2 changes: 2 additions & 0 deletions playbooks/roles/dcnm_interface/dcnm_tests.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,8 @@
ansible_eth_intf22: Ethernet1/22
ansible_eth_intf23: Ethernet1/23
ansible_eth_intf24: Ethernet1/24
ansible_parent_intf1: Ethernet1/25
ansible_sub_intf1: Ethernet1/25.100

roles:
- dcnm_interface
74 changes: 58 additions & 16 deletions playbooks/roles/dcnm_network/dcnm_tests.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,29 +7,71 @@
# Modify the vars section with details for your testing setup.
#
# NOTES:
# 1. Ensure that the switches defined by ansible_switch1 and ansible_switch2 are
# 1. Ensure that the switches defined by switch1 and switch2 are
# not vPC Pairs.
- hosts: dcnm
gather_facts: no
connection: ansible.netcommon.httpapi

vars:

#----------------------------------
# Uncomment testcase to run a specific test
# testcase: replaced_net_all
test_fabric: nac-ndfc1
ansible_switch1: 192.168.1.1
ansible_switch2: 192.168.1.2
ansible_sw1_int1: Ethernet1/15
ansible_sw1_int2: Ethernet1/16
ansible_sw1_int3: Ethernet1/17
ansible_sw1_int4: Ethernet1/18
#---
ansible_sw2_int1: Ethernet1/15
ansible_sw2_int2: Ethernet1/16
ansible_sw2_int3: Ethernet1/17
ansible_sw2_int4: Ethernet1/18
ansible_sw2_int5: Ethernet1/19
ansible_sw2_int6: Ethernet1/20

test_data_common:
#---
fabric: fabric-stage
deploy: false
#---
# Resources
#---
sw1: 192.168.1.1
sw2: 192.168.1.2
#---
# Common VRF setup
#---
vrf_1: ansible-vrf-int1
vrf_1_id: 9008011
vrf_1_vlan_id: 500
#---
vrf_2: Tenant-1
vrf_2_id: 9008012
vrf_2_vlan_id: 501
#---
vrf_3: Tenant-2
vrf_3_id: 9008013
vrf_3_vlan_id: 502
#---
# Interfaces
#---
sw1_int1: Ethernet1/15
sw1_int2: Ethernet1/16
sw1_int3: Ethernet1/17
sw1_int4: Ethernet1/18
#---
sw2_int1: Ethernet1/15
sw2_int2: Ethernet1/16
sw2_int3: Ethernet1/17
sw2_int4: Ethernet1/18
sw2_int5: Ethernet1/19
sw2_int6: Ethernet1/20
#---
net1: ansible-net13
net1_net_id: 7005
net1_default_net_template: Default_Network_Universal
net1_net_extension_template: Default_Network_Extension_Universal
net1_vlan_id: 1500
net1_gw_ip_subnet: '192.168.30.1/24'
#---
net2: ansible-net12
net2_net_id: 7002
net2_default_net_template: Default_Network_Universal
net2_net_extension_template: Default_Network_Extension_Universal
net2_vlan_id: 151
net2_gw_ip_subnet: '192.168.40.1/24'
#---
net1_vrf: Tenant-1
net2_vrf: Tenant-2

roles:
- dcnm_network
1 change: 1 addition & 0 deletions playbooks/roles/ndfc_interface/ndfc_tests.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@
port_channel_1: port-channel801
port_channel_2: port-channel802
port_channel_3: port-channel803
port_channel_4: port-channel804

roles:
- ndfc_interface
Empty file added plugins/action/tests/__init__.py
View file
Open in desktop
Empty file.
Loading