用 Terraform 在华为云上搭建基础设施:从 VPC 到 ECS 的完整实战

举报
yd_243668775 发表于 2026/11/11 08:15:04 2026/11/11
【摘要】 为什么用 Terraform?如果你在控制台手动建过云资源,一定经历过这种痛苦:建了一堆 VPC、子网、安全组、ECS,过了一个月回来,完全记不清当时怎么配的。更糟的是,换个人来维护,面对一堆"不知道谁建的、不知道为什么建"的资源,根本不敢动。Terraform 解决的就是这个问题——用代码描述基础设施。你的 VPC 用什么网段、安全组开了哪些端口、ECS 用什么规格,全部写在一个 .tf ...

为什么用 Terraform?

如果你在控制台手动建过云资源,一定经历过这种痛苦:建了一堆 VPC、子网、安全组、ECS,过了一个月回来,完全记不清当时怎么配的。更糟的是,换个人来维护,面对一堆"不知道谁建的、不知道为什么建"的资源,根本不敢动。

Terraform 解决的就是这个问题——用代码描述基础设施。你的 VPC 用什么网段、安全组开了哪些端口、ECS 用什么规格,全部写在一个 .tf 文件里。代码就是文档,代码就是真相。

这篇文章带你从零开始,用 Terraform 在华为云上搭建一套完整的网络 + 计算基础设施。

一、环境准备

首先安装 Terraform CLI。华为云提供了国内镜像源,下载速度有保障,不用翻墙。

安装完成后,在终端验证:

terraform version

看到版本号输出就说明安装成功。

接下来准备华为云的认证信息,需要三样东西:

  • AK / SK:在华为云控制台「我的凭证」页面创建访问密钥
  • Region:比如 cn-north-4(华北-北京四)
  • Project ID:同样在「我的凭证」页面可以查到

建议通过环境变量传入,不要硬编码到代码里:

export HW_ACCESS_KEY="你的AK"
export HW_SECRET_KEY="你的SK"
export HW_REGION_NAME="cn-north-4"
export HW_PROJECT_ID="你的项目ID"

二、初始化项目

新建一个目录,创建 main.tf 文件,先写 provider 配置:

terraform {
  required_providers {
    huaweicloud = {
      source  = "huaweicloud/huaweicloud"
      version = ">= 1.50.0"
    }
  }
}

provider "huaweicloud" {
  region = var.region
}

再创建 variables.tf,把可变参数抽出来:

variable "region" {
  description = "华为云区域"
  default     = "cn-north-4"
}

variable "vpc_cidr" {
  description = "VPC 网段"
  default     = "192.168.0.0/16"
}

variable "subnet_cidr" {
  description = "子网网段"
  default     = "192.168.1.0/24"
}

variable "ecs_password" {
  description = "ECS 初始密码"
  type        = string
  sensitive   = true
}

把密码标记为 sensitive,这样 Terraform 在执行计划输出时不会明文显示。

三、创建网络:VPC + 子网 + 安全组

网络是基础设施的骨架。我们先建一个 VPC、一个子网、一个安全组:

# VPC
resource "huaweicloud_vpc" "main" {
  name = "tf-demo-vpc"
  cidr = var.vpc_cidr
}

# 子网
resource "huaweicloud_vpc_subnet" "main" {
  name       = "tf-demo-subnet"
  cidr       = var.subnet_cidr
  gateway_ip = "192.168.1.1"
  vpc_id     = huaweicloud_vpc.main.id
}

# 安全组
resource "huaweicloud_networking_secgroup" "web" {
  name        = "tf-demo-secgroup"
  description = "Web 服务器安全组"
}

# 安全组规则:放行 SSH
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
}

# 安全组规则:放行 HTTP
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
}

这里有个重要提醒:上面安全组规则把 SSH(22 端口)对 0.0.0.0/0 开放,这在演示环境里可以,但在生产环境里是高风险操作。生产环境建议把 remote_ip_prefix 改成你自己的运维网段或堡垒机 IP,不要对全网开放 SSH。

四、创建 ECS 实例

网络就绪后,创建一台 ECS:

# 查询可用镜像
data "huaweicloud_images_image" "ubuntu" {
  name        = "Ubuntu 22.04 server 64bit"
  most_recent = true
}

# ECS
resource "huaweicloud_compute_instance" "web" {
  name              = "tf-demo-ecs"
  image_id          = data.huaweicloud_images_image.ubuntu.id
  flavor_id         = "s6.large.2"
  availability_zone = "cn-north-4a"

  system_disk_type = "SAS"
  system_disk_size = 40

  network {
    uuid = huaweicloud_vpc_subnet.main.id
  }

  security_group_ids = [
    huaweicloud_networking_secgroup.web.id
  ]

  admin_pass = var.ecs_password
}

几个关键点解释一下:

  • flavor_id:s6.large.2 表示通用计算型 s6 系列,2 核 4G。规格选择取决于你的负载类型,计算密集型选 c 系列,内存密集型选 m 系列
  • availability_zone:这里只选了一个 AZ(cn-north-4a)。如果是高可用场景,至少要跨两个 AZ 部署多台 ECS,单 AZ 不具备容灾能力
  • system_disk_type:SAS 是高 IO 类型,适合大多数场景。如果预算紧张可以用 SATA,数据库场景建议用 SSD

五、分配弹性公网 IP

如果这台 ECS 需要被外网访问,给它挂一个 EIP:

resource "huaweicloud_vpc_eip" "web" {
  publicip {
    type = "5_bgp"
  }
  bandwidth {
    name        = "tf-demo-bandwidth"
    size        = 5
    share_type  = "PER"
    charge_mode = "traffic"
  }
}

resource "huaweicloud_compute_eip_associate" "web" {
  public_ip   = huaweicloud_vpc_eip.web.address
  instance_id = huaweicloud_compute_instance.web.id
}
  • 5_bgp:表示 5 线 BGP,国内访问质量最好
  • share_type = PER:独享带宽。如果有多台 ECS 共享出口带宽,可以改成 WHOLE(共享带宽)
  • charge_mode = traffic:按流量计费。如果是常驻高带宽场景,按带宽计费更划算

六、执行部署

所有代码写好后,三步走:

# 1. 初始化,下载 provider 插件
terraform init

# 2. 查看执行计划,确认要创建哪些资源
terraform plan

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

terraform plan 这一步非常重要——它会告诉你即将创建、修改、删除哪些资源,在 apply 之前一定要看清楚。尤其是后续迭代修改代码时,plan 能帮你发现"本来只想改个安全组规则,结果触发了 ECS 重建"这种意外情况。

七、一些实战心得

1. 状态文件要妥善管理

Terraform 用一个 terraform.tfstate 文件记录当前基础设施的实际状态。这个文件非常重要——丢了就意味着 Terraform 不知道云端到底有什么资源,管理就失控了。团队协作时建议把 state 文件放到 OBS 桶里远程管理,不要提交到 Git 仓库(里面可能含敏感信息)。

2. 销毁资源别忘了

用 Terraform 创建的资源,用完可以一键销毁:

terraform destroy

这会按依赖顺序依次删除所有资源。测试环境用完随手清理,避免忘记导致持续计费。

3. 改代码时注意 force-new

有些属性修改会触发资源重建(比如 ECS 换镜像、换 AZ)。Terraform plan 的输出里会标注 forces replacement,看到这个要格外留意——重建意味着旧实例删除、新实例创建,上面的数据会丢失。

4. 不要手动改 Terraform 管理的资源

如果某个资源是 Terraform 创建的,后续要修改就改 Terraform 代码再 apply。如果去控制台手动改了,Terraform 的 state 和实际就不一致了(这叫 drift),再 apply 时可能产生意外行为。

写在最后

Terraform 的核心思想很简单:基础设施即代码。但真正用好它,需要对云上资源的属性和依赖关系有清晰的理解。这篇实战只是入门,覆盖了最常用的 VPC + 子网 + 安全组 + ECS + EIP 这条链路。实际项目中还会涉及 RDS、ELB、NAT 网关、CCE 等,但方法论是一样的——用代码描述,用 plan 审查,用 apply 落地。

把你的基础设施交给代码管理,一次编写,反复复用,团队共享。这比在控制台上点来点去,要可靠得多。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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