Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/equinix/terraform-equinix-cloudgenix-sdwan

Terraform module for quick deployment of GloudGenix SD-WAN edge device
https://github.com/equinix/terraform-equinix-cloudgenix-sdwan

cloudgenix equinix nfv sdn sdwan terraform terraform-module

Last synced: about 1 month ago
JSON representation

Terraform module for quick deployment of GloudGenix SD-WAN edge device

Awesome Lists containing this project

README

        

# Equinix Network Edge: CloudGenix SD-WAN edge device

A Terraform module to create CloudGenix SD-WAN network edge device
on the Equinix platform.

![Terraform status](https://github.com/equinix/terraform-equinix-cloudgenix-sdwan/workflows/Terraform/badge.svg)
![License](https://img.shields.io/github/license/equinix/terraform-equinix-cloudgenix-sdwan)

Supported device modes:

| Management Mode | License mode | Notes |
|-----------------|--------------|-------|
| Self managed | Bring your own license | - |

## 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 "cloudgenix-sdwan" {
source = "equinix/cloudgenix-sdwan/equinix"
version = "1.0.0-beta"
metro_code = "SV"
platform = "medium"
software_package = "3104V"
name = "tf-tst-cloudgenix"
term_length = 1
notifications = ["[email protected]"]
acl_tempalte_id = "2e365e34-8f38-46e1-9f57-94b075d5dc09"
license_key = "2010-21ec41ce-5314-555c-d4ec-451ccae4867e"
license_secret = "e11bd5eef6c4b514ddbe734d441af890784a341e"
secondary = {
enabled = true
metro_code = "DC"
acl_tempalte_id = "81a90c41-8a22-4724-997c-bdc07f401387"
license_key = "2010-21ec41ce-5314-555c-d4ec-451ccae4867e"
license_secret = "e11bd5eef6c4b514ddbe734d441af890784a341e"
}
}
```

## 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: `3102V`, `3104V`, `7108V`|`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|
|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|
|license_key|Device license key|`string`|`""`|yes
|license_secret|Device license secret|`string`|`""`|yes
|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|
|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|
|license_key|Device license key|`string`|`""`|yes
|license_secret|Device license secret|`string`|`""`|yes

## 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|