Terraform 管理华为云资源实战:从零搭建 VPC+ECS 高可用架构的 5 个避坑指南

举报
yd_263897322 发表于 2026/11/13 00:04:09 2026/11/13
【摘要】 Terraform 管理华为云资源实战:从零搭建 VPC+ECS 高可用架构的 5 个避坑指南 前言在云原生时代,基础设施即代码(IaC)已经不是可选项,而是标配。作为华为云的用户,如果你还在控制台手动点点点创建 VPC、子网、安全组、ECS——每次环境重建都要重复一遍,稍有不慎就漏配一条安全组规则,那你需要认识一下 Terraform。本文不讲理论,只讲实战。我将带大家用 Terrafo...

Terraform 管理华为云资源实战:从零搭建 VPC+ECS 高可用架构的 5 个避坑指南

前言

在云原生时代,基础设施即代码(IaC)已经不是可选项,而是标配。作为华为云的用户,如果你还在控制台手动点点点创建 VPC、子网、安全组、ECS——每次环境重建都要重复一遍,稍有不慎就漏配一条安全组规则,那你需要认识一下 Terraform。

本文不讲理论,只讲实战。我将带大家用 Terraform 在华为云上从零搭建一个「VPC + 子网 + 安全组 + 弹性公网IP + ECS」的基础架构,并分享我在实际项目中踩过的 5 个坑,帮你少走弯路。


一、环境准备

1.1 安装 Terraform

# Linux/Mac
curl -fsSL https://releases.hashicorp.com/terraform/1.6.6/terraform_1.6.6_linux_amd64.zip -o terraform.zip
unzip terraform.zip
sudo mv terraform /usr/local/bin/

# 验证
terraform version

💡 华为云用户也可以使用华为云镜像源加速下载,地址:https://mirrors.huaweicloud.cn/hashicorp/

1.2 安装华为云 Provider

Terraform 通过 Provider 插件与华为云 API 交互。在项目目录下创建 main.tf:

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
}

1.3 认证信息管理

坑 #1:AK/SK 硬编码到 .tf 文件中

新手最容易犯的错误就是把 AK/SK 直接写在 main.tf 里,一旦提交到 Git 仓库,密钥就泄露了。

✅ 正确做法:使用变量文件 + .gitignore

# variables.tf
variable "access_key" {
  type      = string
  sensitive = true
}

variable "secret_key" {
  type      = string
  sensitive = true
}
# terraform.tfvars(加入 .gitignore)
access_key = "你的AK"
secret_key = "你的SK"
# .gitignore
terraform.tfvars
*.tfstate
.terraform/

二、搭建网络基础设施

2.1 创建 VPC 和子网

# network.tf
resource "huaweicloud_vpc" "main" {
  name = "vpc-terraform-demo"
  cidr = "192.168.0.0/16"
}

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

2.2 安全组:最小权限原则

坑 #2:安全组放通 0.0.0.0/0 所有端口

我见过太多项目为了"图省事"直接在安全组里放通所有端口给所有来源,这在生产环境是灾难级的安全隐患。

✅ 正确做法:只开放需要的端口,限制来源 IP

resource "huaweicloud_networking_secgroup" "web" {
  name        = "sg-web"
  description = "Security group for web servers"
}

# 仅放通 22 和 80 端口
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"  # 生产环境建议改为你的跳板机IP
  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
}

三、创建弹性云服务器(ECS)

3.1 弹性公网 IP

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

3.2 ECS 实例

data "huaweicloud_images_image" "ubuntu" {
  name        = "Ubuntu 22.04 server 64bit"
  most_recent = true
}

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

  network {
    uuid = huaweicloud_vpc_subnet.web.id
  }

  security_group_ids = [
    huaweicloud_networking_secgroup.web.id
  ]
}

# 绑定 EIP
resource "huaweicloud_vpc_eip_associate" "web" {
  public_ip   = huaweicloud_vpc_eip.web.address
  network_interface_id = huaweicloud_compute_instance.web.network[0].port_id
}

坑 #3:忘记创建密钥对就直接引用

上面代码引用了 huaweicloud_kps_keypair.demo,但还没定义它。Terraform 不会自动帮你创建,会直接报错。

✅ 补充密钥对资源:

resource "huaweicloud_kps_keypair" "demo" {
  name     = "kp-demo"
  public_key = file("~/.ssh/id_rsa.pub")
}

四、部署与验证

4.1 初始化并执行

# 初始化(下载 Provider 插件)
terraform init

# 查看执行计划(重要!一定要看)
terraform plan

# 应用变更
terraform apply

坑 #4:跳过 plan 直接 apply

terraform plan 是你的安全网。它会告诉你即将创建、修改、销毁哪些资源。跳过这一步直接 apply,就像不看图纸就开工——你不知道会拆掉什么。

✅ 养成习惯:每次 apply 前必看 plan 输出,特别关注 ~(修改)和 -(销毁)操作。

4.2 验证部署

# 查看 ECS 公网 IP
terraform output public_ip

# SSH 连接测试
ssh ubuntu@<public_ip>

五、5 个避坑指南总结

序号 坑 后果 正确做法
1 AK/SK 硬编码 密钥泄露 用 variables + .gitignore
2 安全组全放通 安全漏洞 最小权限原则
3 引用未定义资源 apply 失败 plan 先行,检查依赖
4 跳过 plan 误删资源 每次 apply 前必看 plan
5 state 文件未管理 团队协作冲突 使用远程 backend(OBS)

关于坑 #5:State 文件管理

terraform.tfstate 是 Terraform 的状态文件,记录了所有资源的信息。默认存在本地,团队协作时容易冲突。

✅ 推荐使用华为云 OBS 作为远程 backend:

terraform {
  backend "s3" {
    bucket   = "my-terraform-state"
    key      = "demo/terraform.tfstate"
    region   = "cn-north-4"
    endpoint = "obs.cn-north-4.myhuaweicloud.com"
  }
}

先在 OBS 上创建好桶,再配置 backend。Terraform 会自动将 state 加密存储在 OBS 中,团队成员可以安全共享。


六、清理资源

验证完成后,记得清理资源,避免持续计费:

terraform destroy

⚠️ destroy 会删除所有 Terraform 管理的资源,操作前请确认环境!


总结

Terraform 让华为云资源管理变得可重复、可审计、可版本化。本文从一个最小架构出发,覆盖了 VPC、子网、安全组、EIP、ECS 的完整创建流程,并总结了 5 个实战中最常见的坑。

核心心法只有一句话:先 plan,再 apply,永远不要跳过执行计划。

如果你也在使用华为云,强烈建议把基础设施代码化,一次编写,处处复用。后续我会继续分享 Terraform 管理华为云 RDS、ELB、CCE 等更复杂场景的实战经验,敬请关注。


📌 本文原创发布于华为云开发者社区,转载请注明出处。

如果觉得有帮助,欢迎点赞、收藏、评论交流!

【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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