本文介绍如何使用Terraform创建云企业网(企业版)的VPC边界防火墙实例。
当前示例代码支持一键运行,您可以直接运行代码。
前提条件
由于阿里云账号(主账号)具有资源的所有权限,一旦发生泄露将面临重大风险。建议您使用RAM用户,并为该RAM用户创建AccessKey,具体操作方式请参见创建RAM用户和创建AccessKey。
使用以下示例为RAM用户授权,需要为该RAM用户授予以下权限:
云防火墙CloudFirewall权限和AliyunBSSFullAccess(管理费用中心BSS)权限。具体操作方式请参见为RAM用户授权。
{ "Version": "1", "Statement": [ { "Effect": "Allow", "Action": [ "yundun-cloudfirewall:CreateVpcFirewallCenConfigure", "yundun-cloudfirewall:CreateVpcFirewallCenManualConfigure", "yundun-cloudfirewall:ModifyVpcFirewallCenConfigure", "yundun-cloudfirewall:ModifyVpcFirewallCenSwitchStatus", "yundun-cloudfirewall:DeleteVpcFirewallCenConfigure", "yundun-cloudfirewall:DescribeVpcFirewallCenDetail", "yundun-cloudfirewall:DescribeVpcFirewallCenList" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "bssapi:*", "bss:*" ], "Resource": "*" } ] }
准备Terraform运行环境,您可以选择以下任一方式来使用Terraform。
在Explorer中使用Terraform:阿里云提供了Terraform的在线运行环境,您无需安装Terraform,登录后即可在线使用和体验Terraform。适用于零成本、快速、便捷地体验和调试Terraform的场景。
Cloud Shell:阿里云Cloud Shell中预装了Terraform的组件,并已配置好身份凭证,您可直接在Cloud Shell中运行Terraform的命令。适用于低成本、快速、便捷地访问和使用Terraform的场景。
在本地安装和配置Terraform:适用于网络连接较差或需要自定义开发环境的场景。
重要请确保Terraform版本不低于v0.12.28。如需检查现有版本,请运行
terraform --version
命令。
使用的资源
alicloud_cloud_firewall_vpc_cen_tr_firewall:VPC防护墙-云企业网(企业版)。
创建VPC边界防火墙
操作步骤
本示例将创建一个云企业网(企业版)的VPC边界防火墙。
创建一个工作目录,并且在工作目录中创建名为
main.tf
的配置文件。main.tfTerraform主文件,定义了将要部署的资源。内容如下:variable "name" { default = "terraform-example" } provider "alicloud" { region = "cn-hangzhou" } variable "description" { default = "Created by Terraform" } variable "firewall_name" { default = "tf-example" } variable "tr_attachment_master_cidr" { default = "192.168.3.192/26" } variable "firewall_subnet_cidr" { default = "192.168.3.0/25" } variable "region" { default = "cn-hangzhou" } variable "tr_attachment_slave_cidr" { default = "192.168.3.128/26" } variable "firewall_vpc_cidr" { default = "192.168.3.0/24" } variable "zone1" { default = "cn-hangzhou-h" } variable "firewall_name_update" { default = "tf-example-1" } variable "zone2" { default = "cn-hangzhou-i" } data "alicloud_cen_transit_router_available_resources" "default" { } data "alicloud_zones" "default" { available_resource_creation = "VSwitch" } resource "alicloud_cen_instance" "cen" { description = "terraform example" cen_instance_name = var.name } resource "alicloud_cen_transit_router" "tr" { transit_router_name = var.name transit_router_description = "tr-created-by-terraform" cen_id = alicloud_cen_instance.cen.id } resource "alicloud_vpc" "vpc1" { description = "created by terraform" cidr_block = "192.168.1.0/24" vpc_name = var.name } resource "alicloud_vswitch" "vpc1vsw1" { cidr_block = "192.168.1.0/25" vswitch_name = var.name vpc_id = alicloud_vpc.vpc1.id zone_id = data.alicloud_cen_transit_router_available_resources.default.resources[0].master_zones[1] } resource "alicloud_vswitch" "vpc1vsw2" { vpc_id = alicloud_vpc.vpc1.id cidr_block = "192.168.1.128/26" vswitch_name = var.name zone_id = data.alicloud_cen_transit_router_available_resources.default.resources[0].master_zones[2] } resource "alicloud_route_table" "foo" { vpc_id = alicloud_vpc.vpc1.id route_table_name = var.name description = var.name } resource "alicloud_cen_transit_router_vpc_attachment" "tr-vpc1" { zone_mappings { vswitch_id = alicloud_vswitch.vpc1vsw1.id zone_id = data.alicloud_cen_transit_router_available_resources.default.resources[0].master_zones[1] } zone_mappings { zone_id = data.alicloud_cen_transit_router_available_resources.default.resources[0].master_zones[2] vswitch_id = alicloud_vswitch.vpc1vsw2.id } vpc_id = alicloud_vpc.vpc1.id cen_id = alicloud_cen_instance.cen.id transit_router_id = alicloud_cen_transit_router.tr.transit_router_id depends_on = [alicloud_route_table.foo] } resource "time_sleep" "wait_10_minutes" { depends_on = [alicloud_cen_transit_router_vpc_attachment.tr-vpc1] create_duration = "10m" } resource "alicloud_cloud_firewall_vpc_cen_tr_firewall" "default" { cen_id = alicloud_cen_transit_router_vpc_attachment.tr-vpc1.cen_id firewall_name = var.name firewall_subnet_cidr = var.firewall_subnet_cidr tr_attachment_slave_cidr = var.tr_attachment_slave_cidr firewall_description = "VpcCenTrFirewall created by terraform" region_no = var.region tr_attachment_master_cidr = var.tr_attachment_master_cidr firewall_vpc_cidr = var.firewall_vpc_cidr transit_router_id = alicloud_cen_transit_router.tr.transit_router_id route_mode = "managed" depends_on = [time_sleep.wait_10_minutes] }
执行以下命令,初始化
Terraform
运行环境。terraform init
返回如下信息,表示Terraform初始化成功。
Initializing the backend... Initializing provider plugins... - Checking for available provider plugins... - Downloading plugin for provider "time" (hashicorp/time) 0.12.1... - Downloading plugin for provider "alicloud" (hashicorp/alicloud) 1.238.0... The following providers do not have any version constraints in configuration, so the latest version was installed. To prevent automatic upgrades to new major versions that may contain breaking changes, it is recommended to add version = "..." constraints to the corresponding provider blocks in configuration, with the constraint strings suggested below. * provider.alicloud: version = "~> 1.238" * provider.time: version = "~> 0.12" Warning: registry.terraform.io: For users on Terraform 0.13 or greater, this provider has moved to aliyun/alicloud. Please update your source in required_providers. Terraform has been successfully initialized! You may now begin working with Terraform. Try running "terraform plan" to see any changes that are required for your infrastructure. All Terraform commands should now work. If you ever set or change modules or backend configuration for Terraform, rerun this command to reinitialize your working directory. If you forget, other commands will detect it and remind you to do so if necessary.
创建执行计划,并预览变更。
terraform plan
执行以下命令,创建VPC边界防火墙 。
terraform apply
在执行过程中,根据提示输入
yes
并按下Enter键,等待命令执行完成,若出现以下信息,则表示VPC边界防火墙创建成功。说明根据
main.tf
中定义的资源,无实例会创建,有实例则变更,不同账号下的资源不同,plan和apply时提示的数量也不同。请以使用账号下的资源实际情况为准。alicloud_vpc.vpc1: Creating... alicloud_vpc.vpc1: Creation complete after 7s [id=vpc-bp1apj641aaonvpocqrn8] alicloud_route_table.foo: Creating... alicloud_vswitch.vpc1vsw1: Creating... alicloud_vswitch.vpc1vsw2: Creating... alicloud_route_table.foo: Creation complete after 3s [id=vtb-bp1owz6rahb5oqftbd4pt] alicloud_vswitch.vpc1vsw1: Creation complete after 7s [id=vsw-bp1kqr2wtnz9nyqzpqpvg] alicloud_vswitch.vpc1vsw2: Still creating... [10s elapsed] alicloud_vswitch.vpc1vsw2: Creation complete after 13s [id=vsw-bp1dpzmh55f6ezk3m1q02] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Creating... alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [10s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [20s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [30s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [40s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [50s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [1m0s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Still creating... [1m10s elapsed] alicloud_cen_transit_router_vpc_attachment.tr-vpc1: Creation complete after 1m17s [id=cen-9sbqmk479yu5y1y66d:tr-attach-e9ji0mjibg9y10ets4] time_sleep.wait_10_minutes: Creating... time_sleep.wait_10_minutes: Still creating... [10s elapsed] time_sleep.wait_10_minutes: Still creating... [20s elapsed] time_sleep.wait_10_minutes: Still creating... [30s elapsed] time_sleep.wait_10_minutes: Still creating... [40s elapsed] time_sleep.wait_10_minutes: Still creating... [50s elapsed] time_sleep.wait_10_minutes: Still creating... [1m0s elapsed] time_sleep.wait_10_minutes: Still creating... [1m10s elapsed] time_sleep.wait_10_minutes: Still creating... [1m20s elapsed] time_sleep.wait_10_minutes: Still creating... [1m30s elapsed] time_sleep.wait_10_minutes: Still creating... [1m40s elapsed] time_sleep.wait_10_minutes: Still creating... [1m50s elapsed] time_sleep.wait_10_minutes: Still creating... [2m0s elapsed] time_sleep.wait_10_minutes: Still creating... [2m10s elapsed] time_sleep.wait_10_minutes: Still creating... [2m20s elapsed] time_sleep.wait_10_minutes: Still creating... [2m30s elapsed] time_sleep.wait_10_minutes: Still creating... [2m40s elapsed] time_sleep.wait_10_minutes: Still creating... [2m50s elapsed] time_sleep.wait_10_minutes: Still creating... [3m0s elapsed] time_sleep.wait_10_minutes: Still creating... [3m10s elapsed] time_sleep.wait_10_minutes: Still creating... [3m20s elapsed] time_sleep.wait_10_minutes: Still creating... [3m30s elapsed] time_sleep.wait_10_minutes: Still creating... [3m40s elapsed] time_sleep.wait_10_minutes: Still creating... [3m50s elapsed] time_sleep.wait_10_minutes: Still creating... [4m0s elapsed] time_sleep.wait_10_minutes: Still creating... [4m10s elapsed] time_sleep.wait_10_minutes: Still creating... [4m20s elapsed] time_sleep.wait_10_minutes: Still creating... [4m30s elapsed] time_sleep.wait_10_minutes: Still creating... [4m40s elapsed] time_sleep.wait_10_minutes: Still creating... [4m50s elapsed] time_sleep.wait_10_minutes: Still creating... [5m0s elapsed] time_sleep.wait_10_minutes: Still creating... [5m10s elapsed] time_sleep.wait_10_minutes: Still creating... [5m20s elapsed] time_sleep.wait_10_minutes: Still creating... [5m30s elapsed] time_sleep.wait_10_minutes: Still creating... [5m40s elapsed] time_sleep.wait_10_minutes: Still creating... [5m50s elapsed] time_sleep.wait_10_minutes: Still creating... [6m0s elapsed] time_sleep.wait_10_minutes: Still creating... [6m10s elapsed] time_sleep.wait_10_minutes: Still creating... [6m20s elapsed] time_sleep.wait_10_minutes: Still creating... [6m30s elapsed] time_sleep.wait_10_minutes: Still creating... [6m40s elapsed] time_sleep.wait_10_minutes: Still creating... [6m50s elapsed] time_sleep.wait_10_minutes: Still creating... [7m0s elapsed] time_sleep.wait_10_minutes: Still creating... [7m10s elapsed] time_sleep.wait_10_minutes: Still creating... [7m20s elapsed] time_sleep.wait_10_minutes: Still creating... [7m30s elapsed] time_sleep.wait_10_minutes: Still creating... [7m40s elapsed] time_sleep.wait_10_minutes: Still creating... [7m50s elapsed] time_sleep.wait_10_minutes: Still creating... [8m0s elapsed] time_sleep.wait_10_minutes: Still creating... [8m10s elapsed] time_sleep.wait_10_minutes: Still creating... [8m20s elapsed] time_sleep.wait_10_minutes: Still creating... [8m30s elapsed] time_sleep.wait_10_minutes: Still creating... [8m40s elapsed] time_sleep.wait_10_minutes: Still creating... [8m50s elapsed] time_sleep.wait_10_minutes: Still creating... [9m0s elapsed] time_sleep.wait_10_minutes: Still creating... [9m10s elapsed] time_sleep.wait_10_minutes: Still creating... [9m20s elapsed] time_sleep.wait_10_minutes: Still creating... [9m30s elapsed] time_sleep.wait_10_minutes: Still creating... [9m40s elapsed] time_sleep.wait_10_minutes: Still creating... [9m50s elapsed] time_sleep.wait_10_minutes: Still creating... [10m0s elapsed] time_sleep.wait_10_minutes: Creation complete after 10m0s [id=2024-12-17T03:55:32Z] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Creating... alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [10s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [20s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [30s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [40s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [50s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m0s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m10s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m20s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m30s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m40s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [1m50s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m0s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m10s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m20s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m30s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m40s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [2m50s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m0s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m10s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m20s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m30s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m40s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [3m50s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [4m0s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [4m10s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [4m20s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Still creating... [4m30s elapsed] alicloud_cloud_firewall_vpc_cen_tr_firewall.default: Creation complete after 4m39s [id=vfw-tr-f6524a0da36e44d285f8] Apply complete! Resources: 7 added, 0 changed, 0 destroyed.
验证结果
执行terraform show命令
您可以使用以下命令查询Terraform已创建的资源详细信息。
terraform show
登录云防火墙控制台
清理资源
当您不再需要上述通过Terraform创建或管理的资源时,请运行以下命令以释放资源。关于terraform destroy
的更多信息,请参见Terraform常用命令。
terraform destroy
完整示例
当前示例代码支持在OpenAPI门户在线调试。