zecfoundation
/
cloud-foundation-fabric
mirror of https://github.com/ZcashFoundation/cloud-foundation-fabric.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Remove net-interconnect-attachment-direct

This commit is contained in:
Julio Castillo 2023-04-14 11:01:54 +02:00
parent ac59bdeb75
commit 2d4bd5a244
9 changed files with 0 additions and 660 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

132
modules/net-interconnect-attachment-direct/README.md
View File

@ -1,132 +0,0 @@
# Direct Interconnect VLAN Attachment and router
This module allows creation of a VLAN attachment for Direct Interconnect and router (router creation is optional).
## Examples
### Direct Interconnect VLAN attachment using default parameters for bgp session and router
```hcl
module "vlan-attachment-1" {
source = "./fabric/modules/net-interconnect-attachment-direct"
project_id = "dedicated-ic-5-8492"
region = "us-west2"
router_network = "myvpc"
name = "vlan-604-x"
interconnect = "https://www.googleapis.com/compute/v1/projects/mylab/global/interconnects/mylab-interconnect-1"
peer = {
ip_address = "169.254.63.2"
asn = 65418
}
}
# tftest modules=1 resources=4
```
#### Direct Interconnect VLAN attachments to achieve 99.9% SLA setup
```hcl
module "vlan-attachment-1" {
source = "./fabric/modules/net-interconnect-attachment-direct"
project_id = "dedicated-ic-3-8386"
region = "us-west2"
router_name = "router-1"
router_config = {
description = ""
asn = 65003
advertise_config = {
groups = ["ALL_SUBNETS"]
ip_ranges = {
"199.36.153.8/30" = "custom"
}
mode = "CUSTOM"
}
}
router_network = "myvpc"
name = "vlan-603-1"
interconnect = "https://www.googleapis.com/compute/v1/projects/mylab/global/interconnects/mylab-interconnect-1"
config = {
description = ""
vlan_id = 603
bandwidth = "BPS_10G"
admin_enabled = true
mtu = 1440
}
peer = {
ip_address = "169.254.63.2"
asn = 65418
}
bgp = {
session_range = "169.254.63.1/29"
advertised_route_priority = 0
candidate_ip_ranges = ["169.254.63.0/29"]
}
}
module "vlan-attachment-2" {
source = "./fabric/modules/net-interconnect-attachment-direct"
project_id = "dedicated-ic-3-8386"
region = "us-west2"
router_name = "router-2"
router_config = {
description = ""
asn = 65003
advertise_config = {
groups = ["ALL_SUBNETS"]
ip_ranges = {
"199.36.153.8/30" = "custom"
}
mode = "CUSTOM"
}
}
router_network = "myvpc"
name = "vlan-603-2"
interconnect = "https://www.googleapis.com/compute/v1/projects/mylab/global/interconnects/mylab-interconnect-2"
config = {
description = ""
vlan_id = 603
bandwidth = "BPS_10G"
admin_enabled = true
mtu = 1440
}
peer = {
ip_address = "169.254.63.10"
asn = 65418
}
bgp = {
session_range = "169.254.63.9/29"
advertised_route_priority = 0
candidate_ip_ranges = ["169.254.63.8/29"]
}
}
# tftest modules=2 resources=8
```
<!-- BEGIN TFDOC -->
## Variables
| name | description | type | required | default |
|---|---|:---:|:---:|:---:|
| [interconnect](variables.tf#L46) | URL of the underlying Interconnect object that this attachment's traffic will traverse through. | <code>string</code> | ✓ | |
| [peer](variables.tf#L57) | Peer Ip address and asn. Only IPv4 supported. | <code title="object&#40;&#123;&#10; ip_address &#61; string&#10; asn &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | ✓ | |
| [project_id](variables.tf#L65) | The project containing the resources. | <code>string</code> | ✓ | |
| [router_config](variables.tf#L76) | Router asn and custom advertisement configuration, ip_ranges is a map of address ranges and descriptions.. . | <code title="object&#40;&#123;&#10; description &#61; string&#10; asn &#61; number&#10; advertise_config &#61; object&#40;&#123;&#10; groups &#61; list&#40;string&#41;&#10; ip_ranges &#61; map&#40;string&#41;&#10; mode &#61; string&#10; &#125;&#41;&#10;&#125;&#41;&#10;&#10;&#10;default &#61; &#123;&#10; description &#61; null&#10; asn &#61; 64514&#10; advertise_config &#61; null&#10;&#125;">object&#40;&#123;&#8230;&#125;</code> | ✓ | |
| [bgp](variables.tf#L17) | Bgp session parameters. | <code title="object&#40;&#123;&#10; session_range &#61; string&#10; candidate_ip_ranges &#61; list&#40;string&#41;&#10; advertised_route_priority &#61; number&#10;&#10;&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code>null</code> |
| [config](variables.tf#L28) | VLAN attachment parameters: description, vlan_id, bandwidth, admin_enabled, interconnect. | <code title="object&#40;&#123;&#10; description &#61; string&#10; vlan_id &#61; number&#10; bandwidth &#61; string&#10; admin_enabled &#61; bool&#10; mtu &#61; number&#10;&#125;&#41;">object&#40;&#123;&#8230;&#125;&#41;</code> | | <code title="&#123;&#10; description &#61; null&#10; vlan_id &#61; null&#10; bandwidth &#61; &#34;BPS_10G&#34;&#10; admin_enabled &#61; true&#10; mtu &#61; 1440&#10;&#125;">&#123;&#8230;&#125;</code> |
| [name](variables.tf#L51) | The name of the vlan attachment. | <code>string</code> | | <code>&#34;vlan-attachment&#34;</code> |
| [region](variables.tf#L70) | Region where the router resides. | <code>string</code> | | <code>&#34;europe-west1-b&#34;</code> |
| [router_create](variables.tf#L95) | Create router. | <code>bool</code> | | <code>true</code> |
| [router_name](variables.tf#L101) | Router name used for auto created router, or to specify an existing router to use if `router_create` is set to `true`. Leave blank to use vlan attachment name for auto created router. | <code>string</code> | | <code>&#34;router-vlan-attachment&#34;</code> |
| [router_network](variables.tf#L107) | A reference to the network to which this router belongs. | <code>string</code> | | <code>null</code> |
## Outputs
| name | description | sensitive |
|---|---|:---:|
| [bgpsession](outputs.tf#L16) | bgp session. | |
| [interconnect_attachment](outputs.tf#L21) | interconnect attachment. | |
| [router](outputs.tf#L26) | Router resource (only if auto-created). | |
<!-- END TFDOC -->

98
modules/net-interconnect-attachment-direct/main.tf
View File

@ -1,98 +0,0 @@
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
locals {
router = (
var.router_create
? try(google_compute_router.router[0].name, null)
: var.router_name
)
vlan_interconnect = try(google_compute_interconnect_attachment.interconnect_vlan_attachment.name)
}
resource "google_compute_router" "router" {
count = var.router_create ? 1 : 0
project = var.project_id
region = var.region
name = var.router_name == "" ? "router-${var.name}" : var.router_name
description = var.router_config.description
network = var.router_network
bgp {
advertise_mode = (
var.router_config.advertise_config == null
? null
: var.router_config.advertise_config.mode
)
advertised_groups = (
var.router_config.advertise_config == null ? null : (
var.router_config.advertise_config.mode != "CUSTOM"
? null
: var.router_config.advertise_config.groups
)
)
dynamic "advertised_ip_ranges" {
for_each = (
var.router_config.advertise_config == null ? {} : (
var.router_config.advertise_config.mode != "CUSTOM"
? null
: var.router_config.advertise_config.ip_ranges
)
)
iterator = range
content {
range = range.key
description = range.value
}
}
asn = var.router_config.asn
}
}
resource "google_compute_interconnect_attachment" "interconnect_vlan_attachment" {
project = var.project_id
region = var.region
router = local.router
name = var.name
description = var.config.description
interconnect = var.interconnect
bandwidth = var.config.bandwidth
mtu = var.config.mtu
vlan_tag8021q = var.config.vlan_id
candidate_subnets = var.bgp == null ? null : var.bgp.candidate_ip_ranges
admin_enabled = var.config.admin_enabled
provider = google-beta
}
resource "google_compute_router_interface" "interface" {
project = var.project_id
region = var.region
name = "interface-${var.name}"
router = local.router
ip_range = var.bgp == null ? null : var.bgp.session_range
interconnect_attachment = local.vlan_interconnect
}
resource "google_compute_router_peer" "peer" {
project = var.project_id
region = var.region
name = "bgp-session-${var.name}"
router = local.router
peer_ip_address = var.peer.ip_address
peer_asn = var.peer.asn
advertised_route_priority = var.bgp == null ? null : var.bgp.advertised_route_priority
interface = local.vlan_interconnect
}

31
modules/net-interconnect-attachment-direct/outputs.tf
View File

@ -1,31 +0,0 @@
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
output "bgpsession" {
description = "bgp session."
value = google_compute_router_peer.peer
}
output "interconnect_attachment" {
description = "interconnect attachment."
value = google_compute_interconnect_attachment.interconnect_vlan_attachment
}
output "router" {
description = "Router resource (only if auto-created)."
value = google_compute_router.router
}

115
modules/net-interconnect-attachment-direct/variables.tf
View File

@ -1,115 +0,0 @@
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
variable "bgp" {
description = "Bgp session parameters."
type = object({
session_range = string
candidate_ip_ranges = list(string)
advertised_route_priority = number
})
default = null
}
variable "config" {
description = "VLAN attachment parameters: description, vlan_id, bandwidth, admin_enabled, interconnect."
type = object({
description = string
vlan_id = number
bandwidth = string
admin_enabled = bool
mtu = number
})
default = {
description = null
vlan_id = null
bandwidth = "BPS_10G"
admin_enabled = true
mtu = 1440
}
}
variable "interconnect" {
description = "URL of the underlying Interconnect object that this attachment's traffic will traverse through."
type = string
}
variable "name" {
description = "The name of the vlan attachment."
type = string
default = "vlan-attachment"
}
variable "peer" {
description = "Peer Ip address and asn. Only IPv4 supported."
type = object({
ip_address = string
asn = number
})
}
variable "project_id" {
description = "The project containing the resources."
type = string
}
variable "region" {
description = "Region where the router resides."
type = string
default = "europe-west1-b"
}
variable "router_config" {
description = "Router asn and custom advertisement configuration, ip_ranges is a map of address ranges and descriptions.. ."
type = object({
description = string
asn = number
advertise_config = object({
groups = list(string)
ip_ranges = map(string)
mode = string
})
})
default = {
description = null
asn = 64514
advertise_config = null
}
}
variable "router_create" {
description = "Create router."
type = bool
default = true
}
variable "router_name" {
description = "Router name used for auto created router, or to specify an existing router to use if `router_create` is set to `true`. Leave blank to use vlan attachment name for auto created router."
type = string
default = "router-vlan-attachment"
}
variable "router_network" {
description = "A reference to the network to which this router belongs."
type = string
default = null
}

29
modules/net-interconnect-attachment-direct/versions.tf
View File

@ -1,29 +0,0 @@
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
terraform {
required_version = ">= 1.4.4"
required_providers {
google = {
source = "hashicorp/google"
version = ">= 4.60.0" # tftest
}
google-beta = {
source = "hashicorp/google-beta"
version = ">= 4.60.0" # tftest
}
}
}

13
tests/modules/net_interconnect_attachment_direct/__init__.py
View File

@ -1,13 +0,0 @@
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

30
tests/modules/net_interconnect_attachment_direct/fixture/main.tf
View File

@ -1,30 +0,0 @@
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
module "vlan-attachment-1" {
source = "../../../../modules/net-interconnect-attachment-direct"
project_id = "dedicated-ic-3-8386"
region = "us-west2"
router_create = var.router_create
router_name = var.router_name
router_config = var.router_config
router_network = var.router_network
name = var.name
interconnect = var.interconnect
config = var.config
peer = var.peer
bgp = var.bgp
}

106
tests/modules/net_interconnect_attachment_direct/fixture/variables.tf
View File

@ -1,106 +0,0 @@
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
variable "bgp" {
description = "Bgp session parameters."
type = object({
session_range = string
candidate_ip_ranges = list(string)
advertised_route_priority = number
})
default = null
}
variable "config" {
description = "VLAN attachment parameters: description, vlan_id, bandwidth, admin_enabled, interconnect."
type = object({
description = string
vlan_id = number
bandwidth = string
admin_enabled = bool
mtu = number
})
default = {
description = null
vlan_id = null
bandwidth = "BPS_10G"
admin_enabled = true
mtu = 1440
}
}
variable "interconnect" {
description = "URL of the underlying Interconnect object that this attachment's traffic will traverse through."
type = string
default = "https://www.googleapis.com/compute/v1/projects/mylab/global/interconnects/mylab-interconnect-1"
}
variable "name" {
description = "The name of the vlan attachment."
type = string
default = "vlan-603"
}
variable "peer" {
description = "Peer Ip address and asn. Only IPv4 supported."
type = object({
ip_address = string
asn = number
})
default = {
ip_address = "169.254.63.2"
asn = 65418
}
}
variable "router_config" {
description = "Router asn and custom advertisement configuration, ip_ranges is a map of address ranges and descriptions.. ."
type = object({
description = string
asn = number
advertise_config = object({
groups = list(string)
ip_ranges = map(string)
mode = string
})
})
default = {
description = null
asn = 64514
advertise_config = null
}
}
variable "router_create" {
description = "Create router."
type = bool
default = true
}
variable "router_name" {
description = "Router name used for auto created router, or to specify an existing router to use if `router_create` is set to `true`. Leave blank to use vlan attachment name for auto created router."
type = string
default = "router-vlan-attachment"
}
variable "router_network" {
description = "A reference to the network to which this router belongs."
type = string
default = "my-vpc"
}

106
tests/modules/net_interconnect_attachment_direct/test_plan.py
View File

@ -1,106 +0,0 @@
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
_VAR_BGP = (
'{'
'session_range="169.254.63.1/29", '
'candidate_ip_ranges= ["169.254.63.0/29"], '
'advertised_route_priority=0, '
'}'
)
_VAR_CONFIG = (
'{'
'description="", '
'vlan_id=603, '
'bandwidth="BPS_10G", '
'admin_enabled=true, '
'mtu=1440, '
'}'
)
_VAR_ROUTER_CONFIG = (
'{'
'description="", '
'asn=65003, '
'keepalive_interval=20, '
'advertise_config= {'
' mode="CUSTOM", '
' groups=["ALL_SUBNETS"], '
' ip_ranges = {'
' "199.36.153.8/30" = "custom" }, '
' }, '
'}'
)
def test_router_create_false(plan_runner):
"Test with no router creation."
_, resources = plan_runner(router_create='false')
assert len(resources) == 3
def test_vlanattachment(plan_runner):
"Test vlan attachment"
_, resources = plan_runner(bgp=_VAR_BGP, config=_VAR_CONFIG)
assert len(resources) == 4
for r in resources:
if r['type'] != 'google_compute_interconnect_attachment':
continue
assert r['values']['interconnect'].endswith(
'interconnects/mylab-interconnect-1')
assert r['values']['name'] == 'vlan-603'
assert r['values']['vlan_tag8021q'] == 603
assert r['values']['candidate_subnets'] == ['169.254.63.0/29']
assert r['values']['bandwidth'] == 'BPS_10G'
assert r['values']['mtu'] == '1440'
assert r['values']['admin_enabled'] == True
def test_router(plan_runner):
"Test router"
_, resources = plan_runner(router_config=_VAR_ROUTER_CONFIG)
assert len(resources) == 4
for r in resources:
if r['type'] != 'google_compute_router':
continue
assert r['values']['name'] == 'router-vlan-attachment'
assert r['values']['network'] == 'my-vpc'
assert r['values']['bgp'] == [{
'advertise_mode': 'CUSTOM',
'advertised_groups': ['ALL_SUBNETS'],
'advertised_ip_ranges': [{'description': 'custom', 'range': '199.36.153.8/30'}],
'asn': 65003,
'keepalive_interval': 20,
}]
def test_router_peer(plan_runner):
"Test router peer"
_, resources = plan_runner(bgp=_VAR_BGP)
assert len(resources) == 4
for r in resources:
if r['type'] != 'google_compute_router_peer':
continue
assert r['values']['peer_ip_address'] == '169.254.63.2'
assert r['values']['peer_asn'] == 65418
assert r['values']['interface'] == 'vlan-603'
def test_router_interface(plan_runner):
"Test router interface"
_, resources = plan_runner(bgp=_VAR_BGP)
assert len(resources) == 4
for r in resources:
if r['type'] != 'google_compute_router_interface':
continue
assert r['values']['name'] == 'interface-vlan-603'
assert r['values']['ip_range'] == '169.254.63.1/29'
assert r['values']['interconnect_attachment'] == 'vlan-603'