Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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.tf an der Root der Boundary — die Root-Konfiguration, die db als Block module deklariert, dessen source ./modules/db ist 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.tf neben 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 Komponente db vom Typ core/datastore/mariadb.
  • release.yaml — Dimensionierung durch den Operator für die Boundary infra. Der Eintrag für db darin bindet den erforderlichen Slot root_password der Component mit core/generated-secret (siehe unten) und bindet core/backup an, um jedes automatische Backup der Instanz 14 Tage lang aufzubewahren — das obige backup_retention_period; ohne Anbindung bewahrt die Instanz sie 7 Tage auf.
  • manifest.yaml — bindet den MariaDB-Komponententyp an das Terraform-Recipe terraform/mariadb-rds-module, das sein Modul aus einer lokalen Quelle bezieht, den Feature-Typ für Zugangsdaten an terraform/generated-secret und den Feature-Typ für Backups an terraform/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:

Terminal window
aggrega scaffold --example terraform-rds-module

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd terraform-rds-module

Build

Terminal window
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/`.