Terraform RDS (Inline-HCL-Artefakt)
Eine einzelne MariaDB-Datenbank, einmal als Entwicklerabsicht verfasst und zu einer Terraform-HCL-Datei gerendert, die eine verwaltete AWS-RDS-Instanz bereitstellt.
Dieses Beispiel zeigt die artifact-Form des Terraform-Providers: Das Recipe trägt einen Inline-Körper main.tf unter artifacts:, und der Compiler gibt diesen Körper unverändert aus, nachdem er seine Template-Ausdrücke aufgelöst hat. Der Provider führt nie terraform aus; er erzeugt das HCL, das ein nachgelagertes terraform apply ausführt.
Dateien
aggregate.yaml— Entwicklerabsicht: eine Komponentedbvom Typcore/datastore/mariadb, mit einem logischen Datenbanknamen. Nichts über das Cloud-Ziel steht hier.release.yaml— Dimensionierung durch den Operator: Engine-Version, Speicher und HA für die Boundaryinfra. Der Eintrag fürdbdarin bindet den erforderlichen Slotroot_passwordder Component mitcore/generated-secret— dem Feature für Zugangsdaten, das besagt, dass die Engine die Zugangsdaten besitzt (siehe unten) — und bindetcore/backupan, das festlegt, wie lange die Instanz ihre Backups aufbewahrt.manifest.yaml— bindet den MariaDB-Komponententyp an das Terraform-Recipeterraform/mariadb-rds, den Feature-Typ für Zugangsdaten anterraform/generated-secretund den Feature-Typ für Backups anterraform/backup-native..aggrega-config.yaml— nennt die Hub-Registry, aus der die Katalogentitäten aufgelöst werden.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example terraform-rdsDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd terraform-rdsBuild
aggrega build --release release.yaml --auto-pull--auto-pull schreibt während des Builds die Lockfile, die einem frischen Klon fehlt. Das gerenderte main.tf landet unter dist/infra/terraform/modules/db/, wobei die Root-Konfiguration der Boundary, aggrega.modules.tf, unter dist/infra/terraform/ db als Block module deklariert, der darauf zeigt. Der Körper beginnt mit einem Herkunftsblock aus Kommentaren in #, der den Build identifiziert, gefolgt von einem Block required_providers, der die Version des AWS-Providers einschränkt, der aufgelösten Ressource aws_db_instance — Speicher- und HA-Werte aus dem Release eingesetzt, die Backup-Aufbewahrung, die die Anbindung core/backup festlegt, und von RDS verwaltete Zugangsdaten über manage_master_user_password — und einer Ausgabe address, die den Hostnamen der Instanz trägt und die das Recipe als host in der Form ${module.db.address} veröffentlicht.
Dieser Block module trägt keine Argumente, und der Grund ist die Form dieses Beispiels. Das Recipe hat den Körper verfasst, also hat es die Werte des Release direkt in die Ressource eingesetzt; das Modul deklariert keine Blöcke variable, und für den Compiler bleibt nichts zu übergeben:
module "db" { source = "./modules/db"}Ein Recipe, das stattdessen ein Modul mitliefert — das Beispiel terraform-rds-module — lässt diese Eingaben im Körper undeklariert, sodass der Compiler sie als Argumente dieses Blocks liefert.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie nur die Aggrega-Werkzeuge, und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `terraform-rds` enthält, rufen Sie das Werkzeug `scaffold` einmal mit `example` auf `terraform-rds` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `terraform-rds`. Rufen Sie dann das Werkzeug `build` mit `workspace_root` auf `terraform-rds`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt auf. Sagen Sie mir, welche Dateien der Build geschrieben hat; sie liegen unter `terraform-rds/dist/`.Der Slot für Zugangsdaten auf einem verwalteten Ziel
core/datastore/mariadb deklariert root_password als erforderlichen Slot: Ein Build bricht ab, solange nichts ihn bindet. Ein selbst gehostetes MariaDB braucht ein beim Verfassen gebundenes Passwort; eine verwaltete RDS-Instanz nicht — RDS erzeugt und rotiert das Master-Passwort selbst, und manage_master_user_password in diesem Recipe schaltet das ein.
Der Operator bindet den Slot daher im Release, in dessen Eintrag für db, mit core/generated-secret, dem Feature für Zugangsdaten, dessen Material die Engine besitzt. Ob die Engine die Zugangsdaten besitzt, ergibt sich aus dem Recipe, das das Manifest wählt, daher ist die Bindung Sache des Operators, und das Aggregate sagt nichts darüber:
components: db: features: root_password: type: core/generated-secretDie Anbindung konfiguriert nichts, weil es nichts zu verfassen gibt, und das FeatureRecipe, das das Manifest auswählt (terraform/generated-secret), ist reine Verdrahtung, die nichts rendert. Daher ist das gerenderte main.tf Byte für Byte so, wie es ganz ohne Anbindung wäre: Der Slot ist gebunden, und für ihn wird kein Artefakt ausgegeben.
Beachten Sie, dass die FeatureRecipe-Referenz des Manifests Provider-qualifiziert ist (terraform/generated-secret:1.0.0). Ein unqualifizierter Rezeptname wird nur aufgelöst, wenn genau ein Provider ihn trägt, und die Standardbibliothek liefert ein FeatureRecipe generated-secret unter mehr als einem aus — daher wird ein unqualifiziertes generated-secret:1.0.0 überhaupt nicht aufgelöst, und der Build bricht deutlich sichtbar ab, statt stillschweigend einen Provider für Sie auszuwählen.
Backup auf einem verwalteten Ziel
RDS sichert die Instanz selbst und bewahrt jedes automatische Backup 7 Tage lang auf, wenn nichts anderes angegeben ist. Der Operator ändert das, indem er im Release core/backup anbindet, neben den Zugangsdaten:
backup: type: core/backup infra: retention_days: 14Das Manifest bindet das Feature an terraform/backup-native, das nichts Eigenes rendert: Das Backup ist eine Einstellung der Instanz, daher liest das Recipe die Anbindung und schreibt sie in die Ressource, die es bereits rendert. Der Backup-Abschnitt von aws_db_instance in main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14Ein infra.schedule wie 30 2 * * * würde außerdem das backup_window der Instanz auf 02:30-03:00 setzen, gelesen in UTC; fehlt es, wie hier, wählt RDS das Zeitfenster. Ein Wert, den RDS nicht einhalten kann — eine Aufbewahrung über 35 Tage, ein Zeitplan, der nicht eine Uhrzeit an jedem Tag ist —, bricht den Build ab und benennt die Anbindung.