使用 Terraform 在华为云上构建高可用 Web 应用架构
使用 Terraform 在华为云上构建高可用 Web 应用架构
本文以一个典型的两层 Web 应用为例,手把手带你用 Terraform 在华为云上搭建一套跨可用区的高可用架构。不讲空理论,每一段代码都对应你能看见的云资源。
一、为什么选择 Terraform 管理华为云基础设施
如果你还在控制台里手动点选创建 VPC、ECS、安全组,大概率遇到过这些场景:
- 环境一多就乱——开发、测试、生产三套环境,手动建容易漏配或配错
- 出了事说不清——谁改了安全组规则?什么时候改的?无从追溯
- 灾难恢复慢——整个环境挂了,重新手动搭一遍可能要半天
Terraform 用声明式的方式解决这些问题:你用代码描述"我要什么样的基础设施",Terraform 负责把它变成现实。代码可以进 Git,每次变更都有 commit 记录,环境复制就是一句 terraform apply。
华为云官方提供了 Terraform Provider(huaweicloud),覆盖了 VPC、ECS、ELB、RDS、OBS 等核心服务,在华为云镜像源也能直接下载,国内网络无障碍。
二、架构设计:我们要搭什么
先看目标架构,再写代码,这样每一段 Terraform 你都知道在描述哪块云资源。
┌─────────────┐
│ ELB (公网) │ ← 用户访问入口,带弹性公网 IP
└──────┬──────┘
│
┌────────────┼────────────┐
│ │
┌────────┴────────┐ ┌────────┴────────┐
│ ECS-AZ1 (Web) │ │ ECS-AZ2 (Web) │ ← 两个可用区各一台 ECS
│ 10.0.1.10 │ │ 10.0.2.10 │
└────────┬────────┘ └────────┬────────┘
│ │
└────────────┬────────────┘
│
┌──────┴──────┐
│ RDS (主备) │ ← MySQL 主备实例,自动跨 AZ 切换
└─────────────┘
设计要点:
| 组件 | 选型 | 为什么 |
|---|---|---|
| VPC | 1 个 VPC + 2 个子网 | 两个子网分布在不同可用区,是跨 AZ 高可用的基础 |
| ECS | 2 台 s6.large.2 | Web 应用层,分别在不同 AZ,任一 AZ 故障另一台仍可服务 |
| ELB | 弹性负载均衡 | 统一入口,自动健康检查,摘除故障节点 |
| RDS | MySQL 8.0 主备 | 数据层跨 AZ 主备,故障自动切换,无需手动干预 |
| 安全组 | 最小权限原则 | 只开必要端口,数据库只允许 ECS 网段访问 |
三、开始动手:从 Provider 到完整架构
3.1 项目结构
huaweicloud-ha-webapp/
├── main.tf # 主资源定义
├── variables.tf # 输入变量
├── outputs.tf # 输出信息
└── terraform.tfvars # 变量赋值(不进 Git)
3.2 Provider 配置
# main.tf
terraform {
required_providers {
huaweicloud = {
source = "huaweicloud/huaweicloud"
version = ">= 1.50.0"
}
}
}
provider "huaweicloud" {
region = var.region
access_key = var.access_key
secret_key = var.secret_key
}
几个要点解释:
region:华为云区域,比如cn-north-4(华北-北京四),不同区域可用区数量不同,建之前先确认你的区域至少有 2 个 AZaccess_key/secret_key:AK/SK 认证。不要硬编码在 .tf 文件里,通过环境变量传入:export HW_ACCESS_KEY="你的AK",Provider 会自动读取。或者用variables.tf+terraform.tfvars(记得加进.gitignore)
3.3 变量定义
# variables.tf
variable "region" {
description = "华为云区域"
type = string
default = "cn-north-4"
}
variable "access_key" {
description = "华为云 AK"
type = string
sensitive = true
}
variable "secret_key" {
description = "华为云 SK"
type = string
sensitive = true
}
variable "vpc_cidr" {
description = "VPC 网段"
type = string
default = "10.0.0.0/16"
}
variable "ecs_flavor" {
description = "ECS 规格"
type = string
default = "s6.large.2"
}
variable "ecs_password" {
description = "ECS root 密码"
type = string
sensitive = true
}
variable "rds_password" {
description = "RDS 管理员密码"
type = string
sensitive = true
}
sensitive = true 的变量,Terraform 在 plan/apply 输出中会显示为 (sensitive value),不会明文打印到终端——这是 Terraform 内置的防泄漏机制,但不是加密,state 文件里仍然是明文,所以 state 文件也要妥善保管。
3.4 网络层:VPC + 子网 + 安全组
# --- VPC ---
resource "huaweicloud_vpc" "main" {
name = "ha-webapp-vpc"
cidr = var.vpc_cidr
}
# --- 子网:AZ1 ---
resource "huaweicloud_vpc_subnet" "subnet_az1" {
name = "ha-webapp-subnet-az1"
vpc_id = huaweicloud_vpc.main.id
cidr = "10.0.1.0/24"
gateway_ip = "10.0.1.1"
availability_zone = "cn-north-4a"
}
# --- 子网:AZ2 ---
resource "huaweicloud_vpc_subnet" "subnet_az2" {
name = "ha-webapp-subnet-az2"
vpc_id = huaweicloud_vpc.main.id
cidr = "10.0.2.0/24"
gateway_ip = "10.0.2.1"
availability_zone = "cn-north-4b"
}
这里有个概念值得展开:可用区(AZ)。一个区域(Region)比如 cn-north-4 是地理概念,下面有多个可用区(4a、4b、4c…),每个 AZ 是独立的物理机房,有独立的电力和网络。把两台 ECS 放在不同 AZ,一个机房断电另一个还能跑——这就是跨 AZ 高可用的本质。
接下来是安全组,这里我要特别强调一个常见反模式:
# --- Web 安全组 ---
resource "huaweicloud_networking_secgroup" "web" {
name = "ha-webapp-sg-web"
description = "Web 层安全组:只开 80 和 443"
}
resource "huaweicloud_networking_secgroup_rule" "web_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
}
resource "huaweicloud_networking_secgroup_rule" "web_https" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 443
port_range_max = 443
remote_ip_prefix = "0.0.0.0/0"
security_group_id = huaweicloud_networking_secgroup.web.id
}
resource "huaweicloud_networking_secgroup_rule" "web_ssh" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 22
port_range_max = 22
remote_ip_prefix = "10.0.0.0/16" # 只允许 VPC 内网 SSH,不对公网开放
security_group_id = huaweicloud_networking_secgroup.web.id
}
# --- 数据库安全组 ---
resource "huaweicloud_networking_secgroup" "db" {
name = "ha-webapp-sg-db"
description = "数据库安全组:只允许 Web 安全组访问 3306"
}
resource "huaweicloud_networking_secgroup_rule" "db_mysql" {
direction = "ingress"
ethertype = "IPv4"
protocol = "tcp"
port_range_min = 3306
port_range_max = 3306
remote_group_id = huaweicloud_networking_secgroup.web.id
security_group_id = huaweicloud_networking_secgroup.db.id
}
注意数据库安全组的规则:remote_group_id 引用的是 Web 安全组的 ID,而不是写一个 IP 网段。这样做的好处是——以后 Web 层扩容加了新 ECS,只要新 ECS 还在这个安全组里,数据库自动允许它访问,不用改安全组规则。这比写死 10.0.1.0/24 灵活得多。
反模式警告:我见过不少项目给数据库安全组开 0.0.0.0/0 的 3306 端口——“先通再说,后面再收”。后面通常就没有后面了。数据库暴露在公网上,等于把家门大锁换成了挂锁。如果你现在的环境有这个问题,建议今天就改。
3.5 计算层:两台跨 AZ 的 ECS
# --- ECS: AZ1 ---
resource "huaweicloud_compute_instance" "web_az1" {
name = "ha-webapp-web-az1"
image_id = data.huaweicloud_images_image.centos.id
flavor_id = var.ecs_flavor
availability_zone = "cn-north-4a"
admin_pass = var.ecs_password
network {
uuid = huaweicloud_vpc_subnet.subnet_az1.id
}
security_group_ids = [huaweicloud_networking_secgroup.web.id]
tags = {
App = "ha-webapp"
Layer = "web"
AZ = "az1"
Managed = "terraform"
}
}
# --- ECS: AZ2 ---
resource "huaweicloud_compute_instance" "web_az2" {
name = "ha-webapp-web-az2"
image_id = data.huaweicloud_images_image.centos.id
flavor_id = var.ecs_flavor
availability_zone = "cn-north-4b"
admin_pass = var.ecs_password
network {
uuid = huaweicloud_vpc_subnet.subnet_az2.id
}
security_group_ids = [huaweicloud_networking_secgroup.web.id]
tags = {
App = "ha-webapp"
Layer = "web"
AZ = "az2"
Managed = "terraform"
}
}
# --- 镜像数据源 ---
data "huaweicloud_images_image" "centos" {
name = "CentOS 7.9 64bit"
most_recent = true
}
两个 resource 块几乎一样,只有 availability_zone 和子网不同。这里有个选择:要不要用 count 或 for_each 来减少重复?
# 等价的写法,用 for_each 更 DRY:
locals {
azs = {
az1 = { zone = "cn-north-4a", subnet_id = huaweicloud_vpc_subnet.subnet_az1.id }
az2 = { zone = "cn-north-4b", subnet_id = huaweicloud_vpc_subnet.subnet_az2.id }
}
}
resource "huaweicloud_compute_instance" "web" {
for_each = local.azs
name = "ha-webapp-web-${each.key}"
image_id = data.huaweicloud_images_image.centos.id
flavor_id = var.ecs_flavor
availability_zone = each.value.zone
admin_pass = var.ecs_password
network {
uuid = each.value.subnet_id
}
security_group_ids = [huaweicloud_networking_secgroup.web.id]
}
两种写法都可以。项目小的时候展开写更直观,项目大了用 for_each 更好维护。选择哪种取决于你团队的偏好,不是对错问题。
3.6 负载均衡层:ELB
# --- ELB 弹性公网 IP ---
resource "huaweicloud_vpc_eip" "elb" {
publicip {
type = "5_bgp"
}
bandwidth {
name = "ha-webapp-elb-bw"
size = 5
share_type = "PER"
charge_mode = "traffic"
}
}
# --- 负载均衡器 ---
resource "huaweicloud_elb_loadbalancer" "main" {
name = "ha-webapp-elb"
vpc_id = huaweicloud_vpc.main.id
vip_subnet_id = huaweicloud_vpc_subnet.subnet_az1.id
l7_flavor_id = "l7.flavor.small"
eip_id = huaweicloud_vpc_eip.elb.id
}
# --- 监听器 ---
resource "huaweicloud_elb_listener" "http" {
name = "ha-webapp-listener-http"
protocol = "HTTP"
protocol_port = 80
loadbalancer_id = huaweicloud_elb_loadbalancer.main.id
}
# --- 后端服务器组 ---
resource "huaweicloud_elb_pool" "web" {
name = "ha-webapp-pool-web"
protocol = "HTTP"
lb_algorithm = "ROUND_ROBIN"
listener_id = huaweicloud_elb_listener.http.id
}
# --- 后端成员:两台 ECS ---
resource "huaweicloud_elb_member" "web_az1" {
pool_id = huaweicloud_elb_pool.web.id
address = huaweicloud_compute_instance.web_az1.access_ip_v4
subnet_id = huaweicloud_vpc_subnet.subnet_az1.id
protocol_port = 80
weight = 1
}
resource "huaweicloud_elb_member" "web_az2" {
pool_id = huaweicloud_elb_pool.web.id
address = huaweicloud_compute_instance.web_az2.access_ip_v4
subnet_id = huaweicloud_vpc_subnet.subnet_az2.id
protocol_port = 80
weight = 1
}
# --- 健康检查 ---
resource "huaweicloud_elb_monitor" "web" {
pool_id = huaweicloud_elb_pool.web.id
type = "HTTP"
interval = 10
timeout = 5
max_retries = 3
port = 80
url_path = "/health"
expected_codes = "200"
}
健康检查配置值得多说一句:url_path = "/health" 意味着 ELB 会定期请求每台 ECS 的 /health 路径,返回 200 就认为节点正常,连续 3 次失败就摘除流量。你的应用必须实现这个健康检查接口,否则 ELB 永远认为节点正常,即使应用已经假死——健康检查就形同虚设了。
3.7 数据层:RDS MySQL 主备
resource "huaweicloud_rds_instance" "mysql" {
name = "ha-webapp-rds"
flavor = "rds.mysql.s1.large"
ha_replication = "semisynchronous" # 半同步复制,兼顾性能和数据安全
ha_mode = "ha" # 主备模式,自动跨 AZ
db {
type = "MySQL"
version = "8.0"
password = var.rds_password
}
volume {
type = "ULTRAHIGH"
size = 100
}
vpc_id = huaweicloud_vpc.main.id
subnet_id = huaweicloud_vpc_subnet.subnet_az1.id
security_group_id = huaweicloud_networking_secgroup.db.id
availability_zone = "cn-north-4a" # 主实例所在 AZ,备实例自动在另一个 AZ
}
ha_mode = "ha" 是关键:华为云 RDS 主备实例会在两个 AZ 各部署一个,主库故障时自动切换到备库,应用层的数据库连接需要配合使用 RDS 的浮动 IP(连接地址不变,切换后自动指向新主库)。
3.8 输出
# outputs.tf
output "elb_public_ip" {
description = "ELB 公网 IP,浏览器访问这个地址"
value = huaweicloud_vpc_eip.elb.address
}
output "ecs_az1_private_ip" {
description = "AZ1 ECS 内网 IP"
value = huaweicloud_compute_instance.web_az1.access_ip_v4
}
output "ecs_az2_private_ip" {
description = "AZ2 ECS 内网 IP"
value = huaweicloud_compute_instance.web_az2.access_ip_v4
}
output "rds_connection_address" {
description = "RDS 连接地址(浮动 IP,主备切换后不变)"
value = huaweicloud_rds_instance.mysql.private_ip
}
输出值在 terraform apply 结束后打印到终端,方便你直接拿到访问地址。也可以用 terraform output elb_public_ip 随时查询,不用再翻控制台。
四、部署流程:init → plan → apply
4.1 初始化
terraform init
这一步会下载华为云 Provider 插件。如果你在国内网络环境,可以配置华为云镜像源加速:
export TF_PLUGIN_CACHE_DIR="$HOME/.terraform.d/plugin-cache"
# Provider 下载走华为云镜像,已在 provider 配置中通过 source 指定
4.2 预览变更
terraform plan
这是 Terraform 最有价值的一步。 它会对比你代码描述的期望状态和云上的实际状态,告诉你接下来要创建、修改、删除哪些资源,但不会真正执行。养成先 plan 再 apply 的习惯,能避免 90% 的误操作。
输出大概长这样:
Plan: 16 to add, 0 to change, 0 to destroy.
# huaweicloud_vpc.main will be created
+ resource "huaweicloud_vpc" "main" {
+ id = (known after apply)
+ name = "ha-webapp-vpc"
+ cidr = "10.0.0.0/16"
}
# huaweicloud_compute_instance.web_az1 will be created
+ resource "huaweicloud_compute_instance" "web_az1" {
+ name = "ha-webapp-web-az1"
+ flavor_id = "s6.large.2"
+ availability_zone = "cn-north-4a"
...
}
...(共 16 个资源)
+ 表示新增,~ 表示修改,- 表示删除。看到 16 to add、0 to destroy,说明是全新创建,没有误删风险。
4.3 执行部署
terraform apply
输入 yes 确认后,Terraform 会按照资源依赖关系自动编排创建顺序:先建 VPC,再建子网,然后安全组,最后 ECS 和 ELB——你不需要操心先后顺序,Terraform 通过代码中的引用关系(比如 vpc_id = huaweicloud_vpc.main.id)自动推导出依赖图。
4.4 销毁环境
terraform destroy
一句命令销毁所有资源,开发测试环境用完即毁,不花冤枉钱。但请务必先 plan 确认 destroy 列表,尤其是在有多个 state 文件共存的场景下,避免误删生产环境。
五、几个实战中踩过的坑
坑 1:可用区名称不是猜的
不同区域的可用区命名不同:cn-north-4 是 cn-north-4a、cn-north-4b,但 cn-south-1 可能是 cn-south-1a、cn-south-1b、cn-south-1c。不要凭经验猜,用这个命令查:
hcloud ECS ShowAvailabilityZone --cli-region="cn-north-4"
坑 2:ECS 密码复杂度要求
华为云对 ECS root 密码有复杂度要求:至少 8 位,包含大写、小写、数字、特殊字符各至少一个。如果你在 terraform.tfvars 里写了简单密码,apply 时会报错 Password does not meet complexity requirements,而且这个错误发生在 ECS 创建阶段,前面的 VPC、子网已经建好了——你改完密码再 apply,Terraform 只会创建失败的 ECS,不会重复创建已有的资源。
坑 3:RDS 创建较慢,超时不是 bug
RDS 主备实例创建可能需要 5-10 分钟,Terraform 默认超时可能不够。如果遇到 timeout,不要慌,资源在后台还在创建。加一个 timeout 配置:
resource "huaweicloud_rds_instance" "mysql" {
# ... 其他配置 ...
timeouts {
create = "30m"
}
}
坑 4:state 文件是命根子
terraform.tfstate 记录了所有资源的 ID 和属性,Terraform 靠它来知道云上有什么。这个文件丢了,Terraform 就"失忆"了——它不知道哪些资源是自己建的,destroy 时不知道该删什么。
最低限度:把 state 文件加进 Git(注意里面有密码明文,仅限内部项目)。更好的做法是用华为云 OBS 做 remote backend:
terraform {
backend "s3" {
bucket = "my-terraform-state"
key = "ha-webapp/terraform.tfstate"
region = "cn-north-4"
endpoint = "https://obs.cn-north-4.myhuaweicloud.com"
}
}
OBS 兼容 S3 协议,Terraform 的 S3 backend 可以直接用。这样 state 存在云端,多人协作不会冲突,还有版本历史。
六、进阶:让架构更上一层楼
基础架构跑起来之后,有几个方向可以继续优化:
6.1 自动伸缩(AS)
Web 层从固定 2 台变成弹性伸缩:流量高峰自动扩到 4 台,低谷缩回 2 台。用 huaweicloud_as_group 和 huaweicloud_as_policy 资源,配置基于 CPU 利用率的伸缩规则。Terraform 代码量增加不多,但运维效率提升明显。
6.2 监控告警(CES)
给 ECS 和 RDS 配上告警规则:CPU 超过 80% 告警、磁盘使用率超 90% 告警、RDS 主备切换告警。用 huaweicloud_ces_alarmrule 资源,告警通知到企业微信或钉钉。没有监控的架构等于盲飞,出了问题用户比你先知道。
6.3 数据库代理(RDS Proxy)
在 ECS 和 RDS 之间加一层数据库代理,实现读写分离:写请求走主库,读请求自动分发到备库。对读多写少的 Web 应用效果显著,而且主备切换时代理层会自动处理连接,应用无感知。
6.4 多环境管理
用 Terraform Workspace 或目录分隔来管理多套环境:
environments/
├── dev/
│ ├── main.tf → module 引用
│ └── terraform.tfvars # 小规格、少实例
├── staging/
│ ├── main.tf → 同样的 module 引用
│ └── terraform.tfvars # 中等规格
└── prod/
├── main.tf → 同样的 module 引用
└── terraform.tfvars # 大规格、多实例、开启 HA
同一套代码,不同变量文件,环境差异用变量控制而不是复制粘贴。
七、写在最后
从手动点控制台到用 Terraform 管理基础设施,最大的转变不是工具换了,而是思维方式变了:
- 从"一次性操作"到"可重复的代码"——环境可以随时重建,心里就不慌了
- 从"靠记忆"到"靠 Git"——每次变更有记录,出了问题能回溯
- 从"一台一台建"到"一批一批建"——16 个资源一句 apply 搞定,人的精力用在架构设计上,而不是重复操作上
本文的完整代码可以在实践中逐步验证。如果你刚开始接触 Terraform,建议先从一个 VPC 开始,plan 看看、apply 试试、destroy 再试试,感受一下声明式基础设施管理的节奏,再逐步加 ECS、ELB、RDS。一口吃不成胖子,但每一步都是实实在在的云资源,看得见摸得着。
作者注:本文示例基于 Terraform >= 1.3 和 huaweicloud Provider >= 1.50.0,部分资源参数可能随版本更新有变化,以官方文档为准。
- 点赞
- 收藏
- 关注作者
评论(0)