Skip to content

[TRM] Implement VRF MDT Support in Terraform Provider #387

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
danischm merged 2 commits into from
Nov 28, 2025
Merged

[TRM] Implement VRF MDT Support in Terraform Provider #387

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e9dfdee
feat(vrf): Add vrf MDT (Multicast Distribution Tree) configuration su…
tech-of-all-trades Nov 26, 2025
987547d
Merge branch 'main' into feature/trm-implement_vrf_mdt_support_in_ter…
danischm Nov 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions docs/data-sources/vrf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,15 @@ data "iosxe_vrf" "example" {
- `address_family_ipv6` (Boolean) Address family
- `description` (String) VRF specific description
- `id` (String) The path of the retrieved object.
- `ipv4_mdt_auto_discovery_interworking_vxlan_pim` (Boolean) Enable BGP auto-discovery for VxLAN PIM interworking
- `ipv4_mdt_auto_discovery_interworking_vxlan_pim_inter_as` (Boolean) Enable Inter-AS BGP auto-discovery for VxLAN PIM interworking
- `ipv4_mdt_auto_discovery_vxlan` (Boolean) Enable BGP auto-discovery for VxLAN
- `ipv4_mdt_auto_discovery_vxlan_inter_as` (Boolean) Enable Inter-AS BGP auto-discovery for VxLAN
- `ipv4_mdt_data_multicast` (Attributes List) MDT data multicast group ranges (see [below for nested schema](#nestedatt--ipv4_mdt_data_multicast))
- `ipv4_mdt_data_threshold` (Number) MDT switching threshold in Kbps (1-4294967)
- `ipv4_mdt_default_address` (String) MDT default group IPv4 address
- `ipv4_mdt_overlay_use_bgp` (Boolean) Enable BGP for MDT overlay signaling
- `ipv4_mdt_overlay_use_bgp_spt_only` (Boolean) Enable Shortest path tree-only ASM mode
- `ipv4_route_replicate` (Attributes List) (see [below for nested schema](#nestedatt--ipv4_route_replicate))
- `ipv4_route_target_export` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--ipv4_route_target_export))
- `ipv4_route_target_export_stitching` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--ipv4_route_target_export_stitching))
Expand All @@ -49,6 +58,16 @@ data "iosxe_vrf" "example" {
- `route_target_import` (Attributes Set) Import Target-VPN community (see [below for nested schema](#nestedatt--route_target_import))
- `vpn_id` (String) Configure VPN ID in rfc2685 format

<a id="nestedatt--ipv4_mdt_data_multicast"></a>
### Nested Schema for `ipv4_mdt_data_multicast`

Read-Only:

- `address` (String) Multicast group base address
- `list` (String) Access-list for group range
- `wildcard` (String) Wildcard mask for address range


<a id="nestedatt--ipv4_route_replicate"></a>
### Nested Schema for `ipv4_route_replicate`

Expand Down
35 changes: 35 additions & 0 deletions docs/resources/vrf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,18 @@ resource "iosxe_vrf" "example" {
value = "22:22"
}
]
ipv4_mdt_default_address = "239.1.1.1"
ipv4_mdt_auto_discovery_vxlan = true
ipv4_mdt_auto_discovery_vxlan_inter_as = true
ipv4_mdt_overlay_use_bgp = true
ipv4_mdt_overlay_use_bgp_spt_only = true
ipv4_mdt_data_multicast = [
{
address = "239.1.2.0"
wildcard = "0.0.0.255"
}
]
ipv4_mdt_data_threshold = 50
}
```

Expand All @@ -85,6 +97,16 @@ resource "iosxe_vrf" "example" {
- Choices: `all`, `attributes`
- `description` (String) VRF specific description
- `device` (String) A device name from the provider configuration.
- `ipv4_mdt_auto_discovery_interworking_vxlan_pim` (Boolean) Enable BGP auto-discovery for VxLAN PIM interworking
- `ipv4_mdt_auto_discovery_interworking_vxlan_pim_inter_as` (Boolean) Enable Inter-AS BGP auto-discovery for VxLAN PIM interworking
- `ipv4_mdt_auto_discovery_vxlan` (Boolean) Enable BGP auto-discovery for VxLAN
- `ipv4_mdt_auto_discovery_vxlan_inter_as` (Boolean) Enable Inter-AS BGP auto-discovery for VxLAN
- `ipv4_mdt_data_multicast` (Attributes List) MDT data multicast group ranges (see [below for nested schema](#nestedatt--ipv4_mdt_data_multicast))
- `ipv4_mdt_data_threshold` (Number) MDT switching threshold in Kbps (1-4294967)
- Range: `1`-`4294967`
- `ipv4_mdt_default_address` (String) MDT default group IPv4 address
- `ipv4_mdt_overlay_use_bgp` (Boolean) Enable BGP for MDT overlay signaling
- `ipv4_mdt_overlay_use_bgp_spt_only` (Boolean) Enable Shortest path tree-only ASM mode
- `ipv4_route_replicate` (Attributes List) (see [below for nested schema](#nestedatt--ipv4_route_replicate))
- `ipv4_route_target_export` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--ipv4_route_target_export))
- `ipv4_route_target_export_stitching` (Attributes Set) Export Target-VPN community (see [below for nested schema](#nestedatt--ipv4_route_target_export_stitching))
Expand All @@ -103,6 +125,19 @@ resource "iosxe_vrf" "example" {

- `id` (String) The path of the object.

<a id="nestedatt--ipv4_mdt_data_multicast"></a>
### Nested Schema for `ipv4_mdt_data_multicast`

Required:

- `address` (String) Multicast group base address
- `wildcard` (String) Wildcard mask for address range

Optional:

- `list` (String) Access-list for group range


<a id="nestedatt--ipv4_route_replicate"></a>
### Nested Schema for `ipv4_route_replicate`

Expand Down
12 changes: 12 additions & 0 deletions examples/resources/iosxe_vrf/resource.tf
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,4 +52,16 @@ resource "iosxe_vrf" "example" {
value = "22:22"
}
]
ipv4_mdt_default_address = "239.1.1.1"
ipv4_mdt_auto_discovery_vxlan = true
ipv4_mdt_auto_discovery_vxlan_inter_as = true
ipv4_mdt_overlay_use_bgp = true
ipv4_mdt_overlay_use_bgp_spt_only = true
ipv4_mdt_data_multicast = [
{
address = "239.1.2.0"
wildcard = "0.0.0.255"
}
]
ipv4_mdt_data_threshold = 50
}
55 changes: 55 additions & 0 deletions gen/definitions/vrf.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -141,3 +141,58 @@ attributes:
default_value: true
exclude_test: true
example: true
- yang_name: address-family/ipv4/mdt/default/address
tf_name: ipv4_mdt_default_address
description: MDT default group IPv4 address
example: 239.1.1.1
- yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/vxlan/vxlan-config/vxlan
xpath: address-family/ipv4/mdt/auto-discovery/vxlan-config/vxlan
tf_name: ipv4_mdt_auto_discovery_vxlan
description: Enable BGP auto-discovery for VxLAN
example: true
- yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/vxlan/vxlan-config/inter-as
xpath: address-family/ipv4/mdt/auto-discovery/vxlan-config/inter-as
tf_name: ipv4_mdt_auto_discovery_vxlan_inter_as
description: Enable Inter-AS BGP auto-discovery for VxLAN
example: true
- yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/interworking/interworking/interworking/vxlan-pim/vxlan-pim-config/vxlan-pim
xpath: address-family/ipv4/mdt/auto-discovery/interworking/vxlan-pim-config/vxlan-pim
tf_name: ipv4_mdt_auto_discovery_interworking_vxlan_pim
description: Enable BGP auto-discovery for VxLAN PIM interworking
exclude_test: true
example: true
- yang_name: address-family/ipv4/mdt/auto-discovery/auto-discovery/interworking/interworking/interworking/vxlan-pim/vxlan-pim-config/inter-as
xpath: address-family/ipv4/mdt/auto-discovery/interworking/vxlan-pim-config/inter-as
tf_name: ipv4_mdt_auto_discovery_interworking_vxlan_pim_inter_as
description: Enable Inter-AS BGP auto-discovery for VxLAN PIM interworking
exclude_test: true
example: true
- yang_name: address-family/ipv4/mdt/overlay/use-bgp-config
tf_name: ipv4_mdt_overlay_use_bgp
description: Enable BGP for MDT overlay signaling
example: true
- yang_name: address-family/ipv4/mdt/overlay/use-bgp-config/spt-only
tf_name: ipv4_mdt_overlay_use_bgp_spt_only
description: Enable Shortest path tree-only ASM mode
example: true
- yang_name: address-family/ipv4/mdt/data/multicast
tf_name: ipv4_mdt_data_multicast
type: List
description: MDT data multicast group ranges
attributes:
- yang_name: address
description: Multicast group base address
example: 239.1.2.0
id: true
- yang_name: wildcard
description: Wildcard mask for address range
example: 0.0.0.255
id: true
- yang_name: list
description: Access-list for group range
example: ACL_MDT
exclude_test: true
- yang_name: address-family/ipv4/mdt/data/threshold
tf_name: ipv4_mdt_data_threshold
description: MDT switching threshold in Kbps (1-4294967)
example: 50
52 changes: 52 additions & 0 deletions internal/provider/data_source_iosxe_vrf.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

18 changes: 18 additions & 0 deletions internal/provider/data_source_iosxe_vrf_test.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading