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

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.tf di root boundary — konfigurasi root, yang mendeklarasikan db sebagai blok module dengan source berupa ./modules/db dan 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.tf di 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 komponen db bertipe core/datastore/mariadb.
  • release.yaml — penentuan ukuran oleh operator untuk boundary infra. Entrinya untuk db mengikat slot wajib root_password milik Component dengan core/generated-secret (lihat di bawah), dan melampirkan core/backup untuk menyimpan setiap backup otomatis instans selama 14 hari — yaitu backup_retention_period di atas; tanpa lampiran, instans menyimpannya selama 7 hari.
  • manifest.yaml — mengikat tipe komponen MariaDB ke Recipe Terraform terraform/mariadb-rds-module, yang mengambil modulnya secara lokal, tipe Feature kredensial ke terraform/generated-secret, dan tipe Feature backup ke terraform/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:

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

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

Terminal window
cd terraform-rds-module

Build

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