从零开始用 Terraform 管理华为云基础设施
从零开始用 Terraform 管理华为云基础设施
本文面向"懂云、但刚接触 IaC"的开发者。你大概知道 ECS、VPC、子网是什么,但可能没写过
resource块,没跑过terraform plan。没关系,我们从这里开始。
一、为什么用 Terraform 管理华为云
先说一个很多人踩过的坑。
团队里有人通过控制台手动建了一台 ECS,配了安全组、挂了 EIP。过了三个月,这台机器要迁移到另一个可用区。你打开控制台一看——安全组规则散落在五个地方,EIP 的带宽配置没人记得,磁盘扩容过两次但没记录。你花了一整天才搞清楚这台机器到底由什么组成。
这就是 “可变基础设施”(Mutable Infrastructure) 的典型困境:资源是手动创建的,没有版本控制,没有可追溯的配置历史。改一次、漂移一次,最终没人敢动。
Terraform 解决的核心问题就是把这个过程 代码化:
- 声明式:你描述"我要什么",Terraform 负责怎么达到那个状态。
- 可版本控制:基础设施配置和业务代码一样进 Git,每次变更都有 diff、有 review、有回滚。
- 可复用:写一次 VPC 模块,开发环境、测试环境、生产环境各实例化一次,参数不同而已。
- 可销毁:
terraform destroy一条命令清掉整套环境,不用逐个资源去控制台找着删。
华为云是 Terraform 官方支持的 provider(huaweicloud),覆盖了 ECS、VPC、EIP、ELB、RDS、OBS、CCE 等上百种资源,基本上控制台能做的事,Terraform 都能做。
二、环境准备:三步到位
1. 安装 Terraform
# Linux / macOS
curl -fsSL https://releases.hashicorp.com/terraform/1.7.5/terraform_1.7.5_linux_amd64.zip -o terraform.zip
unzip terraform.zip
sudo mv terraform /usr/local/bin/
terraform version # 确认安装成功
如果你在国内,可以用华为云镜像加速下载,地址是 https://mirrors.huaweicloud.cn/hashicorp/terraform/。
2. 获取 AK/SK
登录华为云控制台 → 右上角头像 → “我的凭证” → “访问密钥” → 创建访问密钥。你会得到一个 CSV 文件,里面包含:
- Access Key ID(AK):类似
HPUXXXXXXXXXXXXXXX - Secret Access Key(SK):一长串字符,只显示一次,务必保存好
安全提醒:AK/SK 是你账号的完整凭证,泄露等于账号被接管。不要写进
.tf文件、不要提交到 Git。推荐通过环境变量传入。
3. 配置 Provider 认证
创建一个文件 provider.tf:
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.60.0"
}
}
}
provider "huaweicloud" {
region = "cn-north-4" # 华北-北京四
access_key = var.access_key
secret_key = var.secret_key
}
然后在 variables.tf 中声明变量:
variable "access_key" {
type = string
sensitive = true
}
variable "secret_key" {
type = string
sensitive = true
}
运行时通过环境变量传入,不落盘:
export TF_VAR_access_key="你的AK"
export TF_VAR_secret_key="你的SK"
这样 AK/SK 既不写进代码文件,也不进 Git,只存在于你的终端会话里。
三、第一个实战:用代码建一套网络
光说不练假把式。我们来用 Terraform 创建一个 VPC + 子网 + 安全组,这是所有云上架构的基础骨架。
创建 network.tf:
# VPC
resource "huaweicloud_vpc" "main" {
name = "demo-vpc"
cidr = "192.168.0.0/16"
}
# 子网
resource "huaweicloud_vpc_subnet" "web" {
name = "demo-subnet-web"
vpc_id = huaweicloud_vpc.main.id
cidr = "192.168.1.0/24"
gateway_ip = "192.168.1.1"
}
# 安全组
resource "huaweicloud_networking_secgroup" "web" {
name = "demo-sg-web"
description = "Security group for web servers"
}
# 安全组规则:放行 80 和 443
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
}
resource "huaweicloud_networking_secgroup_rule" "https" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 443
port_range_max = 443
remote_ip_prefix = "0.0.0.0/0"
security_group_id = huaweicloud_networking_secgroup.web.id
}
# 安全组规则:放行 SSH(仅限管理,建议收敛到跳板机 IP)
resource "huaweicloud_networking_secgroup_rule" "ssh" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 22
port_range_max = 22
remote_ip_prefix = "10.0.0.0/8" # 只允许内网段,不要用 0.0.0.0/0
security_group_id = huaweicloud_networking_secgroup.web.id
}
逐段解释:
| 代码块 | 对应华为云资源 | 作用 |
|---|---|---|
huaweicloud_vpc |
VPC | 虚拟私有云,所有资源的网络容器 |
huaweicloud_vpc_subnet |
子网 | VPC 内的 IP 地址段,ECS 需要挂到子网上 |
huaweicloud_networking_secgroup |
安全组 | 相当于云上防火墙,控制进出流量 |
huaweicloud_networking_secgroup_rule |
安全组规则 | 每条规则放行/拒绝一类流量 |
注意 huaweicloud_vpc_subnet.web 里的 vpc_id = huaweicloud_vpc.main.id——这是 Terraform 的 隐式依赖。子网依赖 VPC,Terraform 看到这个引用就知道创建顺序:先 VPC,再子网。你不需要手动指定 depends_on。
还有一个细节:SSH 规则的 remote_ip_prefix 我写的是 10.0.0.0/8 而不是 0.0.0.0/0。把 22 端口开放给全网是云上最常见的安全反模式之一。如果你的跳板机在 10.x.x.x 网段,就只放行这个网段;如果用 VPN 接入,就放行 VPN 的出口 IP。
四、跑起来:plan → apply → destroy
文件准备好了,三步走:
第一步:初始化
terraform init
这一步会下载 huaweicloud provider 插件到本地 .terraform/ 目录。如果在国内网络较慢,可以配置华为云镜像加速。
第二步:预览变更(最重要的一步)
terraform plan
plan 不会真正创建任何东西,它只是告诉你"如果执行 apply,会发生什么"。输出大概长这样:
Terraform will perform the following actions:
# huaweicloud_vpc.main will be created
+ resource "huaweicloud_vpc" "main" {
+ cidr = "192.168.0.0/16"
+ id = (known after apply)
+ name = "demo-vpc"
}
# huaweicloud_vpc_subnet.web will be created
+ resource "huaweicloud_vpc_subnet" "web" {
+ cidr = "192.168.1.0/24"
+ gateway_ip = "192.168.1.1"
+ id = (known after apply)
+ name = "demo-subnet-web"
+ vpc_id = (known after apply)
}
Plan: 5 to add, 0 to change, 0 to destroy.
+ 表示新增,~ 表示修改,- 表示删除。每次 apply 之前都看一遍 plan,这是 IaC 最基本的安全习惯。
第三步:执行
terraform apply
会再次显示 plan 并问你 Do you want to perform these actions?,输入 yes 确认。
创建完成后,Terraform 会在当前目录生成一个 terraform.tfstate 文件——这是 Terraform 的记忆,记录了它创建了哪些资源、每个资源的 ID 是什么。下次 plan 时,Terraform 会拿这个 state 和你的代码做对比,算出差异。
关于 state 文件:
terraform.tfstate里包含资源的真实 ID 和部分属性,建议加入.gitignore,不要提交到 Git。团队协作时推荐用 OBS 作为远程 backend。
清理:一键销毁
terraform destroy
测试完不需要了?一条命令全部删掉,不用去控制台逐个找着删。但注意:destroy 是不可逆的,删了就没了,跑之前看清楚 plan 里标红的 - 条目。
五、进阶:加一台 ECS,把架构串起来
网络有了,我们加一台 ECS,挂到刚才的子网和安全组上。
创建 compute.tf:
# 弹性公网 IP
resource "huaweicloud_vpc_eip" "web" {
publicip {
type = "5_bgp"
}
bandwidth {
name = "demo-bw-web"
size = 5
share_type = "PER"
charge_mode = "traffic"
}
}
# ECS 实例
resource "huaweicloud_compute_instance" "web" {
name = "demo-ecs-web"
image_id = "your-image-id"
flavor_id = "s6.large.2"
availability_zone = "cn-north-4a"
network {
uuid = huaweicloud_vpc_subnet.web.id
}
security_group_ids = [huaweicloud_networking_secgroup.web.id]
eip_id = huaweicloud_vpc_eip.web.id
system_disk_type = "SAS"
system_disk_size = 40
tags = {
Environment = "demo"
Owner = "devops"
CreatedBy = "terraform"
}
}
几个要点:
image_id 怎么拿? 可以用 data source 查询,不用硬编码:
data "huaweicloud_images_image" "ubuntu" {
name = "Ubuntu 22.04 server 64bit"
most_recent = true
}
# 然后在 ECS 里引用:image_id = data.huaweicloud_images_image.ubuntu.id
flavor_id 是什么? 就是实例规格,s6.large.2 表示通用计算型、2 核 4G。可以用 huaweicloud_compute_flavors data source 查可用规格。
tags 很重要。给资源打标签是云上成本治理的基础。后续在账单里按 Environment=prod 筛选,就能看到生产环境花了多少钱。Terraform 让你把标签写在代码里,保证所有资源统一打标,不会遗漏。
六、模块化:别把所有东西堆在一个文件里
当资源变多,把所有 resource 写在一个目录里会变得难以维护。Terraform 的 模块(Module) 就是把一组资源打包成一个可复用的单元。
目录结构建议:
.
├── main.tf # 根模块,调用子模块
├── variables.tf # 根模块变量
├── outputs.tf # 根模块输出
├── modules/
│ ├── network/
│ │ ├── main.tf
│ │ ├── variables.tf
│ │ └── outputs.tf
│ └── web/
│ ├── main.tf
│ ├── variables.tf
│ └── outputs.tf
└── environments/
├── dev/
│ └── terraform.tfvars
└── prod/
└── terraform.tfvars
在根模块 main.tf 中调用:
module "network" {
source = "./modules/network"
vpc_cidr = var.vpc_cidr
env_name = var.env_name
}
module "web" {
source = "./modules/web"
subnet_id = module.network.subnet_id
security_group_id = module.network.sg_web_id
instance_count = var.web_instance_count
env_name = var.env_name
}
不同环境用不同的 terraform.tfvars:
# 开发环境
terraform apply -var-file="environments/dev/terraform.tfvars"
# 生产环境
terraform apply -var-file="environments/prod/terraform.tfvars"
同样的代码,不同的参数,生成不同规模的基础设施。这就是 IaC 复用的威力。
七、State 管理:团队协作的关键
前面说了,terraform.tfstate 是 Terraform 的记忆。本地 state 在个人开发时没问题,但团队协作时会遇到麻烦:
- 两个人同时
apply,state 文件冲突 - state 丢失后,Terraform 不知道云端资源的存在,再
apply会尝试重新创建,导致重复资源
解决方案是用 远程 Backend。华为云 OBS 是一个很好的选择:
terraform {
backend "s3" {
bucket = "your-tfstate-bucket"
key = "demo/terraform.tfstate"
region = "cn-north-4"
endpoint = "https://obs.cn-north-4.myhuaweicloud.com"
}
}
这样 state 存在 OBS 桶里,团队成员共享同一份 state,Terraform 还会自动加锁,防止并发冲突。
八、一些踩坑经验
最后分享几个实战中常见的坑,帮你少走弯路。
1. plan 显示要重建资源,但你只是想改个参数
某些参数变更属于 force-new(强制新建),比如 ECS 的 image_id、flavor_id——改这些参数意味着要销毁旧实例、创建新实例。plan 输出里会标 # (forces replacement),一定要看清楚。
如果只是临时换规格,先在控制台改,再用 terraform import 把新状态同步进来,比让 Terraform 重建更安全。
2. 手动改了云上资源,Terraform 不认了
你在控制台手动给安全组加了一条规则,但 Terraform 代码里没有。下次 plan 会显示要删掉这条规则——因为 Terraform 的逻辑是"让云端状态等于代码描述",多出来的就删。
这叫 配置漂移(Drift)。正确做法是:先 plan 看差异,决定是把这条规则补进代码(保留),还是让它删掉(回滚手动变更)。不要盲目 apply。
3. destroy 删不掉资源
常见原因:资源有依赖关系,比如 ECS 还挂着 EIP,安全组还被引用。Terraform 会按依赖顺序删除,但有时云端状态和 state 不一致会导致卡住。
排查方法:terraform state list 看当前 state 里有哪些资源,terraform state show <资源地址> 看具体属性。必要时用 terraform state rm 把某个资源从 state 里移除(注意:这只移除记录,不删云端资源),然后手动处理。
4. Provider 版本升级后行为变化
huaweicloud provider 在大版本升级时可能有 breaking change。建议在 required_providers 里 锁定版本号(至少锁大版本),升级前先看 CHANGELOG。
九、总结
| 传统方式 | Terraform 方式 |
|---|---|
| 控制台手动点击,不可复现 | 代码描述,可重复执行 |
| 变更无记录,靠人记忆 | 每次变更有 Git diff、可 review |
| 环境差异靠人保证 | 同一份代码,不同参数 |
| 清理环境要逐个删 | destroy 一键搞定 |
| 新人上手靠口口相传 | 读代码就知道架构全貌 |
从手动到 IaC,不是工具的替换,是思维方式的转变:基础设施也是软件。它应该有版本、有测试、有 review、有回滚。
华为云 + Terraform 的组合在国内云环境中是成熟且文档完善的方案。如果你刚开始,建议从一个小的非生产环境练手——建个 VPC、起一台 ECS、跑通 plan → apply → destroy 的完整循环。等流程跑顺了,再逐步把更多资源纳入代码管理。
记住一条原则:如果它不在代码里,它就不应该存在。
本文示例代码已验证可在 Terraform 1.7+ 和 huaweicloud provider 1.60+ 上运行。如有问题欢迎交流。
- 点赞
- 收藏
- 关注作者
评论(0)