Skip to content

Commit 4bd170a

Browse files
Merge pull request #264 from CiscoDevNet/3.4.2
Release 3.4.2
2 parents 5d4ebde + 1b7c4bb commit 4bd170a

File tree

14 files changed

+1720
-116
lines changed

14 files changed

+1720
-116
lines changed

CHANGELOG.rst

Lines changed: 462 additions & 0 deletions
Large diffs are not rendered by default.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ We welcome community contributions to this collection. If you find problems, ple
173173

174174
## Changelogs
175175

176-
* [Changelog](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/CHANGELOG.md)
176+
* [Changelog](https://github.com/CiscoDevNet/ansible-dcnm/blob/main/CHANGELOG.rst)
177177

178178
## More information
179179

docs/cisco.dcnm.dcnm_interface_module.rst

Lines changed: 47 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -804,7 +804,7 @@ Parameters
804804
<b>Default:</b><br/><div style="color: blue">""</div>
805805
</td>
806806
<td>
807-
<div>IPV4 address of the interface.</div>
807+
<div>IPv4 address of the interface.</div>
808808
</td>
809809
</tr>
810810
<tr>
@@ -822,7 +822,7 @@ Parameters
822822
<b>Default:</b><br/><div style="color: blue">""</div>
823823
</td>
824824
<td>
825-
<div>IPV6 address of the interface.</div>
825+
<div>IPv6 address of the interface.</div>
826826
</td>
827827
</tr>
828828
<tr>
@@ -840,10 +840,16 @@ Parameters
840840
<td>
841841
<ul style="margin: 0; padding: 0"><b>Choices:</b>
842842
<li>lo</li>
843+
<li>fabric</li>
844+
<li>mpls</li>
843845
</ul>
844846
</td>
845847
<td>
846-
<div>Interface mode</div>
848+
<div>There are several modes for loopback interfaces.</div>
849+
<div>Mode &#x27;lo&#x27; is used to create, modify and delete non fabric loopback interfaces using policy &#x27;int_loopback&#x27;.</div>
850+
<div>Mode &#x27;fabric&#x27; is used to modify loopbacks created when the fabric is first created using policy &#x27;int_fabric_loopback_11_1&#x27;</div>
851+
<div>Mode &#x27;mpls&#x27; is used to modify loopbacks created when the fabric is first created using policy &#x27;int_mpls_loopback&#x27;</div>
852+
<div>Mode &#x27;fabric&#x27; and &#x27;mpls&#x27; interfaces can be modified but not created or deleted.</div>
847853
</td>
848854
</tr>
849855
<tr>
@@ -864,6 +870,24 @@ Parameters
864870
<div>Route tag associated with the interface IP.</div>
865871
</td>
866872
</tr>
873+
<tr>
874+
<td class="elbow-placeholder"></td>
875+
<td class="elbow-placeholder"></td>
876+
<td colspan="1">
877+
<div class="ansibleOptionAnchor" id="parameter-"></div>
878+
<b>secondary_ipv4_addr</b>
879+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
880+
<div style="font-size: small">
881+
<span style="color: purple">string</span>
882+
</div>
883+
</td>
884+
<td>
885+
<b>Default:</b><br/><div style="color: blue">""</div>
886+
</td>
887+
<td>
888+
<div>Secondary IP address of the nve interface loopback</div>
889+
</td>
890+
</tr>
867891

868892
<tr>
869893
<td class="elbow-placeholder"></td>
@@ -2589,6 +2613,26 @@ Examples
25892613
- no shutdown
25902614
description: "loopback interface 100 configuration - replaced"
25912615
2616+
## Loopback Interfaces Created During Fabric Creation
2617+
- name: Mange Fabric loopback interfaces
2618+
cisco.dcnm.dcnm_interface:
2619+
fabric: mmudigon-fabric
2620+
state: merged
2621+
config:
2622+
- name: lo1 # This is usually lo0 or lo1 created during fabric creation
2623+
type: lo
2624+
switch:
2625+
- "192.172.1.1" # provide the switch where to deploy the config
2626+
deploy: true # choose from [true, false]
2627+
profile:
2628+
admin_state: false # choose from [true, false]
2629+
mode: fabric # This must be set to 'fabric' for fabric loopback interfaces
2630+
secondary_ipv4_addr: 172.16.5.1 # secondary ipv4 address for loopback interface
2631+
route_tag: "100" # Routing Tag for the interface
2632+
cmds: # Freeform config
2633+
- no shutdown
2634+
description: "Fabric interface managed by Ansible"
2635+
25922636
# To delete or reset all interfaces on all switches in the fabric
25932637
- name: Delete loopback interfaces
25942638
cisco.dcnm.dcnm_interface:

docs/cisco.dcnm.dcnm_links_module.rst

Lines changed: 182 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,47 @@ Parameters
177177
<div>This parameter is required only if template is &#x27;ext_evpn_multisite_overlay_setup&#x27;.</div>
178178
</td>
179179
</tr>
180+
<tr>
181+
<td class="elbow-placeholder"></td>
182+
<td class="elbow-placeholder"></td>
183+
<td colspan="1">
184+
<div class="ansibleOptionAnchor" id="parameter-"></div>
185+
<b>dci_routing_proto</b>
186+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
187+
<div style="font-size: small">
188+
<span style="color: purple">string</span>
189+
</div>
190+
</td>
191+
<td>
192+
<ul style="margin: 0; padding: 0"><b>Choices:</b>
193+
<li><div style="color: blue"><b>is-is</b>&nbsp;&larr;</div></li>
194+
<li>ospf</li>
195+
</ul>
196+
</td>
197+
<td>
198+
<div>Routing protocol used on the DCI MPLS link</div>
199+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup` and `mpls_fabric` is `SR`</div>
200+
</td>
201+
</tr>
202+
<tr>
203+
<td class="elbow-placeholder"></td>
204+
<td class="elbow-placeholder"></td>
205+
<td colspan="1">
206+
<div class="ansibleOptionAnchor" id="parameter-"></div>
207+
<b>dci_routing_tag</b>
208+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
209+
<div style="font-size: small">
210+
<span style="color: purple">string</span>
211+
</div>
212+
</td>
213+
<td>
214+
<b>Default:</b><br/><div style="color: blue">"MPLS_UNDERLAY"</div>
215+
</td>
216+
<td>
217+
<div>Routing Process Tag of DCI Underlay</div>
218+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup`</div>
219+
</td>
220+
</tr>
180221
<tr>
181222
<td class="elbow-placeholder"></td>
182223
<td class="elbow-placeholder"></td>
@@ -216,7 +257,11 @@ Parameters
216257
</td>
217258
<td>
218259
<div>BGP ASN number on the destination fabric.</div>
219-
<div>This parameter is required only if template is &#x27;ext_fabric_setup&#x27; or &#x27;ext_multisite_underlay_setup&#x27;. or &quot;ext_evpn_multisite_overlay_setup&quot;</div>
260+
<div>Required for below templates</div>
261+
<div>ext_fabric_setup</div>
262+
<div>ext_multisite_underlay_setup</div>
263+
<div>ext_evpn_multisite_overlay_setup</div>
264+
<div>ext_vxlan_mpls_overlay_setup</div>
220265
</td>
221266
</tr>
222267
<tr>
@@ -309,6 +354,25 @@ Parameters
309354
<div>This parameter is applicable only if template is &#x27;int_intra_fabric_ipv6_link_local&#x27; or &#x27;int_intra_fabric_num_link&#x27; or &#x27;int_intra_fabric_unnum_link&#x27;.</div>
310355
</td>
311356
</tr>
357+
<tr>
358+
<td class="elbow-placeholder"></td>
359+
<td class="elbow-placeholder"></td>
360+
<td colspan="1">
361+
<div class="ansibleOptionAnchor" id="parameter-"></div>
362+
<b>global_block_range</b>
363+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
364+
<div style="font-size: small">
365+
<span style="color: purple">string</span>
366+
</div>
367+
</td>
368+
<td>
369+
<b>Default:</b><br/><div style="color: blue">"16000-23999"</div>
370+
</td>
371+
<td>
372+
<div>For Segment Routing binding</div>
373+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup` and `mpls_fabric` is `SR`</div>
374+
</td>
375+
</tr>
312376
<tr>
313377
<td class="elbow-placeholder"></td>
314378
<td class="elbow-placeholder"></td>
@@ -387,7 +451,9 @@ Parameters
387451
</td>
388452
<td>
389453
<div>IPV4 address of the source interface with mask.</div>
390-
<div>This parameter is required only if template is &#x27;ext_fabric_setup&#x27; or &#x27;ext_multisite_underlay_setup&#x27;.</div>
454+
<div>Required for below templates</div>
455+
<div>ext_fabric_setup</div>
456+
<div>ext_multisite_underlay_setup</div>
391457
</td>
392458
</tr>
393459
<tr>
@@ -409,6 +475,28 @@ Parameters
409475
<div>This parameter is required only if template is &#x27;ext_multisite_underlay_setup&#x27;.</div>
410476
</td>
411477
</tr>
478+
<tr>
479+
<td class="elbow-placeholder"></td>
480+
<td class="elbow-placeholder"></td>
481+
<td colspan="1">
482+
<div class="ansibleOptionAnchor" id="parameter-"></div>
483+
<b>mpls_fabric</b>
484+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
485+
<div style="font-size: small">
486+
<span style="color: purple">string</span>
487+
</div>
488+
</td>
489+
<td>
490+
<ul style="margin: 0; padding: 0"><b>Choices:</b>
491+
<li><div style="color: blue"><b>SR</b>&nbsp;&larr;</div></li>
492+
<li>LDP</li>
493+
</ul>
494+
</td>
495+
<td>
496+
<div>MPLS LDP or Segment-Routing</div>
497+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup`.</div>
498+
</td>
499+
</tr>
412500
<tr>
413501
<td class="elbow-placeholder"></td>
414502
<td class="elbow-placeholder"></td>
@@ -445,7 +533,31 @@ Parameters
445533
</td>
446534
<td>
447535
<div>IPV4 address of the neighbor switch on the destination fabric.</div>
448-
<div>This parameter is required only if template is &#x27;ext_fabric_setup&#x27; or &#x27;ext_multisite_underlay_setup&#x27; or &quot;ext_evpn_multisite_overlay_setup&quot;</div>
536+
<div>Required for below templates</div>
537+
<div>ext_fabric_setup</div>
538+
<div>ext_multisite_underlay_setup</div>
539+
<div>ext_evpn_multisite_overlay_setup</div>
540+
<div>ext_vxlan_mpls_underlay_setup</div>
541+
<div>ext_vxlan_mpls_overlay_setup</div>
542+
</td>
543+
</tr>
544+
<tr>
545+
<td class="elbow-placeholder"></td>
546+
<td class="elbow-placeholder"></td>
547+
<td colspan="1">
548+
<div class="ansibleOptionAnchor" id="parameter-"></div>
549+
<b>ospf_area_id</b>
550+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
551+
<div style="font-size: small">
552+
<span style="color: purple">string</span>
553+
</div>
554+
</td>
555+
<td>
556+
<b>Default:</b><br/><div style="color: blue">"0.0.0.0"</div>
557+
</td>
558+
<td>
559+
<div>OSPF Area ID in IP address format</div>
560+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup` and `dci_routing_proto` is `ospf`</div>
449561
</td>
450562
</tr>
451563
<tr>
@@ -549,6 +661,25 @@ Parameters
549661
<div>This parameter is required only if template is &#x27;int_intra_fabric_num_link&#x27; or &#x27;ios_xe_int_intra_fabric_num_link&#x27; or &#x27;int_intra_vpc_peer_keep_alive_link&#x27;.</div>
550662
</td>
551663
</tr>
664+
<tr>
665+
<td class="elbow-placeholder"></td>
666+
<td class="elbow-placeholder"></td>
667+
<td colspan="1">
668+
<div class="ansibleOptionAnchor" id="parameter-"></div>
669+
<b>peer1_sr_mpls_index</b>
670+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
671+
<div style="font-size: small">
672+
<span style="color: purple">integer</span>
673+
</div>
674+
</td>
675+
<td>
676+
<b>Default:</b><br/><div style="color: blue">"0"</div>
677+
</td>
678+
<td>
679+
<div>Unique SR SID index for the source border</div>
680+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup` and `mpls_fabric` is `SR`</div>
681+
</td>
682+
</tr>
552683
<tr>
553684
<td class="elbow-placeholder"></td>
554685
<td class="elbow-placeholder"></td>
@@ -650,6 +781,25 @@ Parameters
650781
<div>This parameter is required only if template is &#x27;int_intra_fabric_num_link&#x27; or &#x27;ios_xe_int_intra_fabric_num_link&#x27; or &#x27;int_intra_vpc_peer_keep_alive_link&#x27;.</div>
651782
</td>
652783
</tr>
784+
<tr>
785+
<td class="elbow-placeholder"></td>
786+
<td class="elbow-placeholder"></td>
787+
<td colspan="1">
788+
<div class="ansibleOptionAnchor" id="parameter-"></div>
789+
<b>peer2_sr_mpls_index</b>
790+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
791+
<div style="font-size: small">
792+
<span style="color: purple">integer</span>
793+
</div>
794+
</td>
795+
<td>
796+
<b>Default:</b><br/><div style="color: blue">"0"</div>
797+
</td>
798+
<td>
799+
<div>Unique SR SID index for the destination border</div>
800+
<div>This parameter is applicable only if template is `ext_vxlan_mpls_underlay_setup` and `mpls_fabric` is `SR`</div>
801+
</td>
802+
</tr>
653803
<tr>
654804
<td class="elbow-placeholder"></td>
655805
<td class="elbow-placeholder"></td>
@@ -685,7 +835,11 @@ Parameters
685835
</td>
686836
<td>
687837
<div>BGP ASN number on the source fabric.</div>
688-
<div>This parameter is required only if template is &#x27;ext_fabric_setup&#x27; or &#x27;ext_multisite_underlay_setup&#x27; or &quot;ext_evpn_multisite_overlay_setup&quot;</div>
838+
<div>Required for below templates</div>
839+
<div>ext_fabric_setup</div>
840+
<div>ext_multisite_underlay_setup</div>
841+
<div>ext_evpn_multisite_overlay_setup</div>
842+
<div>ext_vxlan_mpls_overlay_setup</div>
689843
</td>
690844
</tr>
691845
<tr>
@@ -1030,6 +1184,30 @@ Examples
10301184
ebpg_auth_key_type: 3 # optional, required only if ebpg_password_enable is true, and inherit_from_msd
10311185
# is false. Default is 3
10321186
# choose from [3 - 3DES, 7 - Cisco ]
1187+
- dst_fabric: "{{ ansible_unnum_fabric }}" # Destination fabric
1188+
src_interface: "{{ intf_1_5 }}" # Interface on the Source fabric
1189+
dst_interface: "{{ intf_1_5 }}" # Interface on the Destination fabric
1190+
src_device: "{{ ansible_num_switch1 }}" # Device on the Source fabric
1191+
dst_device: "{{ ansible_unnum_switch1 }}" # Device on the Destination fabric
1192+
template: ext_vxlan_mpls_underlay_setup # Template of MPLS handoff underlay link
1193+
profile:
1194+
ipv4_subnet: 193.168.3.1/30 # IP address of interface in src fabric with the mask
1195+
neighbor_ip: 193.168.3.2 # IP address of the interface in dst fabric
1196+
mpls_fabric: LDP # MPLS handoff protocol, choose from [LDP, SR]
1197+
dci_routing_proto: isis # Routing protocol used on the DCI MPLS link, choose from [is-is, ospf]
1198+
1199+
- dst_fabric: "{{ ansible_unnum_fabric }}" # Destination fabric
1200+
src_interface: Loopback101 # Loopback interface on the Source fabric
1201+
dst_interface: Loopback1 # Loopback interface on the Destination fabric
1202+
src_device: "{{ ansible_num_switch1 }}" # Device on the Source fabric
1203+
dst_device: "{{ ansible_unnum_switch1 }}" # Device on the Destination fabric
1204+
template: ext_vxlan_mpls_overlay_setup #Template of MPLS handoff overlay link
1205+
profile:
1206+
neighbor_ip: 2.2.2.2 . # IP address of the loopback interface of destination device
1207+
src_asn: 498278384 # BGP ASN in source fabric
1208+
dst_asn: 498278384 # BGP ASN in destination fabric
1209+
1210+
10331211
10341212
# FABRIC WITH VPC PAIRED SWITCHES
10351213

0 commit comments

Comments
 (0)