Skip to content

Commit a7344d2

Browse files
shanye997shanye997
committed
init the module
1 parent 78b2a57 commit a7344d2

23 files changed

+1434
-1
lines changed

‎.gitignore‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
**/.terraform/
2+
**/.terraform.lock.hcl
3+
**/terraform.tfstate
4+
**/terraform.tfstate.backup
5+
**/.terraform.tfstate.lock.info

‎CHANGELOG.md‎

Whitespace-only changes.

‎README-CN.md‎

Lines changed: 203 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,203 @@
1+
Terraform module to build cross-region network communication between different regions in the cloud and on-premises for Alibaba Cloud
2+
3+
terraform-alicloud-cen-cross-region-networking-between-local-idc-and-remote-vpc
4+
======================================
5+
6+
[English](https://github.com/alibabacloud-automation/terraform-alicloud-cen-cross-region-networking-between-local-idc-and-remote-vpc/blob/main/README.md) | 简体中文
7+
8+
本模块重点介绍私有网络VPC实例/专线VBR实例被连接至转发路由器后，可以在转发路由器下创建跨地域连接，并为跨地域连接分配带宽，从而实现云上云下不同地域间的跨地域互通网络。整体方案如下：
9+
- IDC上云专线接入：通过上云专线打通IDC与阿里云杭州。企业IDC与阿里云专线Pop点考虑到冗余性，建议优先考虑双物理专线，并可以按需配置为双链路主备或负载冗余的方式，提升混合云互通时的整体可靠性。
10+
- 云上跨地域：通过TR构建阿里云北京-杭州跨地域连接，同时开通CDT跨域带宽按流量计费，打通北京VPC与杭州IDC。
11+
12+
架构图:
13+
14+
<img src="https://raw.githubusercontent.com/alibabacloud-automation/terraform-alicloud-cen-cross-region-networking-between-local-idc-and-remote-vpc/main/scripts/diagram-CN.png" alt="Architecture Diagram" width="600" height="200">
15+
16+
## 用法
17+
18+
在北京区域创建 VPC, 在杭州区域创建 VPC 和 VBR。
19+
20+
```hcl
21+
provider "alicloud" {
22+
alias = "local_region"
23+
region = "cn-hangzhou"
24+
}
25+
26+
provider "alicloud" {
27+
alias = "remote_region"
28+
region = "cn-beijing"
29+
}
30+
31+
data "alicloud_express_connect_physical_connections" "example" {
32+
provider = alicloud.local_region
33+
name_regex = "^preserved-NODELETING"
34+
}
35+
36+
module "complete" {
37+
source = "alibabacloud-automation/cen-cross-region-networking-between-local-idc-and-remote-vpc/alicloud"
38+
providers = {
39+
alicloud.local_region = alicloud.local_region
40+
alicloud.remote_region = alicloud.remote_region
41+
}
42+
43+
local_vpc_config = [{
44+
vpc = {
45+
cidr_block = "10.0.0.0/16"
46+
}
47+
vswitches = [{
48+
zone_id = "cn-hangzhou-j"
49+
cidr_block = "10.0.1.0/24"
50+
}, {
51+
zone_id = "cn-hangzhou-k"
52+
cidr_block = "10.0.2.0/24"
53+
}]
54+
}]
55+
56+
57+
local_vbr_config = [
58+
{
59+
vbr = {
60+
physical_connection_id = data.alicloud_express_connect_physical_connections.example.connections[0].id
61+
vlan_id = 210
62+
local_gateway_ip = "192.168.0.1"
63+
peer_gateway_ip = "192.168.0.2"
64+
peering_subnet_mask = "255.255.255.252"
65+
virtual_border_router_name = "vbr_1_name"
66+
description = "vbr_1_description"
67+
},
68+
vbr_bgp_group = {
69+
peer_asn = 45000
70+
}
71+
},
72+
{
73+
vbr = {
74+
physical_connection_id = data.alicloud_express_connect_physical_connections.example.connections[1].id
75+
vlan_id = 211
76+
local_gateway_ip = "192.168.1.1"
77+
peer_gateway_ip = "192.168.1.2"
78+
peering_subnet_mask = "255.255.255.252"
79+
virtual_border_router_name = "vbr_2_name"
80+
description = "vbr_2_description"
81+
},
82+
vbr_bgp_group = {
83+
peer_asn = 45000
84+
}
85+
}
86+
]
87+
88+
89+
remote_vpc_config = [{
90+
vpc = {
91+
cidr_block = "10.1.0.0/16"
92+
}
93+
vswitches = [{
94+
zone_id = "cn-beijing-j"
95+
cidr_block = "10.1.1.0/24"
96+
}, {
97+
zone_id = "cn-beijing-k"
98+
cidr_block = "10.1.2.0/24"
99+
}]
100+
}]
101+
}
102+
```
103+
104+
105+
## 示例
106+
107+
* [完整示例](https://github.com/alibabacloud-automation/terraform-alicloud-cen-cross-region-networking-between-local-idc-and-remote-vpc/tree/main/examples/complete)
108+
109+
110+
<!-- BEGIN_TF_DOCS -->
111+
## Requirements
112+
113+
| Name | Version |
114+
|------|---------|
115+
| <a name="requirement_terraform"></a> [terraform](#requirement\_terraform) | >= 0.13 |
116+
117+
## Providers
118+
119+
| Name | Version |
120+
|------|---------|
121+
| <a name="provider_alicloud"></a> [alicloud](#provider\_alicloud) | n/a |
122+
| <a name="provider_alicloud.local_region"></a> [alicloud.local\_region](#provider\_alicloud.local\_region) | n/a |
123+
| <a name="provider_alicloud.remote_region"></a> [alicloud.remote\_region](#provider\_alicloud.remote\_region) | n/a |
124+
125+
## Modules
126+
127+
| Name | Source | Version |
128+
|------|--------|---------|
129+
| <a name="module_local_vbr"></a> [local\_vbr](#module\_local\_vbr) | ./modules/vbr | n/a |
130+
| <a name="module_local_vpc"></a> [local\_vpc](#module\_local\_vpc) | ./modules/vpc | n/a |
131+
| <a name="module_remote_vpc"></a> [remote\_vpc](#module\_remote\_vpc) | ./modules/vpc | n/a |
132+
133+
## Resources
134+
135+
| Name | Type |
136+
|------|------|
137+
| [alicloud_cen_instance.this](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_instance) | resource |
138+
| [alicloud_cen_transit_router.tr_local](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router) | resource |
139+
| [alicloud_cen_transit_router.tr_remote](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router) | resource |
140+
| [alicloud_cen_transit_router_peer_attachment.this](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router_peer_attachment) | resource |
141+
| [alicloud_cen_transit_router_route_table_association.tr_local](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router_route_table_association) | resource |
142+
| [alicloud_cen_transit_router_route_table_association.tr_remote](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router_route_table_association) | resource |
143+
| [alicloud_cen_transit_router_route_table_propagation.tr_local](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router_route_table_propagation) | resource |
144+
| [alicloud_cen_transit_router_route_table_propagation.tr_remote](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/resources/cen_transit_router_route_table_propagation) | resource |
145+
| [alicloud_cen_transit_router_route_tables.tr_local](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/data-sources/cen_transit_router_route_tables) | data source |
146+
| [alicloud_cen_transit_router_route_tables.tr_remote](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/data-sources/cen_transit_router_route_tables) | data source |
147+
| [alicloud_regions.remote](https://registry.terraform.io/providers/hashicorp/alicloud/latest/docs/data-sources/regions) | data source |
148+
149+
## Inputs
150+
151+
| Name | Description | Type | Default | Required |
152+
|------|-------------|------|---------|:--------:|
153+
| <a name="input_cen_instance_config"></a> [cen\_instance\_config](#input\_cen\_instance\_config) | The parameters of cen instance. | <pre>object({<br> cen_instance_name = optional(string, "cen-cross-region")<br> description = optional(string, "CEN instance for cross-region connectivity")<br> })</pre> | `{}` | no |
154+
| <a name="input_local_tr_config"></a> [local\_tr\_config](#input\_local\_tr\_config) | The parameters of transit router. | <pre>object({<br> transit_router_name = optional(string, "tr-local")<br> transit_router_description = optional(string, null)<br> })</pre> | `{}` | no |
155+
| <a name="input_local_vbr_config"></a> [local\_vbr\_config](#input\_local\_vbr\_config) | The list parameters of local vbr resources. The attributes 'vbr', 'vbr\_bgp\_group' are required. | <pre>list(object({<br> vbr = object({<br> physical_connection_id = string<br> vlan_id = number<br> local_gateway_ip = string<br> peer_gateway_ip = string<br> peering_subnet_mask = string<br> virtual_border_router_name = optional(string, null)<br> description = optional(string, null)<br> })<br> tr_vbr_attachment = optional(object({<br> transit_router_attachment_name = optional(string, null)<br> transit_router_attachment_description = optional(string, null)<br> auto_publish_route_enabled = optional(bool, true)<br> route_table_propagation_enabled = optional(bool, true)<br> route_table_association_enabled = optional(bool, true)<br> }), {})<br> vbr_health_check = optional(object({<br> health_check_interval = optional(number, 2)<br> healthy_threshold = optional(number, 8)<br> }), {})<br> vbr_bgp_group = object({<br> peer_asn = string<br> auth_key = optional(string, null)<br> bgp_group_name = optional(string, null)<br> })<br> vbr_bgp_peer = optional(object({<br> bfd_multi_hop = optional(number, 255)<br> enable_bfd = optional(bool, "false")<br> ip_version = optional(string, "IPV4")<br> peer_ip_address = optional(string, null)<br> }), {})<br> }))</pre> | `[]` | no |
156+
| <a name="input_local_vpc_config"></a> [local\_vpc\_config](#input\_local\_vpc\_config) | The parameters of local vpc resources. The attributes 'vpc', 'vswitches' are required. | <pre>list(object({<br> vpc = object({<br> cidr_block = string<br> vpc_name = optional(string, null)<br> })<br> vswitches = list(object({<br> zone_id = string<br> cidr_block = string<br> vswitch_name = optional(string, null)<br> }))<br> tr_vpc_attachment = optional(object({<br> transit_router_attachment_name = optional(string, null)<br> auto_publish_route_enabled = optional(bool, true)<br> route_table_propagation_enabled = optional(bool, true)<br> route_table_association_enabled = optional(bool, true)<br> }), {})<br> }))</pre> | `[]` | no |
157+
| <a name="input_remote_tr_config"></a> [remote\_tr\_config](#input\_remote\_tr\_config) | The parameters of transit router. | <pre>object({<br> transit_router_name = optional(string, "tr-remote")<br> transit_router_description = optional(string, null)<br> })</pre> | `{}` | no |
158+
| <a name="input_remote_vpc_config"></a> [remote\_vpc\_config](#input\_remote\_vpc\_config) | The parameters of remote vpc resources. The attributes 'vpc', 'vswitches' are required. | <pre>list(object({<br> vpc = object({<br> cidr_block = string<br> vpc_name = optional(string, null)<br> })<br> vswitches = list(object({<br> zone_id = string<br> cidr_block = string<br> vswitch_name = optional(string, null)<br> }))<br> tr_vpc_attachment = optional(object({<br> transit_router_attachment_name = optional(string, null)<br> auto_publish_route_enabled = optional(bool, true)<br> route_table_propagation_enabled = optional(bool, true)<br> route_table_association_enabled = optional(bool, true)<br> }), {})<br> }))</pre> | `[]` | no |
159+
| <a name="input_tr_peer_attachment"></a> [tr\_peer\_attachment](#input\_tr\_peer\_attachment) | The parameters of transit router peer attachment. | <pre>object({<br> transit_router_attachment_name = optional(string, null)<br> auto_publish_route_enabled = optional(bool, true)<br> route_table_propagation_enabled = optional(bool, true)<br> route_table_association_enabled = optional(bool, true)<br> bandwidth_type = optional(string, "DataTransfer")<br> bandwidth = optional(number, 100)<br><br> })</pre> | `{}` | no |
160+
161+
## Outputs
162+
163+
| Name | Description |
164+
|------|-------------|
165+
| <a name="output_cen_instance_id"></a> [cen\_instance\_id](#output\_cen\_instance\_id) | The id of CEN instance. |
166+
| <a name="output_local_bgp_group_id"></a> [local\_bgp\_group\_id](#output\_local\_bgp\_group\_id) | The id of BGP group. |
167+
| <a name="output_local_bgp_peer_id"></a> [local\_bgp\_peer\_id](#output\_local\_bgp\_peer\_id) | The id of BGP peer. |
168+
| <a name="output_local_cen_transit_router_id"></a> [local\_cen\_transit\_router\_id](#output\_local\_cen\_transit\_router\_id) | The id of local CEN transit router. |
169+
| <a name="output_local_health_check_id"></a> [local\_health\_check\_id](#output\_local\_health\_check\_id) | The id of health check. |
170+
| <a name="output_local_tr_vbr_attachment_id"></a> [local\_tr\_vbr\_attachment\_id](#output\_local\_tr\_vbr\_attachment\_id) | The id of attachment bewteen TR and VBR. |
171+
| <a name="output_local_tr_vpc_attachment_id"></a> [local\_tr\_vpc\_attachment\_id](#output\_local\_tr\_vpc\_attachment\_id) | The id of attachment between TR and local VPC. |
172+
| <a name="output_local_vbr_id"></a> [local\_vbr\_id](#output\_local\_vbr\_id) | The id of VBR. |
173+
| <a name="output_local_vbr_route_table_id"></a> [local\_vbr\_route\_table\_id](#output\_local\_vbr\_route\_table\_id) | The route table id of VBR. |
174+
| <a name="output_local_vpc_id"></a> [local\_vpc\_id](#output\_local\_vpc\_id) | The local vpc id. |
175+
| <a name="output_local_vpc_route_table_id"></a> [local\_vpc\_route\_table\_id](#output\_local\_vpc\_route\_table\_id) | The route table id of local vpc. |
176+
| <a name="output_local_vswitch_ids"></a> [local\_vswitch\_ids](#output\_local\_vswitch\_ids) | The local ids of vswitches. |
177+
| <a name="output_remote_cen_transit_router_id"></a> [remote\_cen\_transit\_router\_id](#output\_remote\_cen\_transit\_router\_id) | The id of remote CEN transit router. |
178+
| <a name="output_remote_tr_vpc_attachment_id"></a> [remote\_tr\_vpc\_attachment\_id](#output\_remote\_tr\_vpc\_attachment\_id) | The id of attachment between TR and remote VPC. |
179+
| <a name="output_remote_vpc_id"></a> [remote\_vpc\_id](#output\_remote\_vpc\_id) | The remote vpc id. |
180+
| <a name="output_remote_vpc_route_table_id"></a> [remote\_vpc\_route\_table\_id](#output\_remote\_vpc\_route\_table\_id) | The route table id of remote vpc. |
181+
| <a name="output_remote_vswitch_ids"></a> [remote\_vswitch\_ids](#output\_remote\_vswitch\_ids) | The remote ids of vswitches. |
182+
| <a name="output_tr_peer_attachment_id"></a> [tr\_peer\_attachment\_id](#output\_tr\_peer\_attachment\_id) | The id of attachment between local TR and remote TR. |
183+
<!-- END_TF_DOCS -->
184+
185+
## 提交问题
186+
187+
如果在使用该 Terraform Module 的过程中有任何问题，可以直接创建一个 [Provider Issue](https://github.com/aliyun/terraform-provider-alicloud/issues/new)，我们将根据问题描述提供解决方案。
188+
189+
**注意:** 不建议在该 Module 仓库中直接提交 Issue。
190+
191+
## 作者
192+
193+
Created and maintained by Alibaba Cloud Terraform Team(terraform@alibabacloud.com).
194+
195+
## 许可
196+
197+
MIT Licensed. See LICENSE for full details.
198+
199+
## 参考
200+
201+
* [Terraform-Provider-Alicloud Github](https://github.com/aliyun/terraform-provider-alicloud)
202+
* [Terraform-Provider-Alicloud Release](https://releases.hashicorp.com/terraform-provider-alicloud/)
203+
* [Terraform-Provider-Alicloud Docs](https://registry.terraform.io/providers/aliyun/alicloud/latest/docs)

0 commit comments

Comments
 (0)