Skip to content

Commit fc43621

Browse files
mikewiebemikewiebe
authored
Merge pull request #378 from CiscoDevNet/3.7.0
Release 3.7.0
2 parents c481211 + 22ac5a5 commit fc43621

File tree

140 files changed

+11382
-3221
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

140 files changed

+11382
-3221
lines changed

‎CHANGELOG.rst

+32
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,37 @@ This project adheres to `Semantic Versioning <http://semver.org/>`_.
88

99
.. contents:: ``Release Versions``
1010

11+
`3.7.0`_
12+
=====================
13+
14+
**Release Date:** ``2025-02-28``
15+
16+
Added
17+
-----
18+
19+
- The following new modules are included in this release
20+
- ``dcnm_log`` - Module for logging messages based on environment variable ``NDFC_LOGGING_CONFIG``
21+
- Dynamic inventory for ansible-dcnm repository integration tests
22+
- Support for virtual peer link in ``dcnm_vpc_pair`` module
23+
- Support for pre-provision workflows when using ``dcnm_vpc_pair`` and ``dcnm_interface`` module
24+
- Support for port-channel sub-interfaces in ``dcnm_interface`` module
25+
26+
27+
Fixed
28+
-----
29+
30+
- Bug when ``deploy`` flag set to ``false`` in ``dcnm_vrf`` and ``dcnm_network`` modules
31+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/338
32+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/343
33+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/347
34+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/351
35+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/353
36+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/356
37+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/357
38+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/358
39+
- https://github.com/CiscoDevNet/ansible-dcnm/issues/360
40+
41+
1142
`3.6.0`_
1243
=====================
1344

@@ -505,6 +536,7 @@ The Ansible Cisco Data Center Network Manager (DCNM) collection includes modules
505536
- cisco.dcnm.dcnm_network - Add and remove Networks from a DCNM managed VXLAN fabric.
506537
- cisco.dcnm.dcnm_interface - DCNM Ansible Module for managing interfaces.
507538

539+
.. _3.7.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.6.0...3.7.0
508540
.. _3.6.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.5.1...3.6.0
509541
.. _3.5.1: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.5.0...3.5.1
510542
.. _3.5.0: https://github.com/CiscoDevNet/ansible-dcnm/compare/3.4.3...3.5.0

‎README.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,7 @@ Name | Description
4242
[cisco.dcnm.dcnm_interface](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_interface_module.rst)|DCNM Ansible Module for managing interfaces.
4343
[cisco.dcnm.dcnm_inventory](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_inventory_module.rst)|Add and remove Switches from a DCNM managed VXLAN fabric.
4444
[cisco.dcnm.dcnm_links](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_links_module.rst)|DCNM ansible module for managing Links.
45+
[cisco.dcnm.dcnm_log](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_log_module.rst)|Log messages according to the configuration pointed to by the environment variable NDFC_LOGGING_CONFIG.
4546
[cisco.dcnm.dcnm_maintenance_mode](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_maintenance_mode_module.rst)|Manage Maintenance Mode Configuration of NX-OS Switches.
4647
[cisco.dcnm.dcnm_network](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_network_module.rst)|Add and remove Networks from a DCNM managed VXLAN fabric.
4748
[cisco.dcnm.dcnm_policy](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/docs/cisco.dcnm.dcnm_policy_module.rst)|DCNM Ansible Module for managing policies.
@@ -70,7 +71,7 @@ You can also include it in a `requirements.yml` file and install it with `ansibl
7071
---
7172
collections:
7273
- name: cisco.dcnm
73-
version: 3.6.0
74+
version: 3.7.0
7475
```
7576
## Using this collection
7677
@@ -191,7 +192,7 @@ We welcome community contributions to this collection. If you find problems, ple
191192

192193
## Licensing
193194

194-
Copyright (c) 2020-2024 Cisco and/or its affiliates.
195+
Copyright (c) 2020-2025 Cisco and/or its affiliates.
195196

196197
Licensed under the Apache License, Version 2.0 (the "License");
197198
you may not use this file except in compliance with the License.

‎docs/cisco.dcnm.dcnm_log_module.rst

+156
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
.. _cisco.dcnm.dcnm_log_module:
2+
3+
4+
*******************
5+
cisco.dcnm.dcnm_log
6+
*******************
7+
8+
**Log messages according to the configuration pointed to by the environment variable NDFC_LOGGING_CONFIG.**
9+
10+
11+
Version added: 3.6.0
12+
13+
.. contents::
14+
:local:
15+
:depth: 1
16+
17+
18+
Synopsis
19+
--------
20+
- Log messages according to the configuration pointed to by the environment variable NDFC_LOGGING_CONFIG.
21+
22+
23+
24+
25+
Parameters
26+
----------
27+
28+
.. raw:: html
29+
30+
<table border=0 cellpadding=0 class="documentation-table">
31+
<tr>
32+
<th colspan="1">Parameter</th>
33+
<th>Choices/<font color="blue">Defaults</font></th>
34+
<th width="100%">Comments</th>
35+
</tr>
36+
<tr>
37+
<td colspan="1">
38+
<div class="ansibleOptionAnchor" id="parameter-"></div>
39+
<b>msg</b>
40+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
41+
<div style="font-size: small">
42+
<span style="color: purple">string</span>
43+
/ <span style="color: red">required</span>
44+
</div>
45+
</td>
46+
<td>
47+
</td>
48+
<td>
49+
<div>The message to log</div>
50+
</td>
51+
</tr>
52+
<tr>
53+
<td colspan="1">
54+
<div class="ansibleOptionAnchor" id="parameter-"></div>
55+
<b>severity</b>
56+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
57+
<div style="font-size: small">
58+
<span style="color: purple">string</span>
59+
</div>
60+
</td>
61+
<td>
62+
<ul style="margin: 0; padding: 0"><b>Choices:</b>
63+
<li>CRITICAL</li>
64+
<li><div style="color: blue"><b>DEBUG</b>&nbsp;&larr;</div></li>
65+
<li>ERROR</li>
66+
<li>INFO</li>
67+
<li>WARNING</li>
68+
</ul>
69+
</td>
70+
<td>
71+
<div>Case-sensitive logging severity with which to log the msg (must be UPPERCASE)</div>
72+
</td>
73+
</tr>
74+
</table>
75+
<br/>
76+
77+
78+
79+
80+
Examples
81+
--------
82+
83+
.. code-block:: yaml
84+
85+
# This module can be used to correlate Ansible DCNM task execution with the
86+
# log messages generated by the DCNM Ansible modules (when the NDFC_LOGGING_CONFIG
87+
# environment variable is set to point to a valid python logging configuration)
88+
#
89+
90+
- name: Log
91+
cisco.dcnm.dcnm_log:
92+
msg: dcnm_vrf.merged - Create VRF myVrf
93+
severity: INFO
94+
95+
- name: dcnm_vrf.merged - Create VRF myVrf
96+
cisco.dcnm.dcnm_vrf:
97+
fabric: vxlan-fabric
98+
state: merged
99+
config:
100+
- vrf_name: myVrf
101+
vrf_id: 9008011
102+
vrf_template: Default_VRF_Universal
103+
vrf_extension_template: Default_VRF_Extension_Universal
104+
vlan_id: 2000
105+
service_vrf_template: null
106+
attach:
107+
- ip_address: 192.168.1.224
108+
- ip_address: 192.168.1.225
109+
110+
- name: Log
111+
cisco.dcnm.dcnm_log:
112+
msg: dcnm_vrf.merged - Create VRF myVrf DONE
113+
severity: INFO
114+
115+
116+
117+
Return Values
118+
-------------
119+
Common return values are documented `here <https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values>`_, the following are the fields unique to this module:
120+
121+
.. raw:: html
122+
123+
<table border=0 cellpadding=0 class="documentation-table">
124+
<tr>
125+
<th colspan="1">Key</th>
126+
<th>Returned</th>
127+
<th width="100%">Description</th>
128+
</tr>
129+
<tr>
130+
<td colspan="1">
131+
<div class="ansibleOptionAnchor" id="return-"></div>
132+
<b>response</b>
133+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
134+
<div style="font-size: small">
135+
<span style="color: purple">dictionary</span>
136+
/ <span style="color: purple">elements=dictionary</span>
137+
</div>
138+
</td>
139+
<td>always</td>
140+
<td>
141+
<div>result dictionary containing keys changed, msg, results, skipped</div>
142+
<br/>
143+
</td>
144+
</tr>
145+
</table>
146+
<br/><br/>
147+
148+
149+
Status
150+
------
151+
152+
153+
Authors
154+
~~~~~~~
155+
156+
- Allen Robel (@quantumonion)

‎docs/cisco.dcnm.dcnm_maintenance_mode_module.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ cisco.dcnm.dcnm_maintenance_mode
88
**Manage Maintenance Mode Configuration of NX-OS Switches.**
99

1010

11-
Version added: 3.5.0
11+
Version added: 3.6.0
1212

1313
.. contents::
1414
:local:

‎galaxy.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
namespace: cisco
33
name: dcnm
4-
version: 3.6.0
4+
version: 3.7.0
55
readme: README.md
66
authors:
77
- Shrishail Kariyappanavar <nkshrishail>

0 commit comments

Comments
 (0)