Terraform RDS (modul yang di-vendor)
Intent MariaDB yang sama dengan contoh terraform-rds, dirender melalui
bentuk bersumber dari provider Terraform: alih-alih badan HCL inline,
Recipe menunjuk ke modul Terraform lokal dan compiler men-vendor-nya apa adanya,
lalu menyediakan variabel inputnya dari pilar developer dan operator.
Apa yang dihasilkan compiler
Di bawah dist/infra/terraform/ build menghasilkan konfigurasi root dari boundary,
dan di bawah dist/infra/terraform/modules/db/ file milik komponen db
itu sendiri:
aggrega.modules.tfdi root boundary — konfigurasi root, yang mendeklarasikandbsebagai blokmoduledengansourceberupa./modules/dbdan dengan argumen berupa variabel input modul, dalam urutan kunci yang deterministik. Setiap boundary terraform mendapatkan satu, dan file inilah yang menempatkan komponen-komponen sebuah boundary dalam satu konfigurasi Terraform;- file modul yang disalin byte demi byte (
variables.tf,main.tf, termasuk setiap interpolasi${...}yang ditulis oleh pembuat modul); aggrega.provenance.tfdi samping file tersebut — file komentar#yang mengidentifikasi build.
Blok db yang dihasilkan contoh ini:
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"}Dua dari argumen tersebut layak ditelusuri kembali ke tempat penulisannya.
subnet_id adalah nama DB subnet group yang disediakan Release di bawah
infra.overrides — grup tersebut dioperasikan di luar deployment ini, namanya
berbeda per lingkungan, dan deklarasi modul itu sendiri tidak memiliki default, sehingga
Recipe menegaskannya dan build berhenti dengan jelas ketika nilainya tidak ada, alih-alih
merencanakan terhadap jaringan yang salah. instance_class berasal dari pilar yang sama
namun memiliki default di Recipe, sehingga Release yang tidak menyatakan apa pun mendapatkan
db.t3.small.
Apa pun yang dipetakan Recipe ke argumen ini akan diteruskan compiler
tanpa diubah dan tidak pernah diresolusi — termasuk pointer Terraform ${...}. Yang
berubah sesuai posisinya adalah tempat pointer itu berakhir: argumen modul adalah salah satu
posisi yang dievaluasi Terraform, sehingga pointer yang ditulis di sana diresolusi terhadap
konfigurasi root pada saat plan, alih-alih mencapai modul sebagai string literal.
Pointer itu tetap harus menamai sesuatu yang dideklarasikan konfigurasi tersebut.
Karena input dinyatakan di root, modules/db/ secara tersendiri bukanlah
konfigurasi yang dapat Anda plan seperti saat di-deploy — lihat
halaman provider Terraform
untuk mengetahui apa yang dilakukan engine jika Anda mencobanya.
Berkas
aggregate.yaml— intent developer: satu komponendbbertipecore/datastore/mariadb.release.yaml— penentuan ukuran oleh operator untuk boundaryinfra. Entrinya untukdbmengikat slot wajibroot_passwordmilik Component dengancore/generated-secret(lihat di bawah), dan melampirkancore/backupuntuk menyimpan setiap backup otomatis instans selama 14 hari — yaitubackup_retention_perioddi atas; tanpa lampiran, instans menyimpannya selama 7 hari.manifest.yaml— mengikat tipe komponen MariaDB ke Recipe Terraformterraform/mariadb-rds-module, yang mengambil modulnya secara lokal, tipe Feature kredensial keterraform/generated-secret, dan tipe Feature backup keterraform/backup-native, yang tidak merender apa pun: Recipe membaca lampiran dan memasok sendiri input backup modul..aggrega-config.yaml— menyebut registri hub tempat entitas katalog di-resolve.
Slot kredensial pada target terkelola
core/datastore/mariadb mendeklarasikan root_password sebagai slot wajib: build
berhenti selama tidak ada yang mengikatnya. RDS membuat dan merotasi kata sandi master
sendiri, dan modul yang di-vendor yang disalin Recipe ini menetapkan
manage_master_user_password untuk mengaktifkannya — sehingga slot tersebut didelegasikan ke
engine alih-alih diisi dengan nilai yang ditulis.
Apakah engine memiliki kredensial tersebut bergantung pada Recipe yang dipilih Manifest,
sehingga operator mengikat slot itu, di Release, pada entrinya untuk db.
Operator mengikatnya dengan core/generated-secret, yang tidak mengonfigurasi apa pun karena
tidak ada yang perlu ditulis, dan yang FeatureRecipe-nya
(terraform/generated-secret) murni berupa pengkabelan yang tidak merender apa pun. Modul yang
di-vendor dan konfigurasi root dihasilkan byte demi byte sama seperti jika
tidak ada lampiran sama sekali. Referensi Manifest dikualifikasi dengan provider karena
nama recipe tanpa kualifikasi hanya diresolusi ketika tepat satu provider memilikinya, dan
pustaka standar menyertakan FeatureRecipe generated-secret di bawah lebih dari satu provider —
sehingga nama tanpa kualifikasi sama sekali tidak diresolusi, dan build berhenti dengan jelas
alih-alih diam-diam memilihkan provider untuk Anda.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example terraform-rds-moduleKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd terraform-rds-moduleBuild
aggrega build --release release.yaml --auto-pull--auto-pull menulis lockfile yang tidak dimiliki oleh clone baru selama build.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `terraform-rds-module`, panggil alat `scaffold` sekali dengan `example` diatur ke `terraform-rds-module` dan tanpa `dir`: alat ini menulis contoh ke folder `terraform-rds-module` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `terraform-rds-module`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `terraform-rds-module/dist/`.