Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Terraform RDS (module được vendor)

Cùng ý định MariaDB như ví dụ terraform-rds, được kết xuất qua dạng sourced của provider Terraform: thay vì một thân HCL nội tuyến, Recipe trỏ tới một module Terraform cục bộ và trình biên dịch vendor nó nguyên văn, rồi cung cấp các biến đầu vào của nó từ trụ cột developer và operator.

Những gì trình biên dịch xuất ra

Dưới dist/infra/terraform/, bản build tạo ra cấu hình gốc của boundary, và dưới dist/infra/terraform/modules/db/ là các tệp riêng của component db:

  • aggrega.modules.tf ở gốc boundary — cấu hình gốc, khai báo db là một khối module có source là ./modules/db và có các đối số là các biến đầu vào của module, theo thứ tự khóa xác định. Mỗi boundary terraform đều có một tệp như vậy, và chính nó đặt các component của một boundary vào một cấu hình Terraform duy nhất;
  • các tệp module được sao chép nguyên từng byte (variables.tf, main.tf, kể cả mọi phép nội suy ${...} mà tác giả module đã viết);
  • aggrega.provenance.tf bên cạnh các tệp đó — một tệp chú thích # nhận diện bản build.

Khối db mà ví dụ này xuất ra:

module "db" {
source = "./modules/db"
allocated_storage = 100
backup_retention_period = 14
db_name = "appdb"
engine_version = "11.4"
instance_class = "db.t3.small"
multi_az = true
port = 3306
skip_final_snapshot = false
storage_type = "gp3"
subnet_id = "production-private-db-subnets"
}

Hai trong số các đối số đó đáng để lần ngược về nơi chúng được viết ra. subnet_id là tên DB subnet group mà Release cung cấp dưới infra.overrides — group này được vận hành bên ngoài lần triển khai này, tên của nó khác nhau theo từng môi trường, và khai báo riêng của module không có giá trị mặc định, nên Recipe khẳng định nó và bản build dừng lại rõ ràng khi thiếu nó thay vì lập kế hoạch trên sai mạng. instance_class đến từ cùng trụ cột đó nhưng có giá trị mặc định trong Recipe, nên một Release không nêu gì sẽ nhận db.t3.small.

Bất cứ thứ gì một Recipe ánh xạ vào các đối số này, trình biên dịch đều chuyển qua nguyên vẹn và không bao giờ phân giải — kể cả một con trỏ Terraform ${...}. Điều thay đổi theo vị trí là nơi con trỏ đó rơi vào: một đối số module là một trong các vị trí mà Terraform đánh giá, nên một con trỏ viết ở đó được phân giải dựa trên cấu hình gốc lúc plan thay vì đến module dưới dạng một chuỗi nguyên văn. Nó vẫn phải chỉ tới thứ mà cấu hình đó khai báo.

Vì các đầu vào được nêu trong cấu hình gốc, riêng modules/db/ không phải là một cấu hình mà bạn có thể plan như khi đã triển khai — xem trang provider Terraform để biết engine làm gì nếu bạn thử.

Các tệp

  • aggregate.yaml — ý định của developer: một component db có kiểu core/datastore/mariadb.
  • release.yaml — định cỡ của operator cho boundary infra. Mục của nó cho db gắn slot bắt buộc root_password của Component với core/generated-secret (xem bên dưới), và đính kèm core/backup để giữ mỗi bản sao lưu tự động của instance trong 14 ngày — chính là backup_retention_period ở trên; khi không có đính kèm, instance giữ chúng trong 7 ngày.
  • manifest.yaml — gắn kiểu component MariaDB với Recipe Terraform terraform/mariadb-rds-module, vốn lấy module của nó từ cục bộ, kiểu Feature thông tin xác thực với terraform/generated-secret, và kiểu Feature sao lưu với terraform/backup-native, vốn không kết xuất gì: Recipe đọc đính kèm và tự cung cấp các đầu vào sao lưu của module.
  • .aggrega-config.yaml — chỉ định registry của hub mà các thực thể catalog được phân giải từ đó.

Slot thông tin xác thực trên một đích được quản lý

core/datastore/mariadb khai báo root_password là một slot bắt buộc: bản build dừng lại khi chưa có gì gắn vào nó. RDS tự tạo và xoay vòng mật khẩu master, và module được vendor mà Recipe này sao chép đặt manage_master_user_password để bật tính năng đó — nên slot được ủy quyền cho engine thay vì được điền bằng một giá trị viết tay.

Việc engine có sở hữu thông tin xác thực hay không phụ thuộc vào Recipe mà Manifest chọn, nên operator gắn slot, trong Release, ở mục của nó cho db. Nó gắn slot với core/generated-secret, thứ không cấu hình gì vì không có gì để viết, và FeatureRecipe của nó (terraform/generated-secret) thuần túy là phần nối dây không kết xuất gì. Module được vendor và cấu hình gốc đầu ra giống hệt từng byte như khi không có phần gắn nào. Tham chiếu của Manifest được định danh theo provider vì một tên recipe trần chỉ phân giải được khi đúng một provider có nó, và thư viện chuẩn cung cấp một FeatureRecipe generated-secret dưới nhiều provider — nên một tên trần hoàn toàn không phân giải được, và bản build dừng lại rõ ràng thay vì âm thầm chọn một provider cho bạn.

Tạo ví dụ

Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example terraform-rds-module

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd terraform-rds-module

Build

Terminal window
aggrega build --release release.yaml --auto-pull

--auto-pull ghi lockfile mà một bản clone mới còn thiếu trong quá trình build.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa có thư mục `terraform-rds-module`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `terraform-rds-module` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `terraform-rds-module` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `terraform-rds-module`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm dưới `terraform-rds-module/dist/`.