aristanetworks · carlbuchmann · Jul 23, 2021 · Jun 4, 2021 · Jun 4, 2021 · Jun 4, 2021
@@ -219,6 +219,11 @@ jobs:
           - 'evpn_underlay_isis_overlay_ibgp'
           - 'eos_designs-twodc-5stage-clos'
           - 'evpn_underlay_rfc5549_overlay_ebgp'
+          - 'upgrade_v2.x_to_v3.0_evpn_underlay_ebgp_overlay_ebgp'
+          - 'upgrade_v2.x_to_v3.0_evpn_underlay_ospf_overlay_ebgp'
+          - 'upgrade_v2.x_to_v3.0_evpn_underlay_isis_overlay_ibgp'
+          - 'upgrade_v2.x_to_v3.0_eos_designs-twodc-5stage-clos'
+          - 'upgrade_v2.x_to_v3.0_evpn_underlay_rfc5549_overlay_ebgp'
         ansible_version: ['ansible>=2.10,<2.11', 'ansible>=3.3']
     needs: [ pre_commit ]
     if: needs.file-changes.outputs.eos_design == 'true' || needs.file-changes.outputs.config_gen == 'true' || startsWith(github.ref, 'refs/heads/release')

@@ -43,7 +43,7 @@ Provide major enhancements and data model has been updated!
 > - eos_l3ls_evpn
 > - eos_cli_config_gen.
 >
-> A  [migration role](https://www.avd.sh/en/latest/roles/upgrade_tools/) is provided to help update data structure for abstrated data model roles only, i.e. eos_l3ls_evpn.
+> A  [migration role](https://www.avd.sh/en/latest/roles/upgrade_tools/) is provided to help update data structure for abstracted data model roles only, i.e. eos_l3ls_evpn.
 
 **New Roles:**
 

@@ -0,0 +1,206 @@
+# Release Notes For Ansible AVD 3.x.x
+
+Documentation for AVD version `3.x.x` -> -> Placeholder update before release <-
+
+!!! warning "eos_l3ls_evpn deprecation warning"
+    Starting arista.avd version 2.0, eos_l3ls_evpn has been renamed to eos_designs and a fallback mechanism has been deployed to support both name. Please update your playbooks accordingly as eos_l3ls_evpn will be removed in a future release.
+
+## Release 3.0.0-RC1
+
+Provides major enhancements and data model has been updated!
+
+!!! info "Data model Updated"
+    Data model updated for roles:
+
+        - eos_designs.
+        - eos_cli_config_gen.
+
+    A  [migration role](https://www.avd.sh/en/devel/roles/upgrade_tools/)  is provided to help update data structure for abstracted data model roles only, i.e. eos_designs.
+
+!!! danger "Pre-release"
+    temp link update to 'latest' before official release
+
+### New Requirements
+
+`cvprac` must be upgraded to version 1.0.7 or higher.
+
+```cfg
+$ pip install --upgrade cvprac>=1.0.7
+```
+
+### Data model modifications
+
+This section provides an overview of only the data model that have ***changed*** from the previous release that would require user modifications. See the release notes and role documentation for all new additions.
+
+Changes to eos_designs role:
+
+Use migration role `arista.avd.upgrade_tools` to assist with the transition!
+
+- __spine variables:__
+
+  - New `spine.defaults.uplink_switches` variable based on keys in `super_spine.nodes`
+  - New `spine.defaults.isis_maximum_paths` based on max_spines * max_l3leaf_to_spine_links
+  - Change from `spine.{{ var }}` to `spine.defaults.{{ var }}`
+  - Change from `overlay_loopback_network_summary` to `spine.defaults.loopback_ipv4_pool`
+  - Change from `spine.uplinks_to_super_spine_interfaces` to `spine.defaults.uplink_interfaces`
+  - Change from `max_super_spines` to `spine.defaults.max_uplink_switches`
+  - Change from `max_spine_to_super_spine_links` to `spine.defaults.max_parallel_uplinks`
+  - Change from `super_spine_underlay_p2p_network_summary` to `spine.defaults.uplink_ipv4_pool`
+  - Change from `p2p_uplinks_ptp` to `spine.defaults.uplink_ptp`
+  - Change from `spine_bgp_defaults` to `spine.defaults.bgp_defaults`
+  - Change from old default value of `spine_bgp_defaults` to `spine.defaults.bgp_defaults`
+  - Change from `isis_site_id.0000` to `spine.defaults.isis_system_id_prefix`
+  - Change from `mlag_ips.mlag_peer` to `spine.defaults.mlag_peer_ipv4_pool`
+  - Change from `mlag_ips.mlag_peer_l3_ipv4_pool` to `spine.defaults.mlag_peer_l3_ipv4_pool`
+  - Change from `spine.nodes.{{ node }}.super_spine_interfaces` to `spine.nodes.{{ node }}.uplink_switch_interfaces`
+
+- __l3leaf variables:__
+
+  - New `loopback_network_offset variable` based on `max_spines` or length of `spine.nodes`
+  - New `l3leaf.defaults.isis_maximum_paths` based on `max_spines` * `max_l3leaf_to_spine_links`
+  - Change from `overlay_loopback_network_summary` to `l3leaf.defaults.loopback_ipv4_pool`
+  - Change from `vtep_loopback_network_summary` to `l3leaf.defaults.vtep_loopback_ipv4_pool`
+  - Change from `l3leaf.defaults.uplink_to_spine_interfaces` to `l3leaf.defaults.uplink_interfaces`
+  - Change from `l3leaf.defaults.spines` to `l3leaf.defaults.uplink_switches`
+  - Change from `max_spines` to `l3leaf.defaults.max_uplink_switches`
+  - Change from `max_l3leaf_to_spine_links` to `l3leaf.defaults.max_parallel_uplinks`
+  - Change from `underlay_p2p_network_summary` to `l3leaf.defaults.uplink_ipv4_pool`
+  - Change from `p2p_uplinks_ptp.*` to `l3leaf.defaults.uplink_ptp.*`
+  - Change from `l3leaf.defaults.p2p_link_interface_speed` to `l3leaf.defaults.uplink_interface_speed`
+  - Change from `mlag_ips.mlag_peer` to `spine.defaults.mlag_peer_ipv4_pool`
+  - Change from `mlag_ips.mlag_peer_l3_ipv4_pool` to `spine.defaults.mlag_peer_l3_ipv4_pool`
+  - Change from `leaf_bgp_defaults` to `l3leaf.defaults.bgp_defaults`
+  - Change from `old default value of leaf_bgp_defaults` to `l3leaf.defaults.bgp_defaults`
+  - Change from `isis_site_id.0001` to `l3leaf.defaults.isis_system_id_prefix`
+  - Change from `l3leaf.node_groups.{{ node_group }}.uplink_to_spine_interfaces` to `l3leaf.node_groups.{{ node_group }}.uplink_interfaces`
+  - Change from `l3leaf.node_groups.{{ node_group }}.spines` to `l3leaf.node_groups.{{ node_group }}.uplink_switches`
+  - Change from `l3leaf.node_groups.{{ node_group }}.p2p_link_interface_speed` to `l3leaf.node_groups.{{ node_group }}.uplink_interface_speed`
+  - Change from `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.spine_interfaces` to `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_switch_interfaces`
+  - Change from `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_to_spine_interfaces` to `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_interfaces`
+  - Change from `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.spines` to `l3leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_switches`
+
+- __l2leaf variables:__
+
+  - Change from `l2leaf.defaults.parent_l3leafs` to `l2leaf.defaults.uplink_switches`
+  - Change from `l2leaf_inband_management_subnet` to `l2leaf.defaults.inband_management_subnet`
+  - Change from `l2leaf_inband_management_vlan` to `l2leaf.defaults.inband_management_vlan`
+  - Change from `l2leaf.defaults.p2p_link_interface_speed` to `l2leaf.defaults.uplink_interface_speed`
+  - Change from `mlag_ips.mlag_peer` to `spine.defaults.mlag_peer_ipv4_pool`
+  - Change from `mlag_ips.mlag_peer_l3_ipv4_pool` to `spine.defaults.mlag_peer_l3_ipv4_pool`
+  - Change from `l2leaf.node_groups.{{ node_group }}.parent_l3leafs` to `l2leaf.node_groups.{{ node_group }}.uplink_switches`
+  - Change from `l2leaf.node_groups.{{ node_group }}.p2p_link_interface_speed` to `l2leaf.node_groups.{{ node_group }}.uplink_interface_speed`
+  - Change from `l2leaf.node_groups.{{ node_group }}.nodes.{{ node }}.l3leaf_interfaces` to `l2leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_switch_interfaces`
+  - Change from `l2leaf.node_groups.{{ node_group }}.nodes.{{ node }}.parent_l3leafs` to `l2leaf.node_groups.{{ node_group }}.nodes.{{ node }}.uplink_switches`
+
+- __super-spine variables:__
+
+  - Change from `super_spine.{{ var }}` to `super_spine.defaults.{{ var }}
+  - Change from `super_spine_loopback_network_summary` to `super_spine.defaults.loopback_ipv4_pool
+  - Change from `super_spine_bgp_defaults` to `super_spine.defaults.bgp_defaults
+  - Change from `old default value of super_spine_bgp_defaults` to `super_spine.defaults.bgp_defaults
+  - Change in ip addressing math for P2P uplinks from spine` to `super-spine links.
+    - The old model can be retained by updating` to `the v2.x.x addressing scheme:
+
+        ```yaml
+        # Node type definitions
+        node_type_keys:
+          spine:
+            type: spine
+            default_evpn_role: server
+            ip_addressing:
+              p2p_uplinks_ip: 'designs/l3ls-evpn/ip-addressing/avd-v2-spine-p2p-uplinks-ip.j2'
+              p2p_uplinks_peer_ip: 'designs/l3ls-evpn/ip-addressing/avd-v2-spine-p2p-uplinks-peer-ip.j2'
+          l3leaf:
+            type: l3leaf
+            connected_endpoints: true
+            default_evpn_role: client
+            mlag_support: true
+            network_services:
+              l2: true
+              l3: true
+            vtep: true
+          l2leaf:
+            type: l2leaf
+            connected_endpoints: true
+            mlag_support: true
+            network_services:
+              l2: true
+            underlay_router: false
+            uplink_type: port-channel
+          super_spine:
+            type: super-spine
+          overlay_controller:
+            type: overlay-controller
+        ```
+
+- __overlay-controller variables:__
+
+  - Change from `overlay_controller.{{ var }}` to `overlay_controller.defaults.{{ var }}`
+  - Change from `overlay_controller_loopback_network_summary` to `overlay_controller.defaults.loopback_ipv4_pool`
+  - Change from `overlay_controller_p2p_bfd` to `overlay_controller.defaults.uplink_bfd`
+  - Change from `overlay_controller.defaults.uplink_to_remote_switches` to `overlay_controller.defaults.uplink_interfaces`
+  - Change from `overlay_controller.defaults.remote_switches` to `overlay_controller.defaults.uplink_switches`
+  - Change from `max_overlay_controller_to_switch_links` (default=2) to `overlay_controller.defaults.max_uplink_switches`
+    - (old algorithm expected max_overlay_controller_to_switch_links to be the sum of links to all uplink switches)
+  - Change from `overlay_controller_p2p_network_summary` to `overlay_controller.defaults.uplink_ipv4_pool`
+  - Change from `overlay_controller_bgp_defaults` to `overlay_controller.defaults.bgp_defaults`
+  - Change from `old default value of overlay_controller_bgp_defaults` to `overlay_controller.defaults.bgp_defaults`
+  - Change from `overlay_controller.nodes.{{ node }}.remote_switches_interfaces` to `overlay_controller.nodes.{{ node }}.uplink_switch_interfaces`
+  - Change from `overlay_controller.nodes.{{ node }}.uplink_to_remote_switches` to `overlay_controller.defaults.uplink_interfaces`
+  - Change from `overlay_controller.nodes.{{ node }}.remote_switches` to `overlay_controller.defaults.uplink_switches`
+
+- __network services variable:__
+
+  - Deprecate `evpn_rd_type.admin_subfield` == `"spine_asn"` -> use value of `spine.bgp_as`
+  - Deprecate `evpn_rt_type.admin_subfield` == `"spine_asn"` -> use value of `spine.bgp_as`
+  - Change `evpn_rd_type.admin_subfield` == `"leaf_asn"` to `bgp_as`
+  - Change `evpn_rt_type.admin_subfield` == `"leaf_asn"` to `bgp_as`
+
+
+### New Features
+
+#### eos_designs
+
+- Refactor topology data models for AVD v3.0 (#1000)
+- RFC5549 to avoid `eos_designs` variable from being parsed in `eos_cli_config_gen` (#1019)
+- Ensure required directories are present in all roles (#1048)
+- Ensure required directories are present (#1044)
+- Implement tag for documentation (#1053)
+
+#### eos_cli_config_gen
+
+- Add single-connection to tacacs (#1095)
+- Add support for transceiver media override on ethernet_interfaces (#1085)
+- Implement OSPF inter area filtering (#1076)
+- Add support for Private Vlans (#1071)
+- Add OSPF timers to router ospf (#1070)
+- Add support for mlag heartbeat-interval and system control-plane section (#1069)
+- Local sshkey field added to local-users.j2 to enable sshkey definitio… (#1065)
+- Implement tag for documentation (#1053)
+- Added modifications to support snmp v1 and snmp v2c (#1050)
+- Ensure required directories are present in all roles (#1048)
+- Ensure required directories are present (#1044)
+- Add support for `no logging event link-status` (#1037)
+- Add platform setting for `queue_monitor_length_notify_support` (#1016)
+- Add support for match_lists and using them in logging policy (#985)
+- Add support for setting vxlan flood vtep (#980)
+
+### Fixed issues
+
+#### eos_designs
+
+- Ensure required directories are present in all roles (#1048)
+- Ensure required directories are present (#1044)
+
+#### eos_cli_config_gen
+
+- Ensure required directories are present in all roles (#1048)
+- Ensure required directories are present (#1044)
+
+#### Documentation
+
+- Minor documentation fixes (#1038)
+
+
+!!! info
+    For detailed information please see the release tags: -> Placeholder update before release <-
@@ -63,18 +63,34 @@
   }
   .md-footer-nav__title {
     font-size: .9rem;
-    line-height: 2.4rem;
+    line-height: 10rem;
     color: var(--md-default-fg-color--light);
   }
+
+  .md-typeset h4 {
+      margin: 1em 0;
+      font-weight: 700;
+      letter-spacing: -.01em;
+      line-height: 3em;
+  }
+
   .md-typeset table:not([class]) th {
     min-width: 5rem;
     padding: .6rem .8rem;
     color: var(--md-default-fg-color--lighter);
     vertical-align: top;
     background-color: var(--md-accent-bg-color);
+    text-align: left;
     /* min-width: 100%; */
     /* display: table; */
   }
+  .md-typeset table:not([class]) td {
+    /* padding: .9375em 1.25em; */
+    border-collapse: collapse;
+    vertical-align: center;
+    text-align: left;
+    border-bottom: 1px solid var(--md-default-fg-color--light);
+  }
   .md-typeset code {
     padding: 0 .2941176471em;
     font-size: 80%;

@@ -6,3 +6,8 @@ evpn_underlay_ebgp_overlay_ebgp
 evpn_underlay_isis_overlay_ibgp
 evpn_underlay_ospf_overlay_ebgp
 evpn_underlay_rfc5549_overlay_ebgp
+upgrade_v2.x_to_v3.0_eos_designs-twodc-5stage-clos
+upgrade_v2.x_to_v3.0_evpn_underlay_ebgp_overlay_ebgp
+upgrade_v2.x_to_v3.0_evpn_underlay_isis_overlay_ibgp
+upgrade_v2.x_to_v3.0_evpn_underlay_ospf_overlay_ebgp
+upgrade_v2.x_to_v3.0_evpn_underlay_rfc5549_overlay_ebgp
@@ -646,7 +646,6 @@ ip route vrf MGMT 0.0.0.0/0 192.168.200.5
 | Settings | Value |
 | -------- | ----- |
 | Address Family | ipv4 |
-| Remote AS | 65001 |
 | Send community | all |
 | Maximum routes | 12000 |
 
@@ -665,10 +664,10 @@ ip route vrf MGMT 0.0.0.0/0 192.168.200.5
 | Neighbor | Remote AS | VRF |
 | -------- | --------- | --- |
 | 10.255.251.11 | Inherited from peer group MLAG-IPv4-UNDERLAY-PEER | default |
-| 172.31.255.40 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.42 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.44 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.46 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
+| 172.31.255.40 | 65001 | default |
+| 172.31.255.42 | 65001 | default |
+| 172.31.255.44 | 65001 | default |
+| 172.31.255.46 | 65001 | default |
 | 192.168.255.1 | 65001 | default |
 | 192.168.255.2 | 65001 | default |
 | 192.168.255.3 | 65001 | default |
@@ -714,7 +713,6 @@ router bgp 65104
    neighbor EVPN-OVERLAY-PEERS send-community
    neighbor EVPN-OVERLAY-PEERS maximum-routes 0
    neighbor IPv4-UNDERLAY-PEERS peer group
-   neighbor IPv4-UNDERLAY-PEERS remote-as 65001
    neighbor IPv4-UNDERLAY-PEERS password 7 AQQvKeimxJu+uGQ/yYvv9w==
    neighbor IPv4-UNDERLAY-PEERS send-community
    neighbor IPv4-UNDERLAY-PEERS maximum-routes 12000
@@ -728,12 +726,16 @@ router bgp 65104
    neighbor 10.255.251.11 peer group MLAG-IPv4-UNDERLAY-PEER
    neighbor 10.255.251.11 description DC1-BL1B
    neighbor 172.31.255.40 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.40 remote-as 65001
    neighbor 172.31.255.40 description DC1-SPINE1_Ethernet6
    neighbor 172.31.255.42 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.42 remote-as 65001
    neighbor 172.31.255.42 description DC1-SPINE2_Ethernet6
    neighbor 172.31.255.44 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.44 remote-as 65001
    neighbor 172.31.255.44 description DC1-SPINE3_Ethernet6
    neighbor 172.31.255.46 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.46 remote-as 65001
    neighbor 172.31.255.46 description DC1-SPINE4_Ethernet6
    neighbor 192.168.255.1 peer group EVPN-OVERLAY-PEERS
    neighbor 192.168.255.1 remote-as 65001

@@ -646,7 +646,6 @@ ip route vrf MGMT 0.0.0.0/0 192.168.200.5
 | Settings | Value |
 | -------- | ----- |
 | Address Family | ipv4 |
-| Remote AS | 65001 |
 | Send community | all |
 | Maximum routes | 12000 |
 
@@ -665,10 +664,10 @@ ip route vrf MGMT 0.0.0.0/0 192.168.200.5
 | Neighbor | Remote AS | VRF |
 | -------- | --------- | --- |
 | 10.255.251.10 | Inherited from peer group MLAG-IPv4-UNDERLAY-PEER | default |
-| 172.31.255.48 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.50 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.52 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
-| 172.31.255.54 | Inherited from peer group IPv4-UNDERLAY-PEERS | default |
+| 172.31.255.48 | 65001 | default |
+| 172.31.255.50 | 65001 | default |
+| 172.31.255.52 | 65001 | default |
+| 172.31.255.54 | 65001 | default |
 | 192.168.255.1 | 65001 | default |
 | 192.168.255.2 | 65001 | default |
 | 192.168.255.3 | 65001 | default |
@@ -714,7 +713,6 @@ router bgp 65104
    neighbor EVPN-OVERLAY-PEERS send-community
    neighbor EVPN-OVERLAY-PEERS maximum-routes 0
    neighbor IPv4-UNDERLAY-PEERS peer group
-   neighbor IPv4-UNDERLAY-PEERS remote-as 65001
    neighbor IPv4-UNDERLAY-PEERS password 7 AQQvKeimxJu+uGQ/yYvv9w==
    neighbor IPv4-UNDERLAY-PEERS send-community
    neighbor IPv4-UNDERLAY-PEERS maximum-routes 12000
@@ -728,12 +726,16 @@ router bgp 65104
    neighbor 10.255.251.10 peer group MLAG-IPv4-UNDERLAY-PEER
    neighbor 10.255.251.10 description DC1-BL1A
    neighbor 172.31.255.48 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.48 remote-as 65001
    neighbor 172.31.255.48 description DC1-SPINE1_Ethernet7
    neighbor 172.31.255.50 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.50 remote-as 65001
    neighbor 172.31.255.50 description DC1-SPINE2_Ethernet7
    neighbor 172.31.255.52 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.52 remote-as 65001
    neighbor 172.31.255.52 description DC1-SPINE3_Ethernet7
    neighbor 172.31.255.54 peer group IPv4-UNDERLAY-PEERS
+   neighbor 172.31.255.54 remote-as 65001
    neighbor 172.31.255.54 description DC1-SPINE4_Ethernet7
    neighbor 192.168.255.1 peer group EVPN-OVERLAY-PEERS
    neighbor 192.168.255.1 remote-as 65001