Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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 komponen db bertipe core/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 batas infra. Entrinya untuk db mengikat slot wajib root_password milik Component dengan core/generated-secret — Feature kredensial yang menyatakan bahwa engine memiliki kredensial tersebut (lihat di bawah) — dan melampirkan core/backup, yang menetapkan berapa lama instans menyimpan backup-nya.
  • manifest.yaml — mengikat tipe komponen MariaDB ke Recipe Terraform terraform/mariadb-rds, tipe Feature kredensial ke terraform/generated-secret, dan tipe Feature backup ke terraform/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:

Terminal window
aggrega scaffold --example terraform-rds

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd terraform-rds

Build

Terminal window
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-secret

Lampiran 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: 14

Manifest 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 = 14

infra.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.