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 (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 component db có kiểu core/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ới infra. Mục của nó cho db liên kết slot root_password bắt buộc của Component với core/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èm core/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 Terraform terraform/mariadb-rds, 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.
  • .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ó:

Terminal window
aggrega scaffold --example terraform-rds

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

Build

Terminal window
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-secret

Phầ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: 14

Manifest 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 = 14

Mộ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.