第一次用 Terraform 在华为云上建 ECS,我踩了这 5 个坑

举报
yd_289144252 发表于 2026/11/07 11:33:48 2026/11/07
【摘要】 说实话,在这之前我一直是华为云控制台的"鼠标流"——建 VPC、开子网、配安全组、创 ECS,全靠点点点。一台两台还行,上个月项目要搭一套测试环境,三个 VPC、十二台 ECS、一堆安全组规则,我在控制台前坐了一下午,点到最后自己都记不清哪台机器开了哪个端口。更崩溃的是,第二天同事说"安全组规则要加一条",我又进去翻半天——那么多安全组,到底改哪个?那天晚上我就决定了:得学 Terrafor...

说实话,在这之前我一直是华为云控制台的"鼠标流"——建 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。入门没有想象中难,而且一旦用上就回不去了。

---

以上就是我想分享的内容。如果有写错的地方,欢迎评论区指正,我也还在学习中 🙏

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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