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áodblà một khốimodulecósourcelà./modules/dbvà 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.tfbê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 componentdbcó kiểucore/datastore/mariadb.release.yaml— định cỡ của operator cho boundaryinfra. Mục của nó chodbgắn slot bắt buộcroot_passwordcủa Component vớicore/generated-secret(xem bên dưới), và đính kèmcore/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 Terraformterraform/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ớiterraform/generated-secret, và kiểu Feature sao lưu vớiterraform/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ó:
aggrega scaffold --example terraform-rds-moduleSau đó 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:
cd terraform-rds-moduleBuild
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/`.