Terraform RDS (artifact HCL nội tuyến)
Một cơ sở dữ liệu MariaDB duy nhất, được viết một lần dưới dạng ý định của nhà phát triển và được render thành một tệp HCL Terraform cấp phát một instance AWS RDS được quản lý.
Ví dụ này minh họa dạng artifact của provider Terraform:
Recipe mang một phần thân main.tf nội tuyến dưới artifacts:, và trình biên dịch
xuất nguyên văn phần thân đó sau khi phân giải các biểu thức template của nó. Provider
không bao giờ chạy terraform; nó tạo ra HCL mà một lệnh terraform apply ở khâu sau sẽ chạy.
Các tệp
aggregate.yaml— ý định của nhà phát triển: một componentdbcó kiểucore/datastore/mariadb, với một tên cơ sở dữ liệu logic. Không có gì về đích cloud nằm ở đây.release.yaml— định cỡ của người vận hành: phiên bản engine, dung lượng lưu trữ và HA cho ranh giớiinfra. Mục của nó chodbliên kết slotroot_passwordbắt buộc của Component vớicore/generated-secret— Feature thông tin xác thực cho biết engine sở hữu thông tin xác thực (xem bên dưới) — và đính kèmcore/backup, thứ đặt thời gian instance giữ các bản sao lưu của nó.manifest.yaml— liên kết kiểu component MariaDB với Recipe Terraformterraform/mariadb-rds, 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..aggrega-config.yaml— chỉ định registry của hub mà các thực thể catalog được phân giải từ đó.
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-rdsSau đó 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-rdsBuild
aggrega build --release release.yaml --auto-pull--auto-pull ghi trong lúc build tệp khóa mà một bản clone mới còn thiếu. Tệp main.tf được render nằm dưới dist/infra/terraform/modules/db/, cùng với cấu hình gốc của ranh giới, aggrega.modules.tf, tại dist/infra/terraform/ khai báo db là một khối module trỏ tới nó. Phần thân mở đầu bằng một khối nguồn gốc dạng chú thích # xác định bản build, tiếp theo là một khối required_providers ràng buộc phiên bản provider AWS, tài nguyên aws_db_instance đã được phân giải — các giá trị lưu trữ và HA được thay thế từ Release, thời gian giữ bản sao lưu do đính kèm core/backup đặt, và thông tin xác thực do RDS quản lý qua manage_master_user_password — và một output address mang hostname của instance, mà Recipe công bố là host dưới dạng ${module.db.address}.
Khối module đó không mang đối số nào, và lý do nằm ở dạng của ví dụ
này. Recipe đã viết phần thân, nên nó thay thế trực tiếp các giá trị của Release
vào tài nguyên; module không khai báo khối variable nào và không còn gì
để trình biên dịch truyền vào:
module "db" { source = "./modules/db"}Một Recipe thay vào đó vendor một module — ví dụ
terraform-rds-module — để các đầu vào đó
không được khai báo trong phần thân, nên trình biên dịch cung cấp chúng làm đối số của khối này.
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 workspace chưa có thư mục `terraform-rds`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `terraform-rds` và không có `dir`: nó ghi ví dụ vào một thư mục `terraform-rds` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `terraform-rds`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết bản build đã ghi những tệp nào; chúng nằm dưới `terraform-rds/dist/`.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ì liên kết nó. Một MariaDB tự host cần một mật khẩu được liên kết lúc
viết; một instance RDS được quản lý thì không — RDS tự tạo và xoay vòng
mật khẩu master, và manage_master_user_password trong Recipe này là
thứ bật tính năng đó.
Do đó, người vận hành liên kết slot trong Release, trên mục của nó cho db,
với core/generated-secret, Feature thông tin xác thực mà engine sở hữu
nội dung. 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 việc liên kết thuộc về người vận hành, và Aggregate không
nói gì về nó:
components: db: features: root_password: type: core/generated-secretPhần đính kèm không cấu hình gì vì không có gì để viết, và
FeatureRecipe mà Manifest chọn (terraform/generated-secret) chỉ thuần là kết nối
và không render gì. Vì vậy main.tf được render giống hệt từng byte so với
khi không có phần đính kèm nào: slot đã được liên kết, và không có artifact nào được xuất cho
nó.
Lưu ý rằng tham chiếu FeatureRecipe của Manifest có định danh provider
(terraform/generated-secret:1.0.0). Một tên recipe trần chỉ phân giải được khi
đúng một provider mang 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
generated-secret:1.0.0 hoàn toàn không phân giải được, và bản build dừng lại một cách rõ ràng
thay vì âm thầm chọn một provider cho bạn.
Sao lưu trên một đích được quản lý
RDS tự sao lưu instance, giữ mỗi bản sao lưu tự động trong 7 ngày khi không có gì quy định khác. Người vận hành thay đổi điều đó bằng cách đính kèm core/backup trong Release, bên cạnh thông tin xác thực:
backup: type: core/backup infra: retention_days: 14Manifest gắn Feature với terraform/backup-native, vốn tự nó không kết xuất gì: sao lưu là một thiết lập của instance, nên Recipe đọc đính kèm và ghi nó vào tài nguyên mà nó vốn đã kết xuất. Phần sao lưu của aws_db_instance trong main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14Một infra.schedule như 30 2 * * * cũng sẽ đặt backup_window của instance thành 02:30-03:00, đọc theo UTC; khi bỏ trống, như ở đây, RDS chọn khung giờ. Một giá trị mà RDS không thể giữ — thời gian giữ trên 35 ngày, một lịch khác với một thời điểm mỗi ngày — sẽ dừng bản build, nêu tên đính kèm.