从零开始用 Terraform 管理华为云:一个 VPC + ECS 的最小可运行示例

举报
yd_286050264 发表于 2026/11/15 01:49:32 2026/11/15
【摘要】 本文面向"熟悉云控制台但没用过 IaC"的读者,用二十几行 Terraform 配置在华为云上创建一个 VPC + ECS 的最小可运行示例。先讲清 Resource、Provider、State 三个核心概念,再逐段解释配置代码与华为云资源的对应关系,最后给出 init / plan / apply 的实操流程和四条踩坑提醒。目标:让读者跑通一次完整流程,理解声明式配置相比手动操作的本质优势——

如果你一直在控制台里手动创建资源,大概率遇到过这些场景:

  • 测试环境搭好了,要再搭一个一模一样的,只能逐项点一遍;
  • 某个安全组规则改了,但没人记得改了什么,出了问题排查半天;
  • 同事问你环境怎么搭的,你写了一份 Word 文档,三个月后已经和实际对不上了。

这些问题本质上是同一个:基础设施没有被"代码"描述,只存在于人的记忆和 console 的点击里。 Terraform 要解决的就是这件事——用声明式配置文件描述你想要什么,由工具去创建、更新、销毁,并且把当前状态记录下来。

Terraform 的核心心智模型

不需要一上来就背语法,先理解三个概念:

  1. Resource(资源):你想要的一个云资源,比如一个 VPC、一台 ECS。你在文件里"声明"它的属性,Terraform 负责让它存在。
  2. Provider(提供商):告诉 Terraform 你要操作哪个云。华为云的 provider 是 huaweicloud,它把 Terraform 的通用语法翻译成华为云的 API 调用。
  3. 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)

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

全部回复

上滑加载中

设置昵称

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

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

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