Terraform RDS(内联 HCL 制品)
单个 MariaDB 数据库,以开发者意图编写一次,渲染为一个 Terraform HCL 文件,用于预置托管的 AWS RDS 实例。
本示例展示 Terraform provider 的制品形态:
Recipe 在 artifacts: 下携带内联的 main.tf 主体,编译器
在解析其中的模板表达式后原样输出该主体。该 provider
从不运行 terraform;它生成供下游 terraform apply 运行的 HCL。
文件
aggregate.yaml— 开发者意图:一个类型为core/datastore/mariadb的dbcomponent,带有逻辑数据库名。这里 不包含任何关于云目标的内容。release.yaml— 运维规格:infra边界的引擎版本、存储和高可用。其中db的条目用core/generated-secret绑定该 Component 必需的root_password槽位——这个凭据 Feature 表示凭据由引擎拥有(见下文)——并附加core/backup,它设定实例保留其备份的时长。manifest.yaml— 将 MariaDB component 类型绑定到 Terraform Recipeterraform/mariadb-rds,将凭据 Feature 类型绑定到terraform/generated-secret,并将备份 Feature 类型绑定到terraform/backup-native。.aggrega-config.yaml— 指定目录实体从中解析的 hub 注册表。
生成示例
你可以用下面的命令构建这个示例,也可以让你的 AI 助手替你构建。
将示例写入一个以其命名的新文件夹:
aggrega scaffold --example terraform-rds然后它会打印接下来要运行的命令。第一条命令进入新文件夹:
cd terraform-rds构建
aggrega build --release release.yaml --auto-pull--auto-pull 会在构建期间写入全新克隆所缺少的锁文件。渲染出的 main.tf 位于 dist/infra/terraform/modules/db/ 下,边界的根配置 aggrega.modules.tf 位于 dist/infra/terraform/,它将 db 声明为指向该目录的 module 块。主体开头是一个标识本次构建的 # 注释来源块,随后是约束 AWS provider 版本的 required_providers 块、解析后的 aws_db_instance 资源——其中存储和高可用值取自该 Release,备份保留期由 core/backup 附加项设定,并通过 manage_master_user_password 使用 RDS 托管的凭据——以及一个携带实例主机名的 address 输出,Recipe 将其以 ${module.db.address} 的形式发布为 host。
该 module 块不带任何参数,原因在于本示例的形态。
Recipe 编写了主体,因此它将 Release 的值直接代入资源;
该模块未声明任何 variable 块,编译器也就没有需要传入的内容:
module "db" { source = "./modules/db"}而内置(vendor)一个模块的 Recipe——即
terraform-rds-module 示例——会在主体中不声明这些输入,
因此由编译器将它们作为该块的参数提供。
借助 AI 助手
已配置 Aggrega 工具的 AI 助手也能完成同样的操作:把下面这条提示粘贴给它。
只使用 Aggrega 工具,不要自行创建任何文件夹。如果工作区文件夹中还没有 `terraform-rds` 文件夹,调用一次 `scaffold` 工具,将 `example` 设为 `terraform-rds`,且不设置 `dir`:它会将示例写入新的 `terraform-rds` 文件夹。然后调用 `build` 工具,将 `workspace_root` 设为 `terraform-rds`,`release` 设为 `release.yaml`,`auto_pull` 设为 true,`write` 设为 true。告诉我构建写入了哪些文件;它们位于 `terraform-rds/dist/` 下。托管目标上的凭据槽位
core/datastore/mariadb 将 root_password 声明为必需槽位:只要没有任何东西绑定它,
构建就会中止。自托管的 MariaDB 需要在编写时绑定密码;托管的 RDS 实例则不需要——RDS 自行生成并轮换
主密码,而本 Recipe 中的 manage_master_user_password 正是
开启这一功能的设置。
因此,运维人员在 Release 中 db 的条目上,
用 core/generated-secret 绑定该槽位,这是一个其内容由引擎拥有的凭据 Feature。
凭据是否由引擎拥有取决于 Manifest 选择的 Recipe,
因此该绑定属于运维人员,Aggregate 对此只字不提:
components: db: features: root_password: type: core/generated-secret该附加项不配置任何内容,因为没有需要编写的内容,而
Manifest 选择的 FeatureRecipe(terraform/generated-secret)只是纯粹的连接,
不渲染任何内容。因此渲染出的 main.tf 与完全没有附加项时逐字节相同:
槽位已绑定,且不会为其输出任何制品。
请注意,Manifest 中的 FeatureRecipe 引用带有 provider 限定
(terraform/generated-secret:1.0.0)。裸 recipe 名称仅在
恰好只有一个 provider 提供它时才能解析,而标准库在不止一个 provider 下
提供了 generated-secret FeatureRecipe——因此裸的
generated-secret:1.0.0 根本无法解析,构建会明确报错中止,
而不是悄悄替你选择一个 provider。
托管目标上的备份
RDS 会自行备份实例,在没有其他设定时,每个自动备份保留 7 天。运维人员通过在 Release 中、凭据旁边附加 core/backup 来更改这一点:
backup: type: core/backup infra: retention_days: 14Manifest 将该 Feature 绑定到 terraform/backup-native,它本身不渲染任何内容:备份是实例的一项设置,因此 Recipe 读取该附加项,并将其写入它已经渲染的资源中。main.tf 中 aws_db_instance 的备份部分:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14诸如 30 2 * * * 的 infra.schedule 还会将实例的 backup_window 设为 02:30-03:00(按 UTC 解读);如此处一样省略时,由 RDS 选择该时间窗口。RDS 无法保持的值——超过 35 天的保留期、除每天某一固定时间以外的计划——会使构建中止,并指出该附加项。