Terraform RDS (mitgeliefertes Modul)
Dieselbe MariaDB-Absicht wie im Beispiel terraform-rds, gerendert über die sourced-Form des Terraform-Providers: Statt eines Inline-HCL-Körpers verweist das Recipe auf ein lokales Terraform-Modul, und der Compiler übernimmt es unverändert und liefert dann seine Eingabevariablen aus den Säulen des Entwicklers und des Betreibers.
Was der Compiler ausgibt
Unter dist/infra/terraform/ erzeugt der Build die Root-Konfiguration der Boundary und unter dist/infra/terraform/modules/db/ die eigenen Dateien der Komponente db:
aggrega.modules.tfan der Root der Boundary — die Root-Konfiguration, diedbals Blockmoduledeklariert, dessensource./modules/dbist und dessen Argumente die Eingabevariablen des Moduls sind, in deterministischer Schlüsselreihenfolge. Jede Boundary vom Typ terraform erhält eine, und sie ist es, die die Komponenten einer Boundary in eine einzige Terraform-Konfiguration bringt;- die Moduldateien, Byte für Byte kopiert (
variables.tf,main.tf, einschließlich jeder Interpolation${...}, die der Modulautor geschrieben hat); aggrega.provenance.tfneben diesen Dateien — eine Datei mit Kommentaren in#, die den Build identifiziert.
Der Block db, den dieses Beispiel ausgibt:
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"}Zwei dieser Argumente lohnt es sich bis dorthin zurückzuverfolgen, wo sie verfasst wurden. subnet_id ist der Name der DB-Subnetzgruppe, den das Release unter infra.overrides liefert — die Gruppe wird außerhalb dieses Release betrieben, ihr Name unterscheidet sich je Umgebung, und die eigene Deklaration des Moduls trägt keinen Standardwert, daher fordert das Recipe ihn ein, und der Build bricht deutlich sichtbar ab, wenn er fehlt, statt gegen das falsche Netzwerk zu planen. instance_class stammt aus derselben Säule, trägt aber im Recipe einen Standardwert, sodass ein Release, das nichts angibt, db.t3.small erhält.
Was auch immer ein Recipe in diese Argumente abbildet, leitet der Compiler unverändert weiter und löst es nie auf — einen Terraform-Zeiger ${...} eingeschlossen. Was sich mit der Position ändert, ist, wo dieser Zeiger landet: Ein Modulargument ist eine der Positionen, die Terraform auswertet, daher wird ein dort geschriebener Zeiger zur Planzeit gegen die Root-Konfiguration aufgelöst, statt das Modul als literale Zeichenkette zu erreichen. Er muss trotzdem etwas benennen, das diese Konfiguration deklariert.
Weil die Eingaben in der Root angegeben werden, ist modules/db/ für sich allein keine Konfiguration, die Sie wie bereitgestellt planen können — siehe die Seite zum Terraform-Provider dazu, was die Engine tut, wenn Sie es versuchen.
Dateien
aggregate.yaml— Entwicklerabsicht: eine Komponentedbvom Typcore/datastore/mariadb.release.yaml— Dimensionierung durch den Operator für die Boundaryinfra. Der Eintrag fürdbdarin bindet den erforderlichen Slotroot_passwordder Component mitcore/generated-secret(siehe unten) und bindetcore/backupan, um jedes automatische Backup der Instanz 14 Tage lang aufzubewahren — das obigebackup_retention_period; ohne Anbindung bewahrt die Instanz sie 7 Tage auf.manifest.yaml— bindet den MariaDB-Komponententyp an das Terraform-Recipeterraform/mariadb-rds-module, das sein Modul aus einer lokalen Quelle bezieht, den Feature-Typ für Zugangsdaten anterraform/generated-secretund den Feature-Typ für Backups anterraform/backup-native, das nichts rendert: Das Recipe liest die Anbindung und liefert die Backup-Eingaben des Moduls selbst..aggrega-config.yaml— nennt die Hub-Registry, aus der die Katalogentitäten aufgelöst werden.
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. RDS erzeugt und rotiert das Master-Passwort selbst, und das mitgelieferte Modul, das dieses Recipe kopiert, setzt manage_master_user_password, um das einzuschalten — daher wird der Slot an die Engine delegiert, statt mit einem verfassten Wert gefüllt zu werden.
Ob die Engine die Zugangsdaten besitzt, ergibt sich aus dem Recipe, das das Manifest wählt, daher bindet der Operator den Slot, im Release, in dessen Eintrag für db. Er bindet ihn mit core/generated-secret, das nichts konfiguriert, weil es nichts zu verfassen gibt, und dessen FeatureRecipe (terraform/generated-secret) reine Verdrahtung ist, die nichts rendert. Das mitgelieferte Modul und die Root-Konfiguration entstehen Byte für Byte so, wie sie ganz ohne Anbindung wären. Die Referenz des Manifests ist Provider-qualifiziert, weil ein unqualifizierter Rezeptname nur aufgelöst wird, wenn genau ein Provider ihn trägt, und die Standardbibliothek ein FeatureRecipe generated-secret unter mehr als einem ausliefert — daher wird ein unqualifizierter Name überhaupt nicht aufgelöst, und der Build bricht deutlich sichtbar ab, statt stillschweigend einen Provider für Sie auszuwählen.
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-rds-moduleDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd terraform-rds-moduleBuild
aggrega build --release release.yaml --auto-pull--auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt.
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 ausschließlich die Aggrega-Werkzeuge und legen Sie selbst keinen Ordner an. Wenn der Ordner des Arbeitsbereichs noch keinen Ordner `terraform-rds-module` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `terraform-rds-module` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `terraform-rds-module`. Rufen Sie dann das Werkzeug `build` auf, mit `workspace_root` auf `terraform-rds-module`, `release` auf `release.yaml`, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die der Build geschrieben hat; sie liegen unter `terraform-rds-module/dist/`.