用 Terraform 在华为云上搭建基础设施:从 VPC 到 ECS 的完整实战
为什么用 Terraform?
如果你在控制台手动建过云资源,一定经历过这种痛苦:建了一堆 VPC、子网、安全组、ECS,过了一个月回来,完全记不清当时怎么配的。更糟的是,换个人来维护,面对一堆"不知道谁建的、不知道为什么建"的资源,根本不敢动。
Terraform 解决的就是这个问题——用代码描述基础设施。你的 VPC 用什么网段、安全组开了哪些端口、ECS 用什么规格,全部写在一个 .tf 文件里。代码就是文档,代码就是真相。
这篇文章带你从零开始,用 Terraform 在华为云上搭建一套完整的网络 + 计算基础设施。
一、环境准备
首先安装 Terraform CLI。华为云提供了国内镜像源,下载速度有保障,不用翻墙。
安装完成后,在终端验证:
terraform version
看到版本号输出就说明安装成功。
接下来准备华为云的认证信息,需要三样东西:
- AK / SK:在华为云控制台「我的凭证」页面创建访问密钥
- Region:比如 cn-north-4(华北-北京四)
- Project ID:同样在「我的凭证」页面可以查到
建议通过环境变量传入,不要硬编码到代码里:
export HW_ACCESS_KEY="你的AK"
export HW_SECRET_KEY="你的SK"
export HW_REGION_NAME="cn-north-4"
export HW_PROJECT_ID="你的项目ID"
二、初始化项目
新建一个目录,创建 main.tf 文件,先写 provider 配置:
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = var.region
}
再创建 variables.tf,把可变参数抽出来:
variable "region" {
description = "华为云区域"
default = "cn-north-4"
}
variable "vpc_cidr" {
description = "VPC 网段"
default = "192.168.0.0/16"
}
variable "subnet_cidr" {
description = "子网网段"
default = "192.168.1.0/24"
}
variable "ecs_password" {
description = "ECS 初始密码"
type = string
sensitive = true
}
把密码标记为 sensitive,这样 Terraform 在执行计划输出时不会明文显示。
三、创建网络:VPC + 子网 + 安全组
网络是基础设施的骨架。我们先建一个 VPC、一个子网、一个安全组:
# VPC
resource "huaweicloud_vpc" "main" {
name = "tf-demo-vpc"
cidr = var.vpc_cidr
}
# 子网
resource "huaweicloud_vpc_subnet" "main" {
name = "tf-demo-subnet"
cidr = var.subnet_cidr
gateway_ip = "192.168.1.1"
vpc_id = huaweicloud_vpc.main.id
}
# 安全组
resource "huaweicloud_networking_secgroup" "web" {
name = "tf-demo-secgroup"
description = "Web 服务器安全组"
}
# 安全组规则:放行 SSH
resource "huaweicloud_networking_secgroup_rule" "ssh" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 22
port_range_max = 22
remote_ip_prefix = "0.0.0.0/0"
security_group_id = huaweicloud_networking_secgroup.web.id
}
# 安全组规则:放行 HTTP
resource "huaweicloud_networking_secgroup_rule" "http" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 80
port_range_max = 80
remote_ip_prefix = "0.0.0.0/0"
security_group_id = huaweicloud_networking_secgroup.web.id
}
这里有个重要提醒:上面安全组规则把 SSH(22 端口)对 0.0.0.0/0 开放,这在演示环境里可以,但在生产环境里是高风险操作。生产环境建议把 remote_ip_prefix 改成你自己的运维网段或堡垒机 IP,不要对全网开放 SSH。
四、创建 ECS 实例
网络就绪后,创建一台 ECS:
# 查询可用镜像
data "huaweicloud_images_image" "ubuntu" {
name = "Ubuntu 22.04 server 64bit"
most_recent = true
}
# ECS
resource "huaweicloud_compute_instance" "web" {
name = "tf-demo-ecs"
image_id = data.huaweicloud_images_image.ubuntu.id
flavor_id = "s6.large.2"
availability_zone = "cn-north-4a"
system_disk_type = "SAS"
system_disk_size = 40
network {
uuid = huaweicloud_vpc_subnet.main.id
}
security_group_ids = [
huaweicloud_networking_secgroup.web.id
]
admin_pass = var.ecs_password
}
几个关键点解释一下:
- flavor_id:
s6.large.2表示通用计算型 s6 系列,2 核 4G。规格选择取决于你的负载类型,计算密集型选 c 系列,内存密集型选 m 系列 - availability_zone:这里只选了一个 AZ(cn-north-4a)。如果是高可用场景,至少要跨两个 AZ 部署多台 ECS,单 AZ 不具备容灾能力
- system_disk_type:SAS 是高 IO 类型,适合大多数场景。如果预算紧张可以用 SATA,数据库场景建议用 SSD
五、分配弹性公网 IP
如果这台 ECS 需要被外网访问,给它挂一个 EIP:
resource "huaweicloud_vpc_eip" "web" {
publicip {
type = "5_bgp"
}
bandwidth {
name = "tf-demo-bandwidth"
size = 5
share_type = "PER"
charge_mode = "traffic"
}
}
resource "huaweicloud_compute_eip_associate" "web" {
public_ip = huaweicloud_vpc_eip.web.address
instance_id = huaweicloud_compute_instance.web.id
}
- 5_bgp:表示 5 线 BGP,国内访问质量最好
- share_type = PER:独享带宽。如果有多台 ECS 共享出口带宽,可以改成 WHOLE(共享带宽)
- charge_mode = traffic:按流量计费。如果是常驻高带宽场景,按带宽计费更划算
六、执行部署
所有代码写好后,三步走:
# 1. 初始化,下载 provider 插件
terraform init
# 2. 查看执行计划,确认要创建哪些资源
terraform plan
# 3. 确认无误后执行
terraform apply
terraform plan 这一步非常重要——它会告诉你即将创建、修改、删除哪些资源,在 apply 之前一定要看清楚。尤其是后续迭代修改代码时,plan 能帮你发现"本来只想改个安全组规则,结果触发了 ECS 重建"这种意外情况。
七、一些实战心得
1. 状态文件要妥善管理
Terraform 用一个 terraform.tfstate 文件记录当前基础设施的实际状态。这个文件非常重要——丢了就意味着 Terraform 不知道云端到底有什么资源,管理就失控了。团队协作时建议把 state 文件放到 OBS 桶里远程管理,不要提交到 Git 仓库(里面可能含敏感信息)。
2. 销毁资源别忘了
用 Terraform 创建的资源,用完可以一键销毁:
terraform destroy
这会按依赖顺序依次删除所有资源。测试环境用完随手清理,避免忘记导致持续计费。
3. 改代码时注意 force-new
有些属性修改会触发资源重建(比如 ECS 换镜像、换 AZ)。Terraform plan 的输出里会标注 forces replacement,看到这个要格外留意——重建意味着旧实例删除、新实例创建,上面的数据会丢失。
4. 不要手动改 Terraform 管理的资源
如果某个资源是 Terraform 创建的,后续要修改就改 Terraform 代码再 apply。如果去控制台手动改了,Terraform 的 state 和实际就不一致了(这叫 drift),再 apply 时可能产生意外行为。
写在最后
Terraform 的核心思想很简单:基础设施即代码。但真正用好它,需要对云上资源的属性和依赖关系有清晰的理解。这篇实战只是入门,覆盖了最常用的 VPC + 子网 + 安全组 + ECS + EIP 这条链路。实际项目中还会涉及 RDS、ELB、NAT 网关、CCE 等,但方法论是一样的——用代码描述,用 plan 审查,用 apply 落地。
把你的基础设施交给代码管理,一次编写,反复复用,团队共享。这比在控制台上点来点去,要可靠得多。
- 点赞
- 收藏
- 关注作者
评论(0)