使用 Terraform 在华为云上构建高可用 Web 应用架构

举报
yd_231613284 发表于 2026/11/10 08:13:40 2026/11/10
【摘要】 使用 Terraform 在华为云上构建高可用 Web 应用架构本文以一个典型的两层 Web 应用为例,手把手带你用 Terraform 在华为云上搭建一套跨可用区的高可用架构。不讲空理论,每一段代码都对应你能看见的云资源。 一、为什么选择 Terraform 管理华为云基础设施如果你还在控制台里手动点选创建 VPC、ECS、安全组,大概率遇到过这些场景:环境一多就乱——开发、测试、生产三...

使用 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 个 AZ
  • access_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,部分资源参数可能随版本更新有变化,以官方文档为准。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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