Merge pull request #454 from ksator/issue/452

Add ISIS interfaces documentation
aristanetworks · Dec 11, 2020 · 7253e2e · 7253e2e
2 parents 9c25bd3 + f362774
commit 7253e2e
Show file tree

Hide file tree

Showing 7 changed files with 325 additions and 6 deletions.
diff --git a/...ons/arista/avd/molecule/eos_cli_config_gen/documentation/devices/router-isis.md b/...ons/arista/avd/molecule/eos_cli_config_gen/documentation/devices/router-isis.md
@@ -79,7 +79,7 @@ IPv4
 
 | Management Interface | description | VRF | IP Address | Gateway |
 | -------------------- | ----------- | --- | ---------- | ------- |
-| Management1 | oob_management | MGMT | 10.73.255.122/24 | 10.73.255.2 |
+| Management1 | oob_management | MGMT | 10.73.254.11/24 | 10.73.254.253 |
 
 IPv6
 
@@ -94,7 +94,7 @@ IPv6
 interface Management1
    description oob_management
    vrf MGMT
-   ip address 10.73.255.122/24
+   ip address 10.73.254.11/24
 ```
 
 ## DNS Domain
@@ -224,19 +224,111 @@ No VLANs defined
 
 ## Ethernet Interfaces
 
-No Ethernet interface defined
+### Ethernet Interfaces Summary
+
+| Interface | Description | MTU | Type | Mode | Allowed VLANs (Trunk) | Trunk Group | VRF | IP Address | Channel-Group ID | Channel-Group Type |
+| --------- | ----------- | --- | ---- | ---- | --------------------- | ----------- | --- | ---------- | ---------------- | ------------------ |
+| Ethernet1 | P2P_LINK_TO_EAPI-SPINE1_Ethernet1 | 1500 | routed | access | - | - | - | 172.31.255.1/31 | - | - |
+| Ethernet2 | P2P_LINK_TO_EAPI-SPINE2_Ethernet1 | 1500 | routed | access | - | - | - | 172.31.255.3/31 | - | - |
+| Ethernet3 | MLAG_PEER_EAPI-LEAF1B_Ethernet3 | *1500 | *switched | *access | - | - | - | - | 3 | active |
+
+*Inherited from Port-Channel Interface
+
+### Ethernet Interfaces Device Configuration
+
+```eos
+!
+interface Ethernet1
+   description P2P_LINK_TO_EAPI-SPINE1_Ethernet1
+   no switchport
+   ip address 172.31.255.1/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Ethernet2
+   description P2P_LINK_TO_EAPI-SPINE2_Ethernet1
+   no switchport
+   ip address 172.31.255.3/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Ethernet3
+   description MLAG_PEER_EAPI-LEAF1B_Ethernet3
+   channel-group 3 mode active
+```
 
 ## Port-Channel Interfaces
 
 No Port-Channels defined
 
 ## Loopback Interfaces
 
-No Loopback interfaces defined
+### Loopback Interfaces Summary
+
+IPv4
+
+| Interface | Description | VRF | IP Address |
+| --------- | ----------- | --- | ---------- |
+| Loopback0 | EVPN_Overlay_Peering | Global Routing Table | 192.168.255.3/32 |
+| Loopback1 | VTEP_VXLAN_Tunnel_Source | Global Routing Table | 192.168.254.3/32 |
+
+IPv6
+
+| Interface | Description | VRF | IPv6 Address |
+| --------- | ----------- | --- | ------------ |
+| Loopback0 | EVPN_Overlay_Peering | Global Routing Table | - |
+| Loopback1 | VTEP_VXLAN_Tunnel_Source | Global Routing Table | - |
+
+### Loopback Interfaces Device Configuration
+
+```eos
+!
+interface Loopback0
+   description EVPN_Overlay_Peering
+   ip address 192.168.255.3/32
+   isis enable EVPN_UNDERLAY
+   isis passive
+!
+interface Loopback1
+   description VTEP_VXLAN_Tunnel_Source
+   ip address 192.168.254.3/32
+   isis enable EVPN_UNDERLAY
+   isis passive
+```
 
 ## VLAN Interfaces
 
-No VLAN interfaces defined
+### VLAN Interfaces Summary
+
+| Interface | Description | VRF | IP Address | IP Address Virtual | IP Router Virtual Address (vARP) |
+| --------- | ----------- | --- | ---------- | ------------------ | -------------------------------- |
+| Vlan110 | PR01-DEMO | TENANT_A_PROJECT01 | - | 10.1.10.254/24 | - |
+| Vlan4093 | MLAG_PEER_L3_PEERING | Global Routing Table | 10.255.251.0/31 | - | - |
+| Vlan4094 | MLAG_PEER | Global Routing Table | 10.255.252.0/31 | - | - |
+
+### VLAN Interfaces Device Configuration
+
+```eos
+!
+interface Vlan110
+   description PR01-DEMO
+   vrf TENANT_A_PROJECT01
+   ip address virtual 10.1.10.254/24
+!
+interface Vlan4093
+   description MLAG_PEER_L3_PEERING
+   ip address 10.255.251.0/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Vlan4094
+   description MLAG_PEER
+   no autostate
+   ip address 10.255.252.0/31
+```
 
 ## VXLAN Interface
 
@@ -285,6 +377,16 @@ IP Virtual Router MAC Address is not defined
 | Type | level-2 |
 | Address Family | ipv4 unicast |
 
+### ISIS interfaces Summary
+
+| Interface | ISIS instance | ISIS metric | Interface mode |
+| -------- | -------- | -------- | -------- |
+| Ethernet1 | EVPN_UNDERLAY |  50 |  point-to-point |
+| Ethernet2 | EVPN_UNDERLAY |  50 |  point-to-point |
+| Vlan4093 | EVPN_UNDERLAY |  50 |  point-to-point |
+| Loopback0 | EVPN_UNDERLAY |  - |  passive |
+| Loopback1 | EVPN_UNDERLAY |  - |  passive |
+
 ### Router ISIS Device Configuration
 
 ```eos

diff --git a/ansible_collections/arista/avd/molecule/eos_cli_config_gen/intended/configs/router-isis.cfg b/ansible_collections/arista/avd/molecule/eos_cli_config_gen/intended/configs/router-isis.cfg
@@ -6,10 +6,59 @@ hostname router-isis
 !
 no aaa root
 !
+interface Ethernet1
+   description P2P_LINK_TO_EAPI-SPINE1_Ethernet1
+   no switchport
+   ip address 172.31.255.1/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Ethernet2
+   description P2P_LINK_TO_EAPI-SPINE2_Ethernet1
+   no switchport
+   ip address 172.31.255.3/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Ethernet3
+   description MLAG_PEER_EAPI-LEAF1B_Ethernet3
+   channel-group 3 mode active
+!
+interface Loopback0
+   description EVPN_Overlay_Peering
+   ip address 192.168.255.3/32
+   isis enable EVPN_UNDERLAY
+   isis passive
+!
+interface Loopback1
+   description VTEP_VXLAN_Tunnel_Source
+   ip address 192.168.254.3/32
+   isis enable EVPN_UNDERLAY
+   isis passive
+!
 interface Management1
    description oob_management
    vrf MGMT
-   ip address 10.73.255.122/24
+   ip address 10.73.254.11/24
+!
+interface Vlan110
+   description PR01-DEMO
+   vrf TENANT_A_PROJECT01
+   ip address virtual 10.1.10.254/24
+!
+interface Vlan4093
+   description MLAG_PEER_L3_PEERING
+   ip address 10.255.251.0/31
+   isis enable EVPN_UNDERLAY
+   isis metric 50
+   isis network point-to-point
+!
+interface Vlan4094
+   description MLAG_PEER
+   no autostate
+   ip address 10.255.252.0/31
 router isis EVPN_UNDERLAY
    net 49.0001.0001.0001.0001.00
    is-type level-2

diff --git a/...le_collections/arista/avd/molecule/eos_cli_config_gen/inventory/host_vars/router-isis.yml b/...le_collections/arista/avd/molecule/eos_cli_config_gen/inventory/host_vars/router-isis.yml
@@ -12,3 +12,80 @@ router_isis:
   address_family: ['ipv4 unicast']
   isis_af_defaults:
     - maximum-paths 2
+
+### Ethernet Interfaces ###
+ethernet_interfaces:
+  Ethernet1:
+    peer: EAPI-SPINE1
+    peer_interface: Ethernet1
+    peer_type: spine
+    description: P2P_LINK_TO_EAPI-SPINE1_Ethernet1
+    mtu: 1500
+    type: routed
+    ip_address: 172.31.255.1/31
+    isis_enable: EVPN_UNDERLAY
+    isis_metric: 50
+    isis_network_point_to_point: true
+  Ethernet2:
+    peer: EAPI-SPINE2
+    peer_interface: Ethernet1
+    peer_type: spine
+    description: P2P_LINK_TO_EAPI-SPINE2_Ethernet1
+    mtu: 1500
+    type: routed
+    ip_address: 172.31.255.3/31
+    isis_enable: EVPN_UNDERLAY
+    isis_metric: 50
+    isis_network_point_to_point: true
+  Ethernet3:
+    peer: EAPI-LEAF1B
+    peer_interface: Ethernet3
+    peer_type: mlag_peer
+    description: MLAG_PEER_EAPI-LEAF1B_Ethernet3
+    channel_group:
+      id: 3
+      mode: active
+
+### Loopback Interfaces ###
+loopback_interfaces:
+  Loopback0:
+    description: EVPN_Overlay_Peering
+    ip_address: 192.168.255.3/32
+    isis_enable: EVPN_UNDERLAY
+    isis_passive: true
+
+  Loopback1:
+    description: VTEP_VXLAN_Tunnel_Source
+    ip_address: 192.168.254.3/32
+    isis_enable: EVPN_UNDERLAY
+    isis_passive: true
+
+### Management Interfaces ###
+management_interfaces:
+  Management1:
+    description: oob_management
+    vrf: MGMT
+    ip_address: 10.73.254.11/24
+    gateway: 10.73.254.253
+
+### VLAN Interfaces ###
+vlan_interfaces:
+  Vlan4093:
+    description: MLAG_PEER_L3_PEERING
+    ip_address: 10.255.251.0/31
+    isis_enable: EVPN_UNDERLAY
+    isis_metric: 50
+    isis_network_point_to_point: true
+  Vlan4094:
+    description: MLAG_PEER
+    ip_address: 10.255.252.0/31
+    no_autostate: true
+    mtu: 1500
+## Tenant_A ##
+  Vlan110:
+    tenant: Tenant_A
+    tags: ['DC1']
+    description: PR01-DEMO
+    shutdown: false
+    vrf: TENANT_A_PROJECT01
+    ip_address_virtual: 10.1.10.254/24
diff --git a/...ctions/arista/avd/roles/eos_cli_config_gen/templates/documentation/ethernet-interfaces.j2 b/...ctions/arista/avd/roles/eos_cli_config_gen/templates/documentation/ethernet-interfaces.j2
@@ -26,6 +26,25 @@
 
 *Inherited from Port-Channel Interface
 
+{%     set ethernet_interface_isis = namespace() %}
+{%     set ethernet_interface_isis.configured = false %}
+{%     for ethernet_interface in ethernet_interfaces | arista.avd.natural_sort %}
+{%          if ethernet_interfaces[ethernet_interface].isis_enable is defined %}
+{%              set ethernet_interface_isis.configured = true %}
+{%          endif %}
+{%     endfor %}
+{%     if ethernet_interface_isis.configured == true %}
+#### ISIS
+
+| Interface | ISIS instance | ISIS metric | Interface mode |
+| -------- | -------- | -------- | -------- |
+{%         for ethernet_interface in ethernet_interfaces | arista.avd.natural_sort %}
+{%             if ethernet_interfaces[ethernet_interface].isis_enable is defined and ethernet_interfaces[ethernet_interface].isis_enable is not none %}
+| {{ ethernet_interface }} | {{ ethernet_interfaces[ethernet_interface].isis_enable }} |  {{ ethernet_interfaces[ethernet_interface].isis_metric | default('-') }} | {% if ethernet_interfaces[ethernet_interface].isis_network_point_to_point is defined and ethernet_interfaces[ethernet_interface].isis_network_point_to_point is not none %} point-to-point {% elif ethernet_interfaces[ethernet_interface].isis_passive is defined and ethernet_interfaces[ethernet_interface].isis_passive is not none %} passive {% else %} - {% endif %}|
+{%             endif %}
+{%          endfor %}
+{%     endif %}
+
 ### Ethernet Interfaces Device Configuration
 
 ```eos

diff --git a/...ctions/arista/avd/roles/eos_cli_config_gen/templates/documentation/loopback-interfaces.j2 b/...ctions/arista/avd/roles/eos_cli_config_gen/templates/documentation/loopback-interfaces.j2
@@ -21,6 +21,25 @@
 {%-        if loopback_interfaces[loopback_interface].ipv6_address is defined %} {{ loopback_interfaces[loopback_interface].ipv6_address }} {% else %} - {% endif -%} |
 {%     endfor %}
 
+{%     set loopback_interface_isis = namespace() %}
+{%     set loopback_interface_isis.configured = false %}
+{%     for loopback_interface in loopback_interfaces | arista.avd.natural_sort %}
+{%          if loopback_interfaces[loopback_interface].isis_enable is defined %}
+{%              set loopback_interface_isis.configured = true %}
+{%          endif %}
+{%     endfor %}
+{%     if loopback_interface_isis.configured == true %}
+#### ISIS
+
+| Interface | ISIS instance | ISIS metric | Interface mode |
+| -------- | -------- | -------- | -------- |
+{%         for loopback_interface in loopback_interfaces | arista.avd.natural_sort %}
+{%             if loopback_interfaces[loopback_interface].isis_enable is defined and loopback_interfaces[loopback_interface].isis_enable is not none %}
+| {{ loopback_interface }} | {{ loopback_interfaces[loopback_interface].isis_enable }} |  {{ loopback_interfaces[loopback_interface].isis_metric | default('-') }} | {% if loopback_interfaces[loopback_interface].isis_network_point_to_point is defined and loopback_interfaces[loopback_interface].isis_network_point_to_point is not none %} point-to-point {% elif loopback_interfaces[loopback_interface].isis_passive is defined and loopback_interfaces[loopback_interface].isis_passive is not none %} passive {% else %} - {% endif %}|
+{%             endif %}
+{%          endfor %}
+{%     endif %}
+
 ### Loopback Interfaces Device Configuration
 
 ```eos

diff --git a/...le_collections/arista/avd/roles/eos_cli_config_gen/templates/documentation/router-isis.j2 b/...le_collections/arista/avd/roles/eos_cli_config_gen/templates/documentation/router-isis.j2
@@ -16,6 +16,40 @@
 | Address Family | {% for af in router_isis.address_family %}{{ af }} {% endfor %}|
 {%     endif %}
 
+### ISIS Interfaces Summary
+
+| Interface | ISIS Instance | ISIS Metric | Interface Mode |
+| -------- | -------- | -------- | -------- |
+{# ethernet interfaces #}
+{# ------- #}
+{%      if ethernet_interfaces is defined and ethernet_interfaces is not none %}
+{%          for ethernet_interface in ethernet_interfaces | arista.avd.natural_sort %}
+{%              if ethernet_interfaces[ethernet_interface].isis_enable is defined and ethernet_interfaces[ethernet_interface].isis_enable is not none %}
+| {{  ethernet_interface }} | {{ ethernet_interfaces[ethernet_interface].isis_enable }} |  {{ ethernet_interfaces[ethernet_interface].isis_metric | default('-') }} | {% if ethernet_interfaces[ethernet_interface].isis_network_point_to_point is defined and ethernet_interfaces[ethernet_interface].isis_network_point_to_point is not none %} point-to-point {% elif ethernet_interfaces[ethernet_interface].isis_passive is defined and ethernet_interfaces[ethernet_interface].isis_passive is not none %} passive {% else %} - {% endif %}|
+{%              endif %}
+{%          endfor %}
+{%      endif %}
+{# ------- #}
+{# vlan interfaces #}
+{# ------- #}
+{%      if vlan_interfaces is defined and vlan_interfaces is not none %}
+{%          for vlan_interface in vlan_interfaces | arista.avd.natural_sort %}
+{%              if vlan_interfaces[vlan_interface].isis_enable is defined and vlan_interfaces[vlan_interface].isis_enable is not none %}
+| {{ vlan_interface }} | {{ vlan_interfaces[vlan_interface].isis_enable }} |  {{ vlan_interfaces[vlan_interface].isis_metric | default('-') }} | {% if vlan_interfaces[vlan_interface].isis_network_point_to_point is defined and vlan_interfaces[vlan_interface].isis_network_point_to_point is not none %} point-to-point {% elif vlan_interfaces[vlan_interface].isis_passive is defined and vlan_interfaces[vlan_interface].isis_passive is not none %} passive {% else %} - {% endif %}|
+{%              endif %}
+{%          endfor %}
+{%      endif %}
+{# ------- #}
+{# loopback interfaces #}
+{# ------- #}
+{%      if loopback_interfaces is defined and loopback_interfaces is not none %}
+{%          for loopback_interface in loopback_interfaces | arista.avd.natural_sort %}
+{%              if loopback_interfaces[loopback_interface].isis_enable is defined and loopback_interfaces[loopback_interface].isis_enable is not none %}
+| {{ loopback_interface }} | {{ loopback_interfaces[loopback_interface].isis_enable }} |  {{ loopback_interfaces[loopback_interface].isis_metric | default('-') }} | {% if loopback_interfaces[loopback_interface].isis_network_point_to_point is defined and loopback_interfaces[loopback_interface].isis_network_point_to_point is not none %} point-to-point {% elif loopback_interfaces[loopback_interface].isis_passive is defined and loopback_interfaces[loopback_interface].isis_passive is not none %} passive {% else %} - {% endif %}|
+{%              endif %}
+{%          endfor %}
+{%      endif %}
+
 ### Router ISIS Device Configuration
 
 ```eos