Terraform RDS (artefak HCL inline)
Satu basis data MariaDB yang ditulis sekali sebagai maksud pengembang dan dirender menjadi berkas HCL Terraform yang menyediakan instans AWS RDS terkelola.
Contoh ini memperlihatkan bentuk artefak dari provider Terraform:
Recipe membawa isi main.tf inline di bawah artifacts:, dan compiler
mengeluarkan isi tersebut apa adanya setelah menyelesaikan ekspresi templatnya. Provider
tidak pernah menjalankan terraform; provider menghasilkan HCL yang dijalankan oleh terraform apply di hilir.
Berkas
aggregate.yaml— maksud pengembang: satu komponendbbertipecore/datastore/mariadb, dengan nama basis data logis. Tidak ada informasi tentang target cloud di sini.release.yaml— ukuran dari operator: versi engine, penyimpanan, dan HA untuk batasinfra. Entrinya untukdbmengikat slot wajibroot_passwordmilik Component dengancore/generated-secret— Feature kredensial yang menyatakan bahwa engine memiliki kredensial tersebut (lihat di bawah) — dan melampirkancore/backup, yang menetapkan berapa lama instans menyimpan backup-nya.manifest.yaml— mengikat tipe komponen MariaDB ke Recipe Terraformterraform/mariadb-rds, tipe Feature kredensial keterraform/generated-secret, dan tipe Feature backup keterraform/backup-native..aggrega-config.yaml— menyebut registri hub tempat entitas katalog di-resolve.
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-rdsKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd terraform-rdsBuild
aggrega build --release release.yaml --auto-pull--auto-pull menulis lockfile yang tidak dimiliki klon baru selama build. main.tf yang dirender ditempatkan di bawah dist/infra/terraform/modules/db/, dengan konfigurasi root batas tersebut, aggrega.modules.tf, di dist/infra/terraform/ yang mendeklarasikan db sebagai blok module yang menunjuk ke sana. Isinya dibuka dengan blok provenans berupa komentar # yang mengidentifikasi build, diikuti oleh blok required_providers yang membatasi versi provider AWS, resource aws_db_instance yang telah diselesaikan — nilai penyimpanan dan HA disubstitusikan dari Release, retensi backup ditetapkan oleh lampiran core/backup, serta kredensial yang dikelola RDS melalui manage_master_user_password — dan output address yang membawa hostname instans, yang dipublikasikan oleh Recipe sebagai host dalam bentuk ${module.db.address}.
Blok module tersebut tidak membawa argumen, dan alasannya adalah bentuk
contoh ini. Recipe menulis isinya, sehingga Recipe menyubstitusikan nilai-nilai Release
langsung ke dalam resource; modul tidak mendeklarasikan blok variable dan tidak ada
yang tersisa untuk diteruskan oleh compiler:
module "db" { source = "./modules/db"}Recipe yang sebaliknya menyertakan sebuah modul — contoh
terraform-rds-module — membiarkan input tersebut
tidak dideklarasikan di dalam isinya, sehingga compiler menyediakannya sebagai argumen blok ini.
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 workspace belum berisi folder `terraform-rds`, panggil alat `scaffold` sekali dengan `example` diatur ke `terraform-rds` dan tanpa `dir`: alat ini menulis contoh ke folder `terraform-rds` baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `terraform-rds`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis build; file tersebut berada di bawah `terraform-rds/dist/`.Slot kredensial pada target terkelola
core/datastore/mariadb mendeklarasikan root_password sebagai slot wajib: build
berhenti selama tidak ada yang mengikatnya. MariaDB yang di-host sendiri memerlukan kata sandi yang diikat pada
saat penulisan; instans RDS terkelola tidak — RDS sendiri yang membuat dan merotasi
kata sandi master, dan manage_master_user_password dalam Recipe ini adalah
yang mengaktifkannya.
Karena itu, operator mengikat slot tersebut di Release, pada entrinya untuk db,
dengan core/generated-secret, Feature kredensial yang materialnya dimiliki oleh engine.
Apakah engine memiliki kredensial tersebut bergantung pada Recipe yang dipilih
Manifest, sehingga pengikatan itu adalah wewenang operator, dan Aggregate tidak
menyatakan apa pun tentangnya:
components: db: features: root_password: type: core/generated-secretLampiran tersebut tidak mengonfigurasi apa pun karena tidak ada yang perlu ditulis, dan
FeatureRecipe yang dipilih Manifest (terraform/generated-secret) murni berupa penyambungan
yang tidak merender apa pun. Jadi, main.tf yang dirender sama persis byte demi byte dengan hasilnya
jika tanpa lampiran sama sekali: slot terikat, dan tidak ada artefak yang dikeluarkan untuknya.
Perhatikan bahwa referensi FeatureRecipe pada Manifest dikualifikasi dengan provider
(terraform/generated-secret:1.0.0). Nama recipe tanpa kualifikasi hanya dapat diselesaikan jika
tepat satu provider membawanya, dan pustaka standar menyertakan FeatureRecipe
generated-secret di bawah lebih dari satu provider — sehingga
generated-secret:1.0.0 tanpa kualifikasi sama sekali tidak dapat diselesaikan, dan build berhenti dengan jelas
alih-alih diam-diam memilihkan provider untuk Anda.
Backup pada target terkelola
RDS mem-backup instans sendiri, menyimpan setiap backup otomatis selama 7 hari jika tidak ada yang menyatakan lain. Operator mengubahnya dengan melampirkan core/backup di Release, di samping kredensial:
backup: type: core/backup infra: retention_days: 14Manifest mengikat Feature tersebut ke terraform/backup-native, yang tidak merender apa pun sendiri: backup adalah pengaturan instans, sehingga Recipe membaca lampiran dan menuliskannya ke resource yang sudah direndernya. Bagian backup dari aws_db_instance di main.tf:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 14infra.schedule seperti 30 2 * * * juga akan menetapkan backup_window instans menjadi 02:30-03:00, dibaca dalam UTC; jika dihilangkan, seperti di sini, RDS memilih jendelanya. Nilai yang tidak dapat dipertahankan RDS — retensi di atas 35 hari, jadwal selain satu waktu setiap hari — menghentikan build dengan menyebut lampirannya.