第一次用 Terraform 在华为云上建 ECS,我踩了这 5 个坑
说实话,在这之前我一直是华为云控制台的"鼠标流"——建 VPC、开子网、配安全组、创 ECS,全靠点点点。一台两台还行,上个月项目要搭一套测试环境,三个 VPC、十二台 ECS、一堆安全组规则,我在控制台前坐了一下午,点到最后自己都记不清哪台机器开了哪个端口。
更崩溃的是,第二天同事说"安全组规则要加一条",我又进去翻半天——那么多安全组,到底改哪个?
那天晚上我就决定了:得学 Terraform。
这篇文章记录的是我第一次用 Terraform 在华为云上从零建一台 ECS 的全过程,包括我踩的 5 个坑。如果你也是刚起步,希望能帮你少走点弯路。
---
## 一、环境准备
### 1. 装 Terraform
我是 Mac,直接 brew:
```bash
brew install terraform
```
Linux 的话去 HashiCorp 官网下二进制,或者用华为云的镜像源(国内更快):
```bash
# 配置华为云镜像,init 的时候秒下
cat <<EOF > ~/.terraformrc
provider_installation {
registry_mirror "https://mirrors.huaweicloud.cn/repository/hashicorp/"
}
EOF
```
装完验证一下:
```bash
terraform version
# Terraform v1.8.5
```
### 2. 拿 AK/SK
Terraform 要通过 API 操作云资源,需要 AK(Access Key)和 SK(Secret Key)。
在控制台 → "我的凭证" → "访问密钥" 里创建。**注意:SK 只在创建时显示一次,一定要保存好。**
我第一次就犯了蠢——创建完没存,关了页面,只能删掉重建。
---
## 二、第一个坑:Provider 配置
新建一个目录,写第一个文件 `main.tf`:
```hcl
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = "cn-north-4"
access_key = "我的AK"
secret_key = "我的SK"
}
```
然后 `terraform init`,报错了:
```
Error: Failed to query available provider packages
```
**坑 1:网络问题。** 国内直连 registry.terraform.io 不稳定,`terraform init` 经常超时。
解决办法就是我上面写的那个 `~/.terraformrc` 镜像配置。配上华为云镜像之后,秒下。
另一个做法是把 AK/SK 放环境变量里,不写在文件里(万一不小心 git push 了就社死了):
```bash
export HW_ACCESS_KEY="我的AK"
export HW_SECRET_KEY="我的SK"
export HW_REGION_NAME="cn-north-4"
```
provider 块就可以简化:
```hcl
provider "huaweicloud" {
# 从环境变量读取,不用写明文
}
```
**教训:AK/SK 不要写进 .tf 文件,用环境变量传。**
---
## 三、建 VPC:第一个资源
先从最简单的开始,建一个 VPC:
```hcl
resource "huaweicloud_vpc_vpc" "test_vpc" {
name = "tf-test-vpc"
cidr = "192.168.0.0/16"
}
```
`terraform plan` 看看会发生什么:
```
Terraform will perform the following actions:
# huaweicloud_vpc_vpc.test_vpc will be created
+ resource "huaweicloud_vpc_vpc" "test_vpc" {
+ cidr = "192.168.0.0/16"
+ id = (known after apply)
+ name = "tf-test-vpc"
}
Plan: 1 to add, 0 to change, 0 to destroy.
```
这个 `plan` 的输出是我觉得 Terraform 最爽的地方——**执行之前先告诉你它会干什么**。不像在控制台,点了"确定"才知道结果,有时候点了"确定"才发现选错了。
`terraform apply`,输入 `yes`,几秒钟后 VPC 就建好了。
去控制台一看,真有一个叫 `tf-test-vpc` 的 VPC。有点神奇。
---
## 四、第二个坑:可用区(AZ)
接下来加子网。子网需要指定可用区,我就随手写了一个:
```hcl
resource "huaweicloud_vpc_subnet" "test_subnet" {
name = "tf-test-subnet"
cidr = "192.168.0.0/24"
gateway_ip = "192.168.0.1"
vpc_id = huaweicloud_vpc_vpc.test_vpc.id
}
```
等等,ECS 创建的时候要指定可用区,我随手填了 `cn-north-4a`,apply 报错:
```
Error: availability_zone is invalid
```
**坑 2:可用区的命名规则搞不清,而且不是每个 AZ 都有资源配额。**
正确做法是用 data source 查:
```hcl
data "huaweicloud_availability_zones" "my_azs" {}
# 然后在输出里看有哪些 AZ
output "azs" {
value = data.huaweicloud_availability_zones.my_azs.names
}
```
`terraform apply` 一跑,输出告诉我:
```json
azs = [
"cn-north-4a",
"cn-north-4b",
"cn-north-4c",
]
```
好嘛,我猜的其实是对的,但之前报错是因为那个 AZ 在我的账号下没有资源配额。**所以不是名字写错,是那个 AZ 不可用。**
**教训:不确定的东西先用 data source 查,别猜。**
---
## 五、第三个坑:安全组规则方向搞反
建 ECS 需要安全组,先建一个:
```hcl
resource "huaweicloud_networking_secgroup" "test_sg" {
name = "tf-test-sg"
description = "Security group for test ECS"
}
```
然后加规则,开放 22 端口(SSH):
```hcl
resource "huaweicloud_networking_secgroup_rule" "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.test_sg.id
}
```
看起来没问题对吧?我一开始也是这么想的。但是 `direction` 这个字段,我第一次写成了 `inbound`,报错了。
**坑 3:direction 的取值是 `ingress`/`egress`,不是 `inbound`/`outbound`。**
这个其实看文档就知道,但我当时凭直觉写的 `inbound`,因为很多防火墙都是这么叫的。华为云的 API 用的是 Neutron 的规范,`ingress` 和 `egress`。
另外说一句安全上的事——`remote_ip_prefix = "0.0.0.0/0"` 意味着全网都能访问你的 22 端口。测试环境无所谓,但生产环境千万别这么干,限制成你的办公网出口 IP。我这里只是测试,就不纠结了。
**教训:字段取值别凭感觉,查 provider 文档。**
---
## 六、第四个坑:镜像 ID 怎么找
建 ECS 需要指定镜像(image_id),我一开始去控制台翻,找到了一个 ID,贴进来。能用,但总觉得不对劲——这个 ID 是硬编码的,换了个 region 就不对了。
**坑 4:硬编码 image_id 不可移植。**
正确做法还是用 data source:
```hcl
data "huaweicloud_images_image" "centos" {
name = "CentOS 7.9 64bit"
most_recent = true
}
```
这样 Terraform 会自动找到最新的 CentOS 7.9 镜像,不用管 ID 是什么。换 region 也能自动适配。
---
## 七、第五个坑:flavor 名称
ECS 的规格(flavor)我一开始写 `s6.large.2`,报错说找不到。查了一下才发现,不同 region 支持的 flavor 不一样,而且有的 region 是 `s6` 系列,有的是 `kc1` 系列(鲲鹏)。
**坑 5:flavor 不是哪都有,不同 region 支持的规格不同。**
这个也可以用 data source 查,但更简单的办法是去控制台 → ECS → 创建实例的页面,看"规格"那一栏有哪些可选。或者用 data source:
```hcl
data "huaweicloud_compute_flavors" "flavors" {
availability_zone = "cn-north-4a"
}
```
我最终选了 `s6.large.2`(2 核 2G),测试够用了。
---
## 八、完整的 ECS 创建
把所有东西拼起来,完整的 `main.tf`:
```hcl
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = "cn-north-4"
}
# 查可用区
data "huaweicloud_availability_zones" "my_azs" {}
# 查镜像
data "huaweicloud_images_image" "centos" {
name = "CentOS 7.9 64bit"
most_recent = true
}
# VPC
resource "huaweicloud_vpc_vpc" "test_vpc" {
name = "tf-test-vpc"
cidr = "192.168.0.0/16"
}
# 子网
resource "huaweicloud_vpc_subnet" "test_subnet" {
name = "tf-test-subnet"
cidr = "192.168.0.0/24"
gateway_ip = "192.168.0.1"
vpc_id = huaweicloud_vpc_vpc.test_vpc.id
}
# 安全组
resource "huaweicloud_networking_secgroup" "test_sg" {
name = "tf-test-sg"
description = "SG for test ECS"
}
# 开放 SSH
resource "huaweicloud_networking_secgroup_rule" "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.test_sg.id
}
# ECS 实例
resource "huaweicloud_ecs_instance" "test_ecs" {
name = "tf-test-ecs"
image_id = data.huaweicloud_images_image.centos.id
flavor_id = "s6.large.2"
availability_zone = data.huaweicloud_availability_zones.my_azs.names[0]
security_group_ids = [huaweicloud_networking_secgroup.test_sg.id]
network {
uuid = huaweicloud_vpc_subnet.test_subnet.id
}
root_volume {
size = 40
volume_type = "SAS"
}
tags = {
env = "test"
team = "devops"
}
}
output "ecs_public_ip" {
value = huaweicloud_ecs_instance.test_ecs.access_ip_v4
}
```
`terraform plan`:
```
Plan: 5 to add, 0 to change, 0 to destroy.
```
5 个资源:VPC、子网、安全组、安全组规则、ECS。一目了然。
`terraform apply`,输入 `yes`,等了大概两分钟,ECS 创建完成,输出了公网 IP。
去控制台一看,VPC、子网、安全组、ECS 全都在,名字、标签都对。**一次 apply,全套环境拉起来。**
这个感觉和手动在控制台点半天完全不一样。
---
## 九、最爽的其实是改和删
建完之后,我想给 ECS 加个 80 端口的规则。以前在控制台:找到安全组 → 添加规则 → 填参数 → 确定。现在:
在 `main.tf` 里加一段:
```hcl
resource "huaweicloud_networking_secgroup_rule" "http_rule" {
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.test_sg.id
}
```
`terraform apply`,只多了一个资源:
```
Plan: 1 to add, 0 to change, 0 to destroy.
```
一秒搞定。
最爽的是删环境。测试完了,`terraform destroy`:
```
Plan: 0 to add, 0 to change, 5 to destroy.
```
一条命令,5 个资源全删干净,不用去控制台一个一个找着删,也不用担心漏了哪个安全组规则残留。
---
## 十、关于 state 文件
有个东西新手容易忽略:`terraform.tfstate`。
这个文件记录了 Terraform 管理的所有资源的真实状态。**它就是 Terraform 的记忆**——下次 `plan` 的时候,Terraform 就是拿它和你的 .tf 文件对比,算出差异。
几个注意点:
- **不要手动改它**,用 Terraform 命令操作
- **不要提交到 git**(里面有敏感信息)
- 团队协作的话,用远程 backend(比如 OBS)存 state,别各自本地一份
我目前一个人用,本地存就行,等团队用了再上 OBS backend。
---
## 写在最后
从决定学到第一次成功跑通,大概花了一个晚上。5 个坑听着多,其实都是看文档能避免的小问题,但新手就是会踩——因为你不知道"该查"的地方你会去猜。
总结一下我的 5 个坑:
| 坑 | 原因 | 解法 |
|----|------|------|
| init 超时 | 国内网络 | 配华为云镜像 |
| AK/SK 写文件里 | 偷懒 | 用环境变量 |
| 可用区报错 | 瞎猜 AZ 名 | data source 查 |
| direction 写错 | 凭直觉 | 查文档,ingress/egress |
| image_id 硬编码 | 去控制台抄 ID | data source 查 |
核心教训就一句话:**不确定的东西先用 data source 查,别猜。**
Terraform 给我最大的改变不是"写代码建资源",而是**基础设施变成了可版本化、可复用、可审查的东西**。以前环境配置全在某个人的脑子里,现在全在 git 里。谁改了什么,什么时候改的,为什么改,一清二楚。
如果你也在华为云上手动点点点,真的建议试试 Terraform。入门没有想象中难,而且一旦用上就回不去了。
---
以上就是我想分享的内容。如果有写错的地方,欢迎评论区指正,我也还在学习中 🙏
- 点赞
- 收藏
- 关注作者
评论(0)