从控制台点出来到代码写出来:第一次用 Terraform 管理华为云 ECS 的完整心路
从控制台点出来到代码写出来:第一次用 Terraform 管理华为云 ECS 的完整心路
你是不是也这样上云的
打开华为云控制台,左侧菜单找到"弹性云服务器 ECS",点"购买弹性云服务器",选区域、选规格、选镜像、选 VPC、选安全组、设密码、点"立即购买"……一台 ECS 就有了。
第二次要一台一样的?再点一遍。要十台?点十遍,或者用"批量购买"勾个数。哪天有人问你"这台机器当时到底配了什么",你打开控制台翻半天,还得靠记忆补全"当时好像选了 s6.large.2"。
这没毛病,能跑就行。但你大概率已经感觉到几个不舒服的地方:
- 重复。同样的配置点好几遍,少勾一个选项就不一样了。
- 没法回顾。这台 ECS 当初为什么这么配的,没有记录。
- 不敢改。改了规格、换了安全组,怕弄坏,又不知道怎么回退。
- 没法交接。你休假了,同事想照着搭一台,只能口头描述。
这些问题,其实都指向同一件事:你的基础设施没有"源代码"。
Terraform 到底解决什么
一句话:Terraform 让你用文本文件描述你要哪些云资源,然后由它去帮你创建、修改、销毁,并且记住当前的真实状态。
你写的那个文件(后缀 .tf)就是基础设施的"源代码"。一行 resource "huaweicloud_compute_instance" "web" { ... } 就对应一台 ECS。要十台?改个数字。要换规格?改一行。要回顾?看文件。要交接?把文件发给同事。
这和你在控制台点鼠标的本质区别是:配置变成了可读、可版本管理、可复制的文本,而不是一次性的点击动作。
第一次写:从最小例子开始
不要一上来就搞一整套 VPC + 子网 + 路由 + EIP + ECS,会晕。我们先写一个"能跑起来、而且公网能 SSH 上去"的最小集:一个 VPC、一个子网、一个安全组、一个 EIP、一台 ECS。五样东西,刚好够一台机器能起来且从外面连得上。
新建一个目录,里面放两个文件。先看 variables.tf,把容易变的参数抽出来:
variable "region" {
default = "cn-north-4"
}
variable "availability_zone" {
default = "cn-north-4a"
}
variable "flavor_id" {
default = "s6.large.2"
}
variable "ecs_password" {
description = "ECS 登录密码,建议用环境变量 TF_VAR_ecs_password 传入,别写死"
sensitive = true
}
为什么要把参数抽出来?因为区域、规格、可用区这些是最常换的。抽到 variables 里,以后换区域只改这一处,不用在资源定义里到处找。密码标了 sensitive = true,这样 plan 输出里不会明文打印出来。
再看 main.tf:
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = var.region
# AK/SK 不要写在这里,用环境变量 HW_ACCESS_KEY / HW_SECRET_KEY 传入
}
# 按名字查公共镜像,不用手动复制那一长串 UUID
data "huaweicloud_images_image" "os_image" {
name = "Ubuntu 22.04 server 64bit"
most_recent = true
}
# 一个 VPC
resource "huaweicloud_vpc" "my_vpc" {
name = "my-first-vpc"
cidr = "192.168.0.0/16"
}
# VPC 里一个子网
resource "huaweicloud_vpc_subnet" "my_subnet" {
name = "my-first-subnet"
cidr = "192.168.0.0/24"
gateway_ip = "192.168.0.1"
vpc_id = huaweicloud_vpc.my_vpc.id
}
# 一个安全组,放通 22 端口方便 SSH
resource "huaweicloud_networking_secgroup" "my_sg" {
name = "my-first-sg"
description = "allow ssh"
}
resource "huaweicloud_networking_secgroup_rule" "ssh" {
security_group_id = huaweicloud_networking_secgroup.my_sg.id
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 22
port_range_max = 22
remote_ip_prefix = "0.0.0.0/0"
}
# 一个公网 IP,绑到 ECS 上才能从外面 SSH
resource "huaweicloud_vpc_eip" "my_eip" {
publicip {
type = "5_bgp"
}
bandwidth {
name = "my-first-bw"
size = 5
share_type = "PER"
charge_mode = "traffic"
}
}
# 一台 ECS
resource "huaweicloud_compute_instance" "my_ecs" {
name = "my-first-ecs"
image_id = data.huaweicloud_images_image.os_image.id
flavor_id = var.flavor_id
availability_zone = var.availability_zone
admin_pass = var.ecs_password
security_group_ids = [huaweicloud_networking_secgroup.my_sg.id]
network {
uuid = huaweicloud_vpc_subnet.my_subnet.id
}
}
# 把 EIP 绑到 ECS 上
resource "huaweicloud_compute_eip_associate" "associate" {
public_ip = huaweicloud_vpc_eip.my_eip.address
instance_id = huaweicloud_compute_instance.my_ecs.id
}
先别急着跑,我逐段讲一下这里几个新手最容易卡的地方。
逐段讲:那些控制台里不会告诉你的事
为什么 VPC、子网、安全组都要自己写,不能只写一个 ECS?
在控制台买 ECS 的时候,页面会让你"选择 VPC"“选择子网”,那些是已经存在的。但在 Terraform 里,如果你不描述这些依赖,它不知道该把 ECS 放哪个网络里。所以一个完整的最小集,得从 VPC 开始往下写。这其实更贴近真实:一台 ECS 本来就不是孤立存在的,它一定在某个子网里、受某个安全组约束。Terraform 强迫你把这些关系写明白,反而是好事。
huaweicloud_vpc.my_vpc.id 这种写法是什么意思?
这是 Terraform 最核心的机制之一:引用。子网需要知道它属于哪个 VPC,但 VPC 的 ID 要等创建出来才有,你没法提前写死。所以你写 huaweicloud_vpc.my_vpc.id,意思是"用上面那个 VPC 资源创建后的 id"。Terraform 会自动算出依赖顺序:先建 VPC,拿到 id,再建子网。你不用操心先后,写引用就行。
EIP 绑定那段也是同一个道理:huaweicloud_compute_instance.my_ecs.id 引用 ECS 的 id,huaweicloud_vpc_eip.my_eip.address 引用 EIP 的地址。Terraform 自己会排好"先建 ECS 和 EIP,再绑定"。
data 那段和 resource 有什么区别?
resource 是"我要创建一个东西",data 是"我要查一个已经存在的东西"。镜像不是你创建的,是华为云提供的公共镜像,所以用 data 去查。most_recent = true 表示同名镜像有多个版本时取最新的。这样你不用去控制台复制那一长串 UUID,换镜像只改名字这一行。这个区分很重要:自己造的用 resource,别人现成的用 data。
EIP 那段里 5_bgp、PER、traffic 是什么?
5_bgp 是公网 IP 的类型(全动态 BGP),PER 是独享带宽,traffic 是按流量计费。这些在控制台买 EIP 时也是这些选项,只是控制台用下拉框包装了,Terraform 用字符串写出来。第一次照抄就行,等你想换共享带宽或按带宽计费时再改。
跑起来:三条命令
文件写好,在目录里依次执行:
terraform init # 下载华为云 provider 插件
terraform plan # 看看它打算创建什么,先预览,不动手
terraform apply # 确认无误后真正执行
plan 这一步是 Terraform 最值得讲的地方。它会告诉你"我打算创建 6 个资源:1 个 VPC、1 个子网、1 个安全组、1 个安全组规则、1 个 EIP、1 台 ECS,外加 1 个 EIP 绑定",然后等你输 yes 才动手。这相当于把控制台"立即购买"按钮前面加了一个完整的预览环节,而且这个预览是精确到每个字段的。
第一次跑的时候,建议你好好看一遍 plan 的输出,对照你的 .tf 文件,理解每一行配置对应输出里的什么。这个"配置 → 预览 → 执行"的闭环,就是 Terraform 的日常。
apply 完成后,输出里会有这台 ECS 的 EIP 地址,用 ssh root@那个IP 加上你设的密码就能登上去。
那个让人困惑的词:state
跑完 apply 之后,目录里会多出一个 terraform.tfstate 文件。很多人到这里就懵了:这是什么?
简单说,state 是 Terraform 的"记忆"。它记录了"我上次创建的这些资源,在云上的真实 ID 是什么"。下次你再跑 plan,Terraform 会拿这个记忆去和云上现状对比,看看有没有变化。没有变化就什么都不做,有变化就告诉你打算改什么。
这解释了一个新手常见的困惑:“我把 .tf 文件删了,云上的资源会没了吗?“不会。Terraform 是靠 state 去认资源的,不是靠 .tf 文件。.tf 是你"想要的”,state 是"现在实际的”,plan 就是对比这两者。删了 .tf 只是 Terraform 不知道你想要什么了,云上的东西还在。
反过来,如果你在控制台手动改了那台 ECS 的名字,再跑 plan,Terraform 会发现"云上名字变了,和我的配置不一致",提示你要不要改回来。这就是所谓的"漂移检测"。至于该改回配置还是接受云上的改动,那是另一个话题了,这里先知道有这么回事。
改个规格,为什么说要"重建"
这是新手最容易撞墙的一刻:你把 flavor_id 从 s6.large.2 改成 s6.xlarge.2,跑 plan,发现它显示的不是"修改"而是"销毁再创建"。
原因不复杂:华为云的 ECS 变更规格,在 API 层面有些字段是"创建时确定、之后不能原地改"的,规格就是其中之一。Terraform 诚实地告诉你这个改动它没法原地做,只能先销毁旧的再建新的。
这听起来吓人,但其实控制台里"变更规格"也是要走一个停机重启的过程的,本质类似。Terraform 只是把这件事说清楚了,而不是像控制台那样用一个按钮把它包装起来。遇到 force-new(强制重建)不可怕,可怕的是不知道它会发生。所以养成习惯:改完配置先 plan,看到"销毁"字样就停下来想一想,别直接 apply。
用完怎么收场
第一次练手,建完验证能 SSH 上去,就可以 terraform destroy 把这一整套都清掉,不产生持续费用。destroy 会再给你一个 plan 风格的预览,列出要删的东西,确认 yes 才执行。
这里有个新手容易慌的点:destroy 会把 VPC、子网、安全组、EIP、ECS 全删掉。如果你这个 VPC 里还有别的东西(比如手动建过另一台 ECS),Terraform 只删它自己管的那部分,不会动它不认识的资源。但反过来,如果你把别的东西建在了 Terraform 管的 VPC 里,删 VPC 时可能会因为"VPC 不为空"而失败。所以练手阶段,用一个全新的、干净的 VPC 最省心。
最后:思维转变比工具更重要
回到开头那个问题:控制台点出来的 ECS 有什么不好?其实没有不好,对于一次性、临时性的机器,控制台快得很。
但当你开始有"一组机器要一起管"“要能复现”“要能交接”"要能回顾历史"这些需求的时候,点鼠标就到头了。Terraform 给你的不是一个更快的点击工具,而是一种把基础设施当软件来管的思维:配置有源代码,变更有 diff,历史有版本,复现只需一个文件。
第一次上手会觉得"明明点几下就好的事,为什么要写这么多行"。这个阶段忍一忍。等你第二次、第三次用同一个文件改几个数字就拉起一套一样的环境时,你就回不去了。
给你的下一步建议:把上面这个最小例子真的跑一遍——init、plan、apply,SSH 上去看一眼,然后 destroy 掉。亲手过一遍完整循环,比看十篇博客都管用。整个过程中云上资源存在的时间也就十几分钟,按量计费花不了几毛钱,但你能把"配置即代码"这件事从概念变成肌肉记忆。
- 点赞
- 收藏
- 关注作者
评论(0)