https://github.com/netascode/terraform-nxos-evpn-ospf-underlay
Terraform NX-OS EVPN OSPF Underlay Module
https://github.com/netascode/terraform-nxos-evpn-ospf-underlay
cisco evpn nexus nx-os nxos terraform terraform-module vxlan
Last synced: 3 months ago
JSON representation
Terraform NX-OS EVPN OSPF Underlay Module
- Host: GitHub
- URL: https://github.com/netascode/terraform-nxos-evpn-ospf-underlay
- Owner: netascode
- License: apache-2.0
- Created: 2022-05-30T11:37:25.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-10T12:04:54.000Z (over 1 year ago)
- Last Synced: 2025-01-14T14:14:06.979Z (4 months ago)
- Topics: cisco, evpn, nexus, nx-os, nxos, terraform, terraform-module, vxlan
- Language: HCL
- Homepage: https://registry.terraform.io/modules/netascode/evpn-ospf-underlay/nxos
- Size: 37.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/netascode/terraform-nxos-evpn-ospf-underlay/actions/workflows/test.yml)
# Terraform NX-OS EVPN OSPF Underlay Module
This module can manage a Nexus 9000 EVPN fabric underlay network based on OSPF.
The following assumptions have been made:
- IP unnumbered is used on all fabric links
- OSPF area 0 is used for all interfaces
- PIM sparse mode is enabled on all interfaces
- A system MTU of 9216 is configured on all devices
- All spines act as a PIM Anycast RP
- Each leaf is connected to each spine with a single link
- The same consecutive range of interfaces is used on all leafs for fabric links
- The same consecutive range of interfaces is used on all spines for fabric links
## Examples
```hcl
module "nxos_evpn_ospf_underlay" {
source = "netascode/evpn-ospf-underlay/nxos"
version = ">= 0.2.0"
leafs = ["LEAF-1", "LEAF-2"]
spines = ["SPINE-1", "SPINE-2"]
loopback_id = 0
pim_loopback_id = 100
loopbacks = [
{
device = "SPINE-1",
ipv4_address = "10.1.100.1"
},
{
device = "SPINE-2",
ipv4_address = "10.1.100.2"
},
{
device = "LEAF-1",
ipv4_address = "10.1.100.3"
},
{
device = "LEAF-2",
ipv4_address = "10.1.100.4"
}
]
vtep_loopback_id = 1
vtep_loopbacks = [
{
device = "LEAF-1",
ipv4_address = "10.1.200.1"
},
{
device = "LEAF-2",
ipv4_address = "10.1.200.2"
}
]
leaf_fabric_interface_prefix = "1/"
leaf_fabric_interface_offset = "1"
spine_fabric_interface_prefix = "1/"
spine_fabric_interface_offset = "1"
anycast_rp_ipv4_address = "10.1.101.1"
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.1.0 |
| [nxos](#requirement\_nxos) | >= 0.5.0 |
## Providers
| Name | Version |
|------|---------|
| [nxos](#provider\_nxos) | >= 0.5.0 |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [leafs](#input\_leafs) | List of leaf device names. This list of devices must also be added to the provider configuration. | `set(string)` | `[]` | no |
| [spines](#input\_spines) | List of spine device names. This list of devices must also be added to the provider configuration. | `set(string)` | `[]` | no |
| [loopback\_id](#input\_loopback\_id) | Loopback ID used for OSPF and PIM. | `number` | `0` | no |
| [pim\_loopback\_id](#input\_pim\_loopback\_id) | Loopback ID used for PIM Anycast RP. | `number` | `100` | no |
| [loopbacks](#input\_loopbacks) | List of loopback interfaces, one per device. |
list(object({
device = string
ipv4_address = string
})) | `[]` | no |
| [vtep\_loopback\_id](#input\_vtep\_loopback\_id) | Loopback ID used for VTEP loopbacks. | `number` | `1` | no |
| [vtep\_loopbacks](#input\_vtep\_loopbacks) | List of vtep loopback interfaces, one per leaf. | list(object({
device = string
ipv4_address = string
})) | `[]` | no |
| [leaf\_fabric\_interface\_prefix](#input\_leaf\_fabric\_interface\_prefix) | Interface prefix for leaf interfaces, eg. `1/`. | `string` | `"1/"` | no |
| [spine\_fabric\_interface\_prefix](#input\_spine\_fabric\_interface\_prefix) | Interface prefix for spine interfaces, eg. `1/`. | `string` | `"1/"` | no |
| [leaf\_fabric\_interface\_offset](#input\_leaf\_fabric\_interface\_offset) | Leaf interface index offset for fabric interfaces. | `string` | `"1"` | no |
| [spine\_fabric\_interface\_offset](#input\_spine\_fabric\_interface\_offset) | Spine interface index offset for fabric interfaces. | `string` | `"1"` | no |
| [anycast\_rp\_ipv4\_address](#input\_anycast\_rp\_ipv4\_address) | IPv4 address of PIM RP loopback interface (Anycast). | `string` | n/a | yes |
## Outputs
| Name | Description |
|------|-------------|
| [loopback\_id](#output\_loopback\_id) | Loopback ID used for OSPF and PIM. |
| [pim\_loopback\_id](#output\_pim\_loopback\_id) | Loopback ID used for PIM Anycast RP. |
| [vtep\_loopback\_id](#output\_vtep\_loopback\_id) | Loopback ID used for VTEP loopbacks. |
| [loopbacks](#output\_loopbacks) | List of loopback interfaces, one per device. |
| [vtep\_loopbacks](#output\_vtep\_loopbacks) | List of vtep loopback interfaces, one per leaf. |
## Resources
| Name | Type |
|------|------|
| [nxos_ethernet.ethernet](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/ethernet) | resource |
| [nxos_system.system](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/system) | resource |