从零开始用 Terraform 管理华为云基础设施

举报
yd_284542308 发表于 2026/11/09 08:29:58 2026/11/09
【摘要】 从零开始用 Terraform 管理华为云基础设施本文面向"懂云、但刚接触 IaC"的开发者。你大概知道 ECS、VPC、子网是什么,但可能没写过 resource 块,没跑过 terraform plan。没关系,我们从这里开始。 一、为什么用 Terraform 管理华为云先说一个很多人踩过的坑。团队里有人通过控制台手动建了一台 ECS,配了安全组、挂了 EIP。过了三个月,这台机器要...

从零开始用 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+ 上运行。如有问题欢迎交流。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。