feat: Implement VRF Advanced Support in Terraform Provider

Author: Jeremy Spencer

CHANGELOG.md

@@ -41,6 +41,9 @@
 - Add `router_id_ip`, `bgp_graceful_restart`, and `bgp_update_delay` to `iosxe_bgp` resource and data source
 - Add `multi_area_ids` attribute to `iosxe_interface_ospf` resource and data source
 - Add `log_adjacency_changes`, `log_adjacency_changes_detail`, `nsf_cisco`, `nsf_cisco_enforce_global`, `nsf_ietf`, `nsf_ietf_restart_interval`, `max_metric_router_lsa_*`, `fast_reroute_per_prefix_enable_prefix_priority`, `redistribute_static_subnets` and `redistribute_connected_subnets` attributes to `iosxe_ospf` and `iosxe_ospf_vrf` resources and data sources
+- Enhance `set_communities` attribute documentation in `iosxe_route_map` to clarify support for well-known BGP community values (internet, local-AS, no-advertise, no-export, gshut)
+- Add `route_map` attribute with required subattributes to `iosxe_bgp_l2vpn_evpn_neighbor` resource and data source
+- Add `import_path_selection_all` and `ipv4_unicast_aggregate_addresses.summary_only` attributes to `iosxe_bgp_address_family_ipv4_vrf` resoutces and data sources
 
 ## 0.9.3
 

docs/data-sources/bgp_address_family_ipv4_vrf.md

@@ -37,6 +37,7 @@ data "iosxe_bgp_address_family_ipv4_vrf" "example" {
 - `vrfs` (Attributes List) (see [below for nested schema](#nestedatt--vrfs))
 
 <a id="nestedatt--vrfs"></a>
+
 ### Nested Schema for `vrfs`
 
 Read-Only:
@@ -49,6 +50,7 @@ Read-Only:
 - `ipv4_unicast_distance_bgp_local` (Number)
 - `ipv4_unicast_maximum_paths_ebgp` (Number) eBGP-multipath
 - `ipv4_unicast_maximum_paths_ibgp` (Number)
+- `ipv4_unicast_import_path_selection_all` (Boolean) Import all available paths
 - `ipv4_unicast_networks` (Attributes List) Specify a network to announce via BGP (see [below for nested schema](#nestedatt--vrfs--ipv4_unicast_networks))
 - `ipv4_unicast_networks_mask` (Attributes List) Specify a network to announce via BGP (see [below for nested schema](#nestedatt--vrfs--ipv4_unicast_networks_mask))
 - `ipv4_unicast_redistribute_connected` (Boolean) Connected
@@ -58,6 +60,7 @@ Read-Only:
 - `name` (String)
 
 <a id="nestedatt--vrfs--ipv4_unicast_admin_distances"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_admin_distances`
 
 Read-Only:
@@ -67,17 +70,18 @@ Read-Only:
 - `source_ip` (String)
 - `wildcard` (String)
 
-
 <a id="nestedatt--vrfs--ipv4_unicast_aggregate_addresses"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_aggregate_addresses`
 
 Read-Only:
 
 - `ipv4_address` (String)
 - `ipv4_mask` (String)
-
+- `summary_only` (Boolean) Filter more specific routes from updates
 
 <a id="nestedatt--vrfs--ipv4_unicast_networks"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_networks`
 
 Read-Only:
@@ -87,8 +91,8 @@ Read-Only:
 - `network` (String)
 - `route_map` (String) Route-map to modify the attributes
 
-
 <a id="nestedatt--vrfs--ipv4_unicast_networks_mask"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_networks_mask`
 
 Read-Only:

docs/data-sources/bgp_l2vpn_evpn_neighbor.md

@@ -35,6 +35,15 @@ data "iosxe_bgp_l2vpn_evpn_neighbor" "example" {
 
 - `activate` (Boolean) Enable the address family for this neighbor
 - `id` (String) The path of the retrieved object.
+- `route_map` (Attributes List) Apply route map to neighbor (see [below for nested schema](#nestedatt--route_map))
 - `route_reflector_client` (Boolean) Configure a neighbor as Route Reflector client
 - `send_community` (String)
 - `soft_reconfiguration` (String) Per neighbor soft reconfiguration
+
+<a id="nestedatt--route_map"></a>
+### Nested Schema for `route_map`
+
+Read-Only:
+
+- `inout` (String)
+- `route_map_name` (String)

docs/resources/bgp_address_family_ipv4_vrf.md

@@ -26,6 +26,7 @@ resource "iosxe_bgp_address_family_ipv4_vrf" "example" {
         {
           ipv4_address = "50.0.0.0"
           ipv4_mask    = "255.255.0.0"
+          summary_only = true
         }
       ]
       ipv4_unicast_redistribute_static = true
@@ -56,6 +57,7 @@ resource "iosxe_bgp_address_family_ipv4_vrf" "example" {
       ipv4_unicast_distance_bgp_local    = 200
       ipv4_unicast_maximum_paths_ebgp    = 2
       ipv4_unicast_maximum_paths_ibgp    = 2
+      ipv4_unicast_import_path_selection_all = true
     }
   ]
 }
@@ -81,6 +83,7 @@ resource "iosxe_bgp_address_family_ipv4_vrf" "example" {
 - `id` (String) The path of the object.
 
 <a id="nestedatt--vrfs"></a>
+
 ### Nested Schema for `vrfs`
 
 Required:
@@ -95,9 +98,15 @@ Optional:
 - `ipv4_unicast_distance_bgp_external` (Number) - Range: `1`-`255`
 - `ipv4_unicast_distance_bgp_internal` (Number) - Range: `1`-`255`
 - `ipv4_unicast_distance_bgp_local` (Number) - Range: `1`-`255`
+<<<<<<< HEAD
 - `ipv4_unicast_maximum_paths_ebgp` (Number) eBGP-multipath
   - Range: `1`-`32`
 - `ipv4_unicast_maximum_paths_ibgp` (Number) - Range: `1`-`32`
+=======
+- `ipv4_unicast_import_path_selection_all` (Boolean) Import all available paths
+
+>>>>>>> 4d83599c (feat: Implement VRF Advanced Support in Terraform Provider)
+
 - `ipv4_unicast_networks` (Attributes List) Specify a network to announce via BGP (see [below for nested schema](#nestedatt--vrfs--ipv4_unicast_networks))
 - `ipv4_unicast_networks_mask` (Attributes List) Specify a network to announce via BGP (see [below for nested schema](#nestedatt--vrfs--ipv4_unicast_networks_mask))
 - `ipv4_unicast_redistribute_connected` (Boolean) Connected
@@ -107,6 +116,7 @@ Optional:
   - Range: `0`-`2147483647`
 
 <a id="nestedatt--vrfs--ipv4_unicast_admin_distances"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_admin_distances`
 
 Required:
@@ -119,17 +129,21 @@ Optional:
 
 - `acl` (String)
 
-
 <a id="nestedatt--vrfs--ipv4_unicast_aggregate_addresses"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_aggregate_addresses`
 
 Required:
 
 - `ipv4_address` (String)
 - `ipv4_mask` (String)
 
+Optional:
+
+- `summary_only` (Boolean) Filter more specific routes from updates
 
 <a id="nestedatt--vrfs--ipv4_unicast_networks"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_networks`
 
 Required:
@@ -142,8 +156,8 @@ Optional:
 - `evpn` (Boolean) Advertise or export to EVPN address-family
 - `route_map` (String) Route-map to modify the attributes
 
-
 <a id="nestedatt--vrfs--ipv4_unicast_networks_mask"></a>
+
 ### Nested Schema for `vrfs.ipv4_unicast_networks_mask`
 
 Required:

docs/resources/bgp_l2vpn_evpn_neighbor.md

@@ -20,6 +20,12 @@ resource "iosxe_bgp_l2vpn_evpn_neighbor" "example" {
   send_community         = "both"
   route_reflector_client = false
   soft_reconfiguration   = "inbound"
+  route_map = [
+    {
+      inout          = "in"
+      route_map_name = "RM1"
+    }
+  ]
 }
 ```
 
@@ -38,6 +44,7 @@ resource "iosxe_bgp_l2vpn_evpn_neighbor" "example" {
 - `delete_mode` (String) Configure behavior when deleting/destroying the resource. Either delete the entire object (YANG container) being managed, or only delete the individual resource attributes configured explicitly and leave everything else as-is. Default value is `all`.
   - Choices: `all`, `attributes`
 - `device` (String) A device name from the provider configuration.
+- `route_map` (Attributes List) Apply route map to neighbor (see [below for nested schema](#nestedatt--route_map))
 - `route_reflector_client` (Boolean) Configure a neighbor as Route Reflector client
 - `send_community` (String) - Choices: `both`, `extended`, `standard`
 - `soft_reconfiguration` (String) Per neighbor soft reconfiguration
@@ -47,6 +54,14 @@ resource "iosxe_bgp_l2vpn_evpn_neighbor" "example" {
 
 - `id` (String) The path of the object.
 
+<a id="nestedatt--route_map"></a>
+### Nested Schema for `route_map`
+
+Required:
+
+- `inout` (String) - Choices: `in`, `out`
+- `route_map_name` (String)
+
 ## Import
 
 Import is supported using the following syntax:

examples/resources/iosxe_bgp_address_family_ipv4_vrf/resource.tf

@@ -11,6 +11,7 @@ resource "iosxe_bgp_address_family_ipv4_vrf" "example" {
         {
           ipv4_address = "50.0.0.0"
           ipv4_mask    = "255.255.0.0"
+          summary_only = true
         }
       ]
       ipv4_unicast_redistribute_static = true
@@ -36,11 +37,12 @@ resource "iosxe_bgp_address_family_ipv4_vrf" "example" {
           wildcard  = "0.0.0.0"
         }
       ]
-      ipv4_unicast_distance_bgp_external = 20
-      ipv4_unicast_distance_bgp_internal = 200
-      ipv4_unicast_distance_bgp_local    = 200
-      ipv4_unicast_maximum_paths_ebgp    = 2
-      ipv4_unicast_maximum_paths_ibgp    = 2
+      ipv4_unicast_distance_bgp_external     = 20
+      ipv4_unicast_distance_bgp_internal     = 200
+      ipv4_unicast_distance_bgp_local        = 200
+      ipv4_unicast_maximum_paths_ebgp        = 2
+      ipv4_unicast_maximum_paths_ibgp        = 2
+      ipv4_unicast_import_path_selection_all = true
     }
   ]
 }

examples/resources/iosxe_bgp_l2vpn_evpn_neighbor/resource.tf

@@ -5,4 +5,10 @@ resource "iosxe_bgp_l2vpn_evpn_neighbor" "example" {
   send_community         = "both"
   route_reflector_client = false
   soft_reconfiguration   = "inbound"
+  route_map = [
+    {
+      inout          = "in"
+      route_map_name = "RM1"
+    }
+  ]
 }

gen/definitions/bgp_address_family_ipv4_vrf.yaml

@@ -31,6 +31,7 @@ attributes:
         tf_name: ipv4_unicast_router_id_ip
         exclude_test: true
         example: 10.1.1.1
+        exclude_test: true
       - yang_name: ipv4-unicast/aggregate-address
         tf_name: ipv4_unicast_aggregate_addresses
         type: List
@@ -41,6 +42,8 @@ attributes:
           - yang_name: ipv4-mask
             id: true
             example: 255.255.0.0
+          - yang_name: summary-only
+            example: true
       - yang_name: ipv4-unicast/redistribute-vrf/static
         tf_name: ipv4_unicast_redistribute_static
         example: true
@@ -118,6 +121,8 @@ attributes:
         tf_name: ipv4_unicast_maximum_paths_ibgp
         xpath: ipv4-unicast/maximum-paths/ibgp/max
         example: 2
+      - yang_name: ipv4-unicast/import/path/selection/all
+        example: true
 test_prerequisites:
   - path: /Cisco-IOS-XE-native:native/vrf/definition[name=VRF1]
     no_delete: true

gen/definitions/bgp_l2vpn_evpn_neighbor.yaml

@@ -23,6 +23,14 @@ attributes:
     example: false
   - yang_name: soft-reconfiguration
     example: inbound
+  - yang_name: route-map
+    type: List
+    attributes:
+      - yang_name: inout
+        id: true
+        example: in
+      - yang_name: route-map-name
+        example: RM1
 test_prerequisites:
   - path: /Cisco-IOS-XE-native:native/router/Cisco-IOS-XE-bgp:bgp[id=65000]
     attributes:
@@ -40,3 +48,8 @@ test_prerequisites:
       - name: remote-as
         value: 65000
     dependencies: [0]
+  - path: Cisco-IOS-XE-native:native/route-map=RM1
+    attributes:
+      - name: name
+        value: RM1
+