从零开始用 Terraform 管理华为云:一个 VPC + ECS 的最小可运行示例
【摘要】 本文面向"熟悉云控制台但没用过 IaC"的读者,用二十几行 Terraform 配置在华为云上创建一个 VPC + ECS 的最小可运行示例。先讲清 Resource、Provider、State 三个核心概念,再逐段解释配置代码与华为云资源的对应关系,最后给出 init / plan / apply 的实操流程和四条踩坑提醒。目标:让读者跑通一次完整流程,理解声明式配置相比手动操作的本质优势——
如果你一直在控制台里手动创建资源,大概率遇到过这些场景:
- 测试环境搭好了,要再搭一个一模一样的,只能逐项点一遍;
- 某个安全组规则改了,但没人记得改了什么,出了问题排查半天;
- 同事问你环境怎么搭的,你写了一份 Word 文档,三个月后已经和实际对不上了。
这些问题本质上是同一个:基础设施没有被"代码"描述,只存在于人的记忆和 console 的点击里。 Terraform 要解决的就是这件事——用声明式配置文件描述你想要什么,由工具去创建、更新、销毁,并且把当前状态记录下来。
Terraform 的核心心智模型
不需要一上来就背语法,先理解三个概念:
- Resource(资源):你想要的一个云资源,比如一个 VPC、一台 ECS。你在文件里"声明"它的属性,Terraform 负责让它存在。
- Provider(提供商):告诉 Terraform 你要操作哪个云。华为云的 provider 是
huaweicloud,它把 Terraform 的通用语法翻译成华为云的 API 调用。 - State(状态):Terraform 在本地(或远端)维护一份
terraform.tfstate,记录"当前实际创建了什么"。每次plan时,它拿配置文件和 state 做对比,算出差异;apply时把差异执行掉。
理解了这三点,下面的代码就不是"模板",而是可读的描述。
最小示例:一个 VPC + 一台 ECS
# provider.tf — 告诉 Terraform 用华为云,以及认证方式
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = "cn-north-4"
# 推荐通过环境变量传入 AK/SK,不要硬编码进文件
# export HW_ACCESS_KEY="你的AK"
# export HW_SECRET_KEY="你的SK"
}
# network.tf — 一个 VPC、一个子网、一个安全组
resource "huaweicloud_vpc" "demo" {
name = "vpc-terraform-demo"
cidr = "192.168.0.0/16"
}
resource "huaweicloud_vpc_subnet" "demo" {
vpc_id = huaweicloud_vpc.demo.id
name = "subnet-terraform-demo"
cidr = "192.168.0.0/24"
gateway_ip = "192.168.0.1"
}
resource "huaweicloud_networking_secgroup" "demo" {
name = "sg-terraform-demo"
description = "允许 SSH 入站"
}
resource "huaweicloud_networking_secgroup_rule" "ssh" {
security_group_id = huaweicloud_networking_secgroup.demo.id
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 22
port_range_max = 22
remote_ip_prefix = "0.0.0.0/0" # 生产环境请收窄到你的 IP
}
# compute.tf — 一台 ECS,用上面创建的网络资源
resource "huaweicloud_compute_instance" "demo" {
name = "ecs-terraform-demo"
flavor_id = "s6.large.2"
image_id = "你的镜像ID" # 可通过 data source 动态查询
availability_zone = "cn-north-4a"
network {
uuid = huaweicloud_vpc_subnet.demo.id
}
security_group_ids = [
huaweicloud_networking_secgroup.demo.id
]
}
注意看 network 块里的 uuid = huaweicloud_vpc_subnet.demo.id——这里没有写死任何 ID,而是引用了同一个配置里上面定义的子网资源。Terraform 会自动算出依赖关系:先建 VPC,再建子网,最后建 ECS。你不需要手动排顺序,这是声明式配置最大的好处之一。
三个命令走完一遍
terraform init # 下载 provider 插件,初始化后端
terraform plan # 预览:会创建什么、改什么、删什么,不实际执行
terraform apply # 执行,会再让你确认一次
plan 的输出值得仔细读。它会告诉你:
# huaweicloud_vpc.demo will be created
+ resource "huaweicloud_vpc" "demo" {
+ cidr = "192.168.0.0/16"
+ id = (known after apply)
+ name = "vpc-terraform-demo"
}
+ 表示新增,~ 表示修改,- 表示销毁。养成先看 plan 再 apply 的习惯,尤其当你改了已有资源的配置时——某些属性变了会触发 force-new(销毁重建),你不会想在生产环境里意外删掉一台机器。
几条踩坑提醒
- AK/SK 不要写进 .tf 文件。用环境变量或 provider 的 profile 参数,
.tf文件是要进 Git 的。 terraform.tfstate含敏感信息,不要提交到公开仓库。团队协作时建议用 OBS 做远端 backend。- 改配置后先
plan。不要直接apply,尤其是改了flavor_id、image_id这类可能触发重建的属性。 - 销毁用
terraform destroy,同样会先列清单再确认。测试完环境随手清掉,省钱。
小结
Terraform 不是让你"少点几次鼠标",而是让基础设施变成可版本化、可审查、可复现的工程制品。上面这个例子只有二十几行配置,但它已经具备了:重新创建一个完全相同的环境只需一条命令;任何变更都有 Git 记录;新人读代码就能理解环境结构。
从最小示例开始,跑通一次 init → plan → apply,比读十篇教程都有用。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)