Terraform 管理华为云资源实战:从零搭建 VPC+ECS 高可用架构的 5 个避坑指南
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 等更复杂场景的实战经验,敬请关注。
📌 本文原创发布于华为云开发者社区,转载请注明出处。
如果觉得有帮助,欢迎点赞、收藏、评论交流!
- 点赞
- 收藏
- 关注作者
评论(0)