Tái Cấu Trúc Terraform: Chuyển Đổi Từ State Monolithic Sang Kiến Trúc Mô-đun Theo Môi Trường

Trong quá trình phát triển công cụ tự đông hoá truy vấn Google Maps theo địa chỉ dưới dạng văn bản trên nền tảng Instagram (chi tiết tại đây), nhận thấy sự cần thiết trong việc chuyển đổi cấu trúc quản lí trạng thái của Terraform từ dạng phẳng, phi cấu trúc, monolith sang dạng mô-đun, phân tách môi trường theo file directory Tái Cấu Trúc Terraform: Chuyển Đổi Từ State Monolithic Sang Kiến Trúc Mô-đun Theo Môi Trường Hướng dẫn sơ khai các bước để tổ chức lại codebase Terraform của bạn để có sự tách biệt, tái sử dụng và triển khai an toàn hơn. 1. Tổ Chức State Ban Đầu Cấu Trúc & Quy Trình Một thư mục gốc terraform/ với main.tf, variables.tf, v.v. Một file state duy nhất (terraform.tfstate), thường được lưu trữ trong S3 hoặc cục bộ. Sử dụng .tfvars (dev.tfvars, prod.tfvars) ghi đè biến để phân tách môi trường. Lợi ích Cấu trúc đơn giản, trực quan đối với người mới và dự án nhỏ. Hạn Chế & Nhược Điểm Sẽ bộc lộ khi số lượng tài nguyên tăng lên: State phình to: tất cả tài nguyên (dev/staging/prod) đều nằm trong một file. Triển khai rủi ro: vô tình thay đổi tài nguyên production. Mô-đun hóa kém: mọi thay đổi đối với API, IAM, Lambda đều nằm trong cùng một file. Không có ranh giới rõ ràng: khó để đào tạo thành viên mới hoặc phân chia trách nhiệm. 2. Giới Thiệu Về Module Terraform Module Là Gì? Một thư mục chứa mã Terraform (resources, inputs, outputs) mà bạn có thể gọi từ một cấu hình khác. Root module: main.tf cấp cao nhất và các file liên quan. Child modules: các khối xây dựng có thể tái sử dụng (ví dụ: modules/lambda/). Kiến Trúc và Giao Tiếp Của Module Một module Terraform không chỉ là một thư mục mã—nó là một đối tượng đóng gói độc lập với một hợp đồng (ràng buộc) rõ ràng về cách tương tác với thế giới bên ngoài thông qua biến (var): modules/lambda/ ├── **main.tf** # Định nghĩa tài nguyên chính ├── **variables.tf** # Tham số đầu vào (API của module) ├── **outputs.tf** # Giá trị được hiển thị cho module cha ├── locals.tf # Tính toán và biến đổi nội bộ ├── data.tf # Data sources và lookups └── README.md # Tài liệu về mục đích, inputs, và outputs Mỗi file có một mục đích cụ thể: main.tf - Chứa và tập hợp các định nghĩa tài nguyên cốt lõi (thường đi kèm với nhau) để thực hiện một hành động/tính năng hoàn chỉnh mà module tạo và quản lý. Đối với module Lambda, nó sẽ bao gồm: resource "aws_lambda_function" "functions" { for_each = var.functions function_name = "${var.name_prefix}-${each.key}" handler = each.value.handler runtime = each.value.runtime role = var.execution_role_arn filename = each.value.source_file source_code_hash = filebase64sha256(each.value.source_file) memory_size = each.value.memory_size timeout = each.value.timeout environment { variables = merge(var.common_environment_variables, each.value.environment_variables) } tags = merge(var.common_tags, each.value.tags) } # Các tài nguyên bổ sung như permissions, CloudWatch log groups, v.v. variables.tf - Định nghĩa các tham số đầu vào của module, với mô tả và ràng buộc kiểu: variable "name_prefix" { description = "Tiền tố được thêm vào trước tất cả tên tài nguyên" type = string } variable "functions" { description = "Bản đồ các hàm Lambda cần tạo" type = map(object({ handler = string runtime = string source_file = string memory_size = number timeout = number environment_variables = map(string) tags = map(string) })) } variable "execution_role_arn" { description = "ARN của IAM role được sử dụng bởi các hàm Lambda" type = string } variable "common_environment_variables" { description = "Biến môi trường áp dụng cho tất cả các hàm" type = map(string) default = {} } variable "common_tags" { description = "Tags áp dụng cho tất cả tài nguyên" type = map(string) default = {} } outputs.tf - Định nghĩa các giá trị mà module hiển thị cho các module cha: output "function_arns" { description = "ARNs của các hàm Lambda đã tạo" value = { for name, function in aws_lambda_function.functions : name => function.arn } } output "function_names" { description = "Tên của các hàm Lambda đã tạo" value = { for name, function in aws_lambda_function.functions : name => function.function_name } } output "invoke_urls" { description = "URLs cơ sở để gọi các hàm Lambda (nếu tích hợp API Gateway được bật)" value = { for name, _ in var.functions : name => aws_apigatewayv2_stage.api[name].invoke_url if contains(keys(aws_apigatewayv2_stage.api), name) } } Sự Kết Hợp và Tái Sử Dụng Module Các module có thể gọi các module khác, tạo thành một mẫu kết hợp. Điều này cho phép bạn xây dựng các trừu tượng cấp cao hơn: # Bên trong một module "serverless_api" kết hợp các module khác module

modules/lambda/
├── **main.tf**         # Định nghĩa tài nguyên chính
├── **variables.tf**    # Tham số đầu vào (API của module)
├── **outputs.tf**      # Giá trị được hiển thị cho module cha
├── locals.tf       # Tính toán và biến đổi nội bộ
├── data.tf         # Data sources và lookups
└── README.md       # Tài liệu về mục đích, inputs, và outputs

resource "aws_lambda_function" "functions" {
  for_each = var.functions

  function_name = "${var.name_prefix}-${each.key}"
  handler       = each.value.handler
  runtime       = each.value.runtime
  role          = var.execution_role_arn

  filename         = each.value.source_file
  source_code_hash = filebase64sha256(each.value.source_file)

  memory_size = each.value.memory_size
  timeout     = each.value.timeout

  environment {
    variables = merge(var.common_environment_variables, each.value.environment_variables)
  }

  tags = merge(var.common_tags, each.value.tags)
}

# Các tài nguyên bổ sung như permissions, CloudWatch log groups, v.v.

variable "name_prefix" {
  description = "Tiền tố được thêm vào trước tất cả tên tài nguyên"
  type        = string
}

variable "functions" {
  description = "Bản đồ các hàm Lambda cần tạo"
  type = map(object({
    handler               = string
    runtime               = string
    source_file           = string
    memory_size           = number
    timeout               = number
    environment_variables = map(string)
    tags                  = map(string)
  }))
}

variable "execution_role_arn" {
  description = "ARN của IAM role được sử dụng bởi các hàm Lambda"
  type        = string
}

variable "common_environment_variables" {
  description = "Biến môi trường áp dụng cho tất cả các hàm"
  type        = map(string)
  default     = {}
}

variable "common_tags" {
  description = "Tags áp dụng cho tất cả tài nguyên"
  type        = map(string)
  default     = {}
}

output "function_arns" {
  description = "ARNs của các hàm Lambda đã tạo"
  value = {
    for name, function in aws_lambda_function.functions : name => function.arn
  }
}

output "function_names" {
  description = "Tên của các hàm Lambda đã tạo"
  value = {
    for name, function in aws_lambda_function.functions : name => function.function_name
  }
}

output "invoke_urls" {
  description = "URLs cơ sở để gọi các hàm Lambda (nếu tích hợp API Gateway được bật)"
  value = {
    for name, _ in var.functions :
    name => aws_apigatewayv2_stage.api[name].invoke_url
    if contains(keys(aws_apigatewayv2_stage.api), name)
  }
}

# Bên trong một module "serverless_api" kết hợp các module khác
module "lambda" {
  source = "../lambda"

  name_prefix        = var.name_prefix
  functions          = var.functions
  execution_role_arn = module.iam.lambda_execution_role_arn
}

module "api_gateway" {
  source = "../api_gateway"

  name_prefix     = var.name_prefix
  api_name        = "${var.name_prefix}-api"
  lambda_function = module.lambda.function_arns["api_handler"]
  stage_name      = var.environment
}

module "iam" {
  source = "../iam"

  name_prefix = var.name_prefix
  services    = ["lambda.amazonaws.com"]
}

   module "lambda" {
     source = "git::https://github.com/company/terraform-modules.git//modules/lambda?ref=v1.2.3"
     # Cấu hình module...
   }

   module "lambda" {
     source  = "terraform-aws-modules/lambda/aws"
     version = "2.7.0"
     # Cấu hình module...
   }

   module "lambda" {
     source = "../../modules/lambda"  # Với quy trình kiểm soát phiên bản nội bộ
     # Cấu hình module...
   }

module "lambda" {
  source             = "../../modules/lambda"
  functions          = local.lambda_functions
  execution_role_arn = module.iam.execution_role_arn
}

terraform/
├── environments/
│   ├── dev/
│   │   └── main.tf
│   ├── staging/
│   │   └── main.tf
│   └── prod/
│       └── main.tf
└── modules/
    ├── lambda/
    ├── iam/
    ├── api_gateway/
    └── cloudwatch/

Related Posts

Using single chip microcomputer to realize ultrasonic o...

Mar 20, 2025  0

The Psychology of Task Management and Staying Motivated

Mar 16, 2025  0

When Not to Use AI: A Developer’s Perspective

Mar 25, 2025  0