Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/equinix/terraform-equinix-csr-sdwan
Terraform module for quick deployment of Cisco CSR SD-WAN edge device
https://github.com/equinix/terraform-equinix-csr-sdwan
cisco equinix equinix-platform nfv sdn sdwan terraform terraform-module
Last synced: 2 months ago
JSON representation
Terraform module for quick deployment of Cisco CSR SD-WAN edge device
- Host: GitHub
- URL: https://github.com/equinix/terraform-equinix-csr-sdwan
- Owner: equinix
- License: mit
- Created: 2021-03-16T14:58:03.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-12-15T08:36:16.000Z (about 1 year ago)
- Last Synced: 2024-05-09T14:25:09.715Z (9 months ago)
- Topics: cisco, equinix, equinix-platform, nfv, sdn, sdwan, terraform, terraform-module
- Language: HCL
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 9
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Equinix Network Edge: Cisco CSR SD-WAN edge device
A Terraform module to create Cisco CSR SD-WAN network edge device
on the Equinix platform.![Terraform status](https://github.com/equinix/terraform-equinix-csr-sdwan/workflows/Terraform/badge.svg)
![License](https://img.shields.io/github/license/equinix/terraform-equinix-csr-sdwan)Supported device modes:
| Management Mode | License mode | Notes |
|-----------------|--------------|-------|
| Self managed | Bring your own license | `license_file` required |## Requirements
| Name | Version |
|------|---------|
| terraform | >= 0.13.0 |
| equinix/equinix | >= 1.1.0 |## Providers
| Name | Version |
|---------|----------|
| equinix/equinix | >= 1.1.0 |## Assumptions
* if `account_number` is not provided, then `Active` account within given metro
will be used
* most recent, stable version of a device software for a given `software_package`
will be used
* secondary device name will be same as primary with `-secondary` suffix added
* secondary device notification list will be same as for primary
* secondary device interface count will be always same as primary interface count## Example usage
```hcl
provider equinix {
client_id = var.equinix_client_id
client_secret = var.equinix_client_secret
}module "csr-sdwan" {
source = "equinix/csr-sdwan/equinix"
metro_code = "SV"
platform = "large"
software_package = "PREMIER"
license_file = "/tmp/csrsdwan-pri.cfg"
throughput = 1
throughput_unit = "Gbps"
name = "tf-tst-csr-sdwan"
term_length = 1
notifications = ["[email protected]"]
acl_tempalte_id = "2e365e34-8f38-46e1-9f57-94b075d5dc09"
interface_count = 24
site_id = "435"
system_ip_address = "123.53.66.34"
secondary = {
enabled = true
metro_code = "DC"
license_file = "/tmp/csrsdwan-sec.cfg"
acl_tempalte_id = "81a90c41-8a22-4724-997c-bdc07f401387"
site_id = "488"
system_ip_address = "84.141.11.5"
}
}
```## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|----------|
|metro_code|Two-letter device location's metro code|`string`|`""`|yes|
|account_number|Billing account number for a device. If not provided, active account for a device metro code will be used|`string`|`0`|no|
|platform|Device hardware platform flavor: `small`, `medium`, `large`|`string`|`""`|yes|
|software_package|Device software package: `ADVANTAGE`, `ESSENTIALS`, `PREMIER`|`string`|`""`|yes|
|license_file|Path to the device license configuration file|`string`|`""`|yes|
|throughput|Device license throughput|`number`|`0`|yes|
|throughput_unit|License throughput unit (`Mbps` or `Gbps`)|`string`|`""`|yes|
|name|Device name|`string`|`""`|yes|
|term_length|Term length in months: `1`, `12`, `24`, `36`|`number`|`0`|yes|
|notifications|List of email addresses that will receive notifications about device|`list(string)`|n/a|yes|
|site_id|Site identifier|`string`|`""`|yes|
|system_ip_address|System IP address|`string`|`""`|yes|
|acl_template_id|Identifier of a network ACL template that will be applied on a device|`string`|`""`|yes|
|additional_bandwidth|Amount of additional internet bandwidth for a device, in Mbps|`number`|`0`|no|
|interface_count|Device interface count: either `10` or `24`|`number`|`10`|no|
|secondary|Map of secondary device attributes in redundant setup|`map`|N/A|no|Secondary device map attributes:
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|----------|
|enabled|Value that determines if secondary device shall be created|`bool`|`false`|no|
|metro_code|Two-letter secondary device location's metro code|`string`|`""`|yes|
|account_number|Billing account number for a device. If not provided, active account for a device metro code will be used|`string`|`0`|no|
|license_file|Path to the device license configuration file|`string`|`""`|yes|
|site_id|Site identifier|`string`|`""`|yes|
|system_ip_address|System IP address|`string`|`""`|yes|
|acl_template_id|Identifier of a network ACL template that will be applied on a secondary device|`string`|`""`|yes|
|additional_bandwidth|Amount of additional internet bandwidth for a secondary device, in Mbps|`number`|`0`|no|## Outputs
| Name | Description |
|------|-------------|
|id|Device identifier|
|status|Device provisioning status|
|license_status|Device license status|
|account_number|Device billing account number|
|cpu_count|Number of device CPU cores|
|memory|Amount of device memory|
|software_version|Device software version|
|region|Device region|
|ibx|Device IBX center code|
|ssh_ip_address|Device SSH interface IP address|
|ssh_ip_fqdn|Device SSH interface FQDN|
|interfaces|List of network interfaces present on a device|
|secondary|Secondary device outputs (same as for primary). Present when secondary device was enabled|