Ngôn ngữ cấu hình HCL (HashiCorp Configuration Language) được thiết kế để cân bằng hoàn hảo giữa tính dễ đọc của con người (tương tự YAML) và sức mạnh lập trình khai báo có cấu trúc dữ liệu chặt chẽ (như JSON). Tuy nhiên, nhiều kỹ sư vẫn gặp khó khăn khi xử lý các cấu trúc dữ liệu phức tạp như danh sách các object lồng nhau (list(object)), chuyển đổi mảng thành map bằng for expressions, hoặc định dạng các tệp cấu hình JSON/YAML động mà không bị lỗi cú pháp escape.

Bài viết này sẽ hướng dẫn bạn cách làm chủ toàn diện cú pháp HCL hiện đại từ phiên bản Terraform 1.7+, giúp mã nguồn hạ tầng của bạn ngắn gọn hơn 60%, loại bỏ code trùng lặp và tăng tính an toàn kiểu dữ liệu (Type Safety).

1. Hệ Thống Kiểu Dữ Liệu (Type System) trong HCL

HCL phân chia hệ thống kiểu dữ liệu thành 3 nhóm rõ rệt:

1.1. Phân Biệt list vs set vs tuple

• list(string): Danh sách các chuỗi có thứ tự, cho phép phần tử trùng lặp (ví dụ: ["10.0.1.0/24", "10.0.2.0/24"]).
• set(string): Tập hợp các chuỗi duy nhất, không bảo đảm thứ tự. Rất hữu ích khi dùng làm for_each cho tài nguyên.
• tuple([string, number, bool]): Mảng có độ dài cố định, các phần tử có kiểu dữ liệu khác nhau (ví dụ: ["t3.micro", 2, true]).

1.2. Khai Báo Cấu Trúc object Nâng Cao với optional()

Từ Terraform 1.3+, bạn có thể định nghĩa các thuộc tính tùy chọn kèm giá trị mặc định ngay trong kiểu dữ liệu object:

variable "security_rules" {
  type = list(object({
    port        = number
    protocol    = optional(string, "tcp")
    cidr_blocks = list(string)
    description = optional(string, "ShowTech Default Rule")
  }))
  description = "Danh sách Security Group Ingress Rules linh hoạt"
}

2. Làm Chủ For Expressions: Biến Đổi Dữ Liệu Cực Mạnh

For expressions trong HCL cho phép bạn lọc (filter), chuyển đổi (transform) từ mảng sang mảng hoặc từ mảng sang map chỉ trong một dòng lệnh.

2.1. Cú Pháp Biến Đổi List sang List (Filtering & Transformation)

locals {
  raw_subnets = ["subnet-a", "subnet-b", "subnet-c", "temp-subnet"]

  # Chỉ lấy các subnet production và viết hoa toàn bộ
  production_subnets = [
    for s in local_subnets : upper(s)
    if !startswith(s, "temp")
  ]
  # Kết quả: ["SUBNET-A", "SUBNET-B", "SUBNET-C"]
}

2.2. Chuyển Đổi List of Objects thành Map để Dùng trong for_each

Khi khởi tạo tài nguyên hạ tầng, for_each yêu cầu đầu vào là một map hoặc set of strings. Dưới đây là kỹ thuật biến đổi kinh điển:

locals {
  users_list = [
    { username = "alice", role = "Admin",   dept = "DevOps" },
    { username = "bob",   role = "Viewer",  dept = "QA" },
    { username = "carol", role = "Editor",  dept = "Dev" }
  ]

  # Biến đổi thành Map với key là username
  users_map = {
    for u in local.users_list : u.username => u
  }
}

# Áp dụng trực tiếp vào resource
resource "aws_iam_user" "members" {
  for_each = local.users_map

  name = each.key
  tags = {
    Role       = each.value.role
    Department = each.value.dept
    ManagedBy  = "Terraform"
  }
}

3. Heredoc & Template Expressions: Tạo JSON/YAML Động An Toàn

Cách Tiếp Cận Chuẩn Enterprise: Hàm jsonencode() & yamlencode()

# iam-role-policy.tf - Tạo IAM Policy động bằng jsonencode()
resource "aws_iam_policy" "eks_cluster_policy" {
  name        = "showtech-eks-cluster-access"
  description = "Chính sách phân quyền tối giản cho EKS Cluster"

  policy = jsonencode({
    Version = "2012-10-17"
    Statement = [
      {
        Effect   = "Allow"
        Action   = [
          "ec2:DescribeInstances",
          "ec2:DescribeRouteTables",
          "ec2:DescribeSecurityGroups",
          "ec2:DescribeSubnets",
          "ec2:DescribeVpcs"
        ]
        Resource = "*"
      },
      {
        Effect   = "Allow"
        Action   = [
          "s3:GetObject",
          "s3:PutObject"
        ]
        Resource = [
          "arn:aws:s3:::showtech-prod-assets/*"
        ]
      }
    ]
  })
}

4. Bảng So Sánh Kỹ Thuật Biến Đổi Dữ Liệu

5. Production War Story: Gỡ Lỗi "Invalid Type Error" Khi Nâng Cấp Module

Error: Invalid value for variable
on main.tf line 14:
14:   subnets = local.subnet_configs
The given value is not suitable for var.subnets declared at modules/vpc/variables.tf:1:
element 0: attribute "nat_gateway_enabled" is required.

Giải Pháp Triệt Để Với optional():

Trong module cũ, biến subnets yêu cầu mọi thuộc tính đều phải có mặt. Đội ngũ đã tái cấu trúc lại định nghĩa biến trong modules/vpc/variables.tf:

variable "subnets" {
  type = list(object({
    name                = string
    cidr_block          = string
    az                  = string
    is_public           = bool
    nat_gateway_enabled = optional(bool, false) # Tự gán mặc định nếu không khai báo
    custom_tags         = optional(map(string), {})
  }))
}

Ngay lập tức, mã nguồn tương thích ngược 100% mà không bắt buộc lập trình viên phải sửa hàng chục file cấu hình cũ.

6. Câu Hỏi Phỏng Vấn Kỹ Sư Cao Cấp (Senior Terraform Q&A)

Q1: Sự khác biệt giữa hàm try() và can() trong HCL là gì? Khi nào nên áp dụng?

Trả lời:
- try(expr1, expr2, ...): Đánh giá lần lượt các biểu thức, trả về giá trị của biểu thức đầu tiên không bị lỗi. Thường dùng để gán giá trị fallback an toàn (ví dụ: local.env = try(var.config.env, "development")).
- can(expr): Đánh giá biểu thức và chỉ trả về boolean true (nếu không có lỗi) hoặc false (nếu có lỗi). Thường dùng bên trong khối validation của biến để kiểm tra định dạng IP CIDR hoặc regex string.

Q2: Tại sao nên hạn chế dùng merge() trong vòng lặp lồng nhau và thay thế bằng flatten() kết hợp for?

Trả lời:
Khi xử lý cấu trúc dữ liệu 2 tầng (ví dụ: Mỗi VPC có nhiều Subnet, mỗi Subnet có nhiều Security Rule), việc dùng merge() lồng nhau dễ tạo ra các key xung đột hoặc code khó kiểm thử. Kết hợp flatten([ for vpc in var.vpcs : [ for s in vpc.subnets : ... ] ]) tạo ra danh sách phẳng 1 chiều hoàn hảo, giúp định danh tài nguyên trong for_each bằng cú pháp "${vpc.name}-${s.name}" tường minh và dễ đọc.

7. Tổng Kết

Làm chủ cú pháp HCL và các biểu thức dữ liệu nâng cao là nền tảng cốt lõi để bạn viết các Terraform Module tái sử dụng chuẩn Enterprise.

Trong bài viết tiếp theo (Bài 04), chúng ta sẽ phân tích chuyên sâu Quản Trị Dependency Graph (DAG): Phụ Thuộc Tường Minh vs Ngầm Định và Chiến Lược Tránh Lỗi Cycle Dependencies.

Bài viết thuộc Series đào tạo Terraform Thực Chiến độc quyền trên ShowTech.vn.