用 Terraform 在华为云上 5 分钟搭好 VPC + ECS:基础设施即代码入门实战

举报
yd_286050264 发表于 2026/11/09 00:20:19 2026/11/09
【摘要】 本文以一个最小可运行示例,演示如何用 Terraform 在华为云上声明式地创建 VPC、子网、安全组和一台 ECS 弹性云服务器。不讲理论框架,直接上代码和逐段解释,帮助有云基础但刚接触 IaC 的同学快速跑通第一个 Terraform 项目,并理解"声明式"与"状态文件"两个核心概念。

为什么用 Terraform?

如果你习惯在控制台手动点选创建资源,一定遇到过这些场景:环境搭到一半发现少配了个安全组规则,回去补;测试环境用完想删掉,逐个资源点删除,漏了一个还计费;团队里别人问你环境怎么搭的,你只能口头描述,对方搭出来的和你的不一样。

Terraform 解决的就是这个问题——把基础设施写成代码,版本管理、一键创建、一键销毁、团队共享。你描述的是"我想要什么样的基础设施"(声明式),Terraform 负责 figuring out 怎么从当前状态到达目标状态。

准备工作

你需要:

  1. 一个华为云账号,拿到 AK/SK(建议用子账号的最小权限 AK/SK,不要用主账号)。
  2. 安装 Terraform CLI(华为云提供了镜像加速,国内下载很快)。
  3. 安装华为云 Terraform Provider(配置好即可,Terraform 会自动拉取)。

最小示例:一个 VPC + 一台 ECS

# provider.tf — 告诉 Terraform 我们要用华为云
terraform {
  required_providers {
    huaweicloud = {
      source  = "huaweicloud/huaweicloud"
      version = ">= 1.50.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
}
# main.tf — 核心资源定义
# 创建 VPC
resource "huaweicloud_vpc_v1" "my_vpc" {
  name = "tf-demo-vpc"
  cidr = "192.168.0.0/16"
}

# 在 VPC 下创建子网
resource "huaweicloud_vpc_subnet_v1" "my_subnet" {
  name       = "tf-demo-subnet"
  cidr       = "192.168.0.0/24"
  gateway_ip = "192.168.0.1"
  vpc_id     = huaweicloud_vpc_v1.my_vpc.id
}

# 安全组:只放行 SSH(22 端口)
resource "huaweicloud_networking_secgroup_v2" "my_sg" {
  name        = "tf-demo-sg"
  description = "Allow SSH only"
}

resource "huaweicloud_networking_secgroup_rule_v2" "ssh_rule" {
  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_v2.my_sg.id
}

# 创建一台 ECS
resource "huaweicloud_compute_instance_v2" "my_ecs" {
  name              = "tf-demo-ecs"
  image_id          = "your-image-id"   # 替换为你的镜像 ID
  flavor_id         = "s6.large.2"
  availability_zone = "cn-north-4a"

  network {
    uuid = huaweicloud_vpc_subnet_v1.my_subnet.id
  }

  security_group_ids = [
    huaweicloud_networking_secgroup_v2.my_sg.id
  ]
}

逐段解释

provider.tf:声明我们使用华为云 Provider,指定区域(这里是北京四 cn-north-4),AK/SK 通过变量传入——不硬编码在代码里,避免泄露到 Git。

variables.tf:把 AK/SK 定义为 sensitive 变量,实际运行时通过环境变量或命令行传入,代码仓库里看不到密钥。

main.tf 是核心,四个资源依次有依赖关系:

资源 作用 依赖
huaweicloud_vpc_v1 创建 VPC 虚拟私有云 无
huaweicloud_vpc_subnet_v1 在 VPC 下创建子网 依赖 VPC 的 ID
huaweicloud_networking_secgroup_v2 创建安全组 无
huaweicloud_compute_instance_v2 创建 ECS 云服务器 依赖子网 ID + 安全组 ID

注意 huaweicloud_vpc_v1.my_vpc.id 这种写法——这是 Terraform 的引用语法,表示"取 my_vpc 这个资源的 id 属性"。Terraform 会自动分析这些引用关系,算出正确的创建顺序,你不需要手动排序。

跑起来

# 1. 初始化(拉取 Provider 插件)
export HW_ACCESS_KEY="你的AK"
export HW_SECRET_KEY="你的SK"
terraform init

# 2. 看看将要创建什么(不会真的创建)
terraform plan

# 3. 确认无误后,真正创建
terraform apply

terraform plan 是最重要的一步——它会告诉你"将要创建 4 个资源",你确认没问题再 apply。养成先 plan 再 apply 的习惯,能避免很多意外。

用完了一键销毁

terraform destroy

一条命令,所有资源干净删除,不留计费残留。这在搭建临时测试环境时特别有用。

两个核心概念

声明式:你写的是"我要什么",不是"怎么创建"。如果后来你把 flavor_id 从 s6.large.2 改成 s6.xlarge.2,再跑 terraform apply,Terraform 会自动算出"需要变更 ECS 规格"并执行,你不需要写"先停机再改规格再开机"的步骤。

状态文件(terraform.tfstate):Terraform 用一个 JSON 文件记录"当前基础设施的实际状态"。每次 plan 时,Terraform 对比"代码里声明的目标"和"状态文件里的现状",算出差异。这个文件很重要——丢了就意味着 Terraform 不知道云端实际有什么,管理就断了。团队协作时建议放到 OBS 桶做远程 backend,不要提交到 Git(里面有敏感信息)。

小结

传统方式 Terraform 方式
控制台手动点选 代码声明,一键创建
口口相传环境配置 代码即文档,版本管理
手动逐个删除 terraform destroy 一键销毁
环境不一致 同一份代码,可复现多套环境

本文示例只有 4 个资源,但 Terraform 的能力远不止于此——ELB 负载均衡、RDS 数据库、CCE 容器集群都可以用同样的方式管理。从小处开始,逐步把现有基础设施纳入 Terraform 管理,是更稳妥的落地路径。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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