从手动到自动化:用 Terraform 在华为云上部署你的第一个 VPC + ECS

举报
yd_286050264 发表于 2026/11/16 08:34:40 2026/11/16
【摘要】 还在控制台点点点?每次建环境都要重复一遍选 VPC、配子网、开安全组、创 ECS 的流程?本文用一个最小可运行的 Terraform 示例,带你把华为云上的 VPC、子网、安全组和一台 ECS 一次性"声明"出来,并讲清楚每段代码对应的云上资源是什么、为什么这么写。读完你不仅能跑通这个例子,还能理解 IaC(Infrastructure as Code)的核心思路——基础设施不再是"操作出来的",

一、为什么是 Terraform?

如果你在华为云控制台上手动创建过一台 ECS,你一定经历过这个流程:选区域 → 选可用区 → 选镜像 → 选规格 → 选 VPC → 选子网 → 选安全组 → 配密码 → 点创建。一次还好,十次就疯了。更头疼的是:半年后你想在另一个区域复制一套一样的环境,你早已忘了当初的安全组规则到底开了哪些端口。

Terraform 解决的就是这个问题。你用一种声明式的语言(HCL)把你要的云资源描述出来,Terraform 负责调 API 把它们创建出来。这份描述文件就是你的基础设施"图纸"——可读、可版本管理、可复用、可审计。

华为云官方维护了 Terraform Provider(huaweicloud),覆盖了 VPC、ECS、EVS、ELB、RDS、OBS 等核心产品,完全不用担心兼容性问题。

二、最小例子:一个 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 — 网络底座
resource "huaweicloud_vpc" "main" {
  name = "tf-demo-vpc"
  cidr = "192.168.0.0/16"
}

resource "huaweicloud_vpc_subnet" "web" {
  vpc_id     = huaweicloud_vpc.main.id
  name       = "tf-demo-subnet"
  cidr       = "192.168.1.0/24"
  gateway_ip = "192.168.1.1"
}

resource "huaweicloud_networking_secgroup" "web" {
  name        = "tf-demo-sg"
  description = "Allow SSH and HTTP"
}

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
}

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
}
# compute.tf — 一台 ECS
resource "huaweicloud_compute_instance" "web" {
  name              = "tf-demo-ecs"
  image_id          = "你的镜像ID"  # 可通过 data 源查询
  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]

  tags = {
    Environment = "demo"
    ManagedBy   = "terraform"
  }
}

三、每段代码对应云上什么资源?


Terraform 资源 华为云产品 对应控制台操作
huaweicloud_vpc VPC 虚拟私有云 → 创建 VPC
huaweicloud_vpc_subnet VPC 子网 在 VPC 下创建子网
huaweicloud_networking_secgroup 安全组 访问控制 → 创建安全组
huaweicloud_networking_secgroup_rule 安全组规则 在安全组中添加入站规则
huaweicloud_compute_instance ECS 弹性云服务器 → 创建服务器

注意一个关键细节:子网引用了 VPC 的 ID(vpc_id = huaweicloud_vpc.main.id),ECS 引用了子网和安全组的 ID。这就是 Terraform 的依赖管理——你不需要手动先建 VPC 再记下 ID 填给子网,Terraform 自动分析引用关系,按正确顺序创建。

四、三步跑起来

# 1. 初始化:下载华为云 Provider 插件
terraform init

# 2. 看看要干什么(不会真正创建,只给你看计划)
terraform plan

# 3. 确认无误后执行
terraform apply

terraform plan 是 Terraform 最有价值的能力之一。在真正动你的云资源之前,它会告诉你:"我要新建 1 个 VPC、1 个子网、1 个安全组、2 条安全组规则、1 台 ECS。" 你看完觉得没问题,输入 yes 才会真正执行。这比在控制台上盲点"确定"安全得多。

五、改了怎么办?

这是 Terraform 和"写脚本调 API"最大的区别。假设你想给 ECS 加一个标签,或者把规格从 s6.large.2 换成 s6.xlarge.2:

  1. 改 .tf 文件里对应的那一行。
  2. terraform plan — 它会告诉你:"ECS 的 flavor 要从 A 改成 B。"
  3. terraform apply — 执行变更。

你永远只需要改"描述",Terraform 自己算出"怎么从当前状态变到目标状态"。这就是声明式的力量——你说"我要什么样",不说"怎么做到"。

六、几个新手容易踩的坑

  1. AK/SK 不要写进 .tf 文件。 用环境变量 HW_ACCESS_KEY / HW_SECRET_KEY 传入,或者用 provider 的 profile 参数引用凭证文件。一旦 AK/SK 提交到 Git 仓库,即使后面删掉,Git 历史里也还在。

  2. state 文件要保护好。 Terraform 用一个 terraform.tfstate 文件记录它创建了什么。这个文件丢了,Terraform 就不知道云上哪些资源是它管的。个人练习放本地没问题,团队协作建议放到 OBS 远程后端。

  3. terraform destroy 会真的删除资源。 练习完了一定要记得清理,否则 ECS 按小时计费,一个月后账单会给你一个"惊喜"。destroy 之前先 plan -destroy 看一眼要删什么,确认没有误删生产资源。

七、小结

从控制台手动操作到 Terraform 声明式管理,转变的不是工具,而是思维方式:

  • 基础设施是代码 — 可以 code review,可以 diff,可以回滚。
  • 环境可复现 — 同一份 .tf 文件换个 region 就能再起一套一样的。
  • 变更可追踪 — Git 提交记录就是基础设施的变更日志。

本文的例子只有 5 个资源,但思路是一样的——不管你要管 5 个还是 500 个资源,都是"描述目标 → plan 确认 → apply 执行"。从小例子开始,逐步把你的生产环境也纳入 Terraform 管理,你会发现运维这件事变得不一样了。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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