HCL 语法

这一课你将能做到

1. 区分 HCL 中最常用的五种块：terraform、provider、resource、data、variable
2. 正确写出资源块并用「类型.名称.属性」的方式跨资源引用
3. 熟练使用字符串插值、集合类型、条件表达式和常用内置函数

为什么要学

HCL 是 Terraform 的「Java 语言」——语法不懂，连官方示例都读不下去，更别说自己写。好消息是 HCL 很小：日常 80% 的工作只涉及资源块、属性赋值、字符串插值和少量函数。这一课把这些一次讲透，后面所有课程都是在这套语法上换资源类型。

人话：HCL 像填空题——「我要一个什么（resource 类型），给它起个什么名字（本地名），它的参数分别填什么」。掌握这个形状，AWS 五十多种资源你都能照着文档写出来。

先建立图像

一个资源块的固定形状：

resource "aws_instance" "app" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t3.micro"

  tags = {
    Name = "springboot-app"
  }
}

• resource：块类型，关键字，固定
• "aws_instance"：资源类型，决定这个块创建什么
• "app"：本地名，只在当前配置里引用用，不影响云上资源名
• 花括号内：参数 = 参数值

引用这个资源创建后产生的属性：

aws_instance.app.id          # 资源实例 ID
aws_instance.app.public_ip   # 公网 IP

记忆口诀：类型 + 本地名 + 点属性。

跟着做

步骤 1：搭建一个纯本地的练习目录

新建 hcl-practice/main.tf，全程不需要云账号：

terraform {
  required_version = ">= 1.7.0"
}

provider "local" {}

# 在本机生成一个文件，验证各种语法的输出
resource "local_file" "greeting" {
  filename = "${path.module}/hello.txt"
  content  = "Hello HCL"
}

执行 terraform init && terraform apply，目录里会出现 hello.txt。

步骤 2：变量、字符串与插值

改写文件，体验三种字符串写法：

variable "project" {
  type    = string
  default = "springboot-demo"
}

resource "local_file" "greeting" {
  filename = "${path.module}/hello.txt"
  content  = "项目：${var.project}，模块路径：${path.module}"
}

要点：双引号字符串里用 ${表达式} 插值；path.module 是内置值，表示当前模块目录。

步骤 3：集合类型——list 与 map

locals {
  ports  = [8080, 8081, 8082]                       # list：有顺序
  tags = {                                          # map：键值对
    Project = var.project
    Env     = "dev"
  }
  first_port = local.ports[0]                       # 下标取值
  env_name   = local.tags.Env                       # 按键取值
}

output "show" {
  value = "第一个端口是 ${local.first_port}，环境是 ${local.env_name}"
}