Terraform RDS (vendor edilmiş modül)
terraform-rds örneğiyle aynı MariaDB amacı, Terraform sağlayıcısının kaynaklı biçimiyle işlenir: satır içi bir HCL gövdesi yerine Recipe yerel bir Terraform modülünü gösterir ve derleyici bu modülü olduğu gibi vendor eder, ardından girdi değişkenlerini geliştirici ve operatör sütunlarından sağlar.
Derleyicinin ürettikleri
Derleme, dist/infra/terraform/ altında sınırın kök yapılandırmasını, dist/infra/terraform/modules/db/ altında ise db bileşeninin kendi dosyalarını üretir:
- Sınır kökündeki
aggrega.modules.tf— kök yapılandırma;db’yi,sourcedeğeri./modules/dbolan ve argümanları modülün girdi değişkenleri olan birmodulebloğu olarak, deterministik anahtar sırasıyla bildirir. Her terraform sınırı bir tane alır ve bir sınırın bileşenlerini tek bir Terraform yapılandırmasına koyan budur; - bayt bayt kopyalanan modül dosyaları (
variables.tf,main.tf; modül yazarının yazdığı her${...}ara değerlemesi dahil); - bu dosyaların yanındaki
aggrega.provenance.tf— derlemeyi tanımlayan,#yorumlarından oluşan bir dosya.
Bu örneğin ürettiği db bloğu:
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"}Bu argümanlardan ikisini yazıldıkları yere kadar izlemeye değer. subnet_id, Release’in infra.overrides altında sağladığı DB alt ağ grubu adıdır — grup bu dağıtımın dışında işletilir, adı ortama göre değişir ve modülün kendi bildirimi varsayılan değer taşımaz; bu yüzden Recipe bunu zorunlu kılar ve değer eksik olduğunda derleme yanlış ağa karşı plan yapmak yerine açıkça durur. instance_class aynı sütundan gelir ancak Recipe’de bir varsayılan değer taşır; böylece hiçbir şey belirtmeyen bir Release db.t3.small alır.
Bir Recipe bu argümanlara ne eşlerse eşlesin, derleyici onu dokunmadan aktarır ve asla çözümlemez — bir Terraform ${...} işaretçisi de buna dahildir. Konuma göre değişen, o işaretçinin nereye düştüğüdür: modül argümanı Terraform’un değerlendirdiği konumlardan biridir, bu yüzden oraya yazılan bir işaretçi modüle düz bir dize olarak ulaşmak yerine plan zamanında kök yapılandırmaya karşı çözümlenir. Yine de o yapılandırmanın bildirdiği bir şeyi adlandırması gerekir.
Girdiler kökte belirtildiği için modules/db/ tek başına, dağıtıldığı hâliyle plan yapabileceğiniz bir yapılandırma değildir — denerseniz motorun ne yaptığı için Terraform sağlayıcı sayfasına bakın.
Dosyalar
aggregate.yaml— geliştirici amacı:core/datastore/mariadbtüründe tek birdbbileşeni.release.yaml—infrasınırı için operatör boyutlandırması.dbgirdisi, Component’in zorunluroot_passwordyuvasınıcore/generated-secretile bağlar (aşağıya bakın) ve örneğin otomatik yedeklerinin her birini 14 gün tutmak içincore/backupekler — yukarıdakibackup_retention_period; ek olmadığında örnek bunları 7 gün tutar.manifest.yaml— MariaDB bileşen türünü, modülünü yerelden alanterraform/mariadb-rds-moduleTerraform Recipe’ine, kimlik bilgisi Feature türünüterraform/generated-secret’e, yedekleme Feature türünü de hiçbir şey işlemeyenterraform/backup-native’e bağlar: Recipe eki okur ve modülün yedekleme girdilerini kendisi sağlar..aggrega-config.yaml— katalog varlıklarının çözümlendiği hub kayıt defterini adlandırır.
Yönetilen bir hedefteki kimlik bilgisi yuvası
core/datastore/mariadb, root_password’ü zorunlu bir yuva olarak bildirir: hiçbir şey onu bağlamadığı sürece derleme durur. RDS ana parolayı kendisi üretir ve döndürür; bu Recipe’in kopyaladığı vendor edilmiş modül de bunu etkinleştirmek için manage_master_user_password’ü ayarlar — bu yüzden yuva, yazılmış bir değerle doldurulmak yerine motora devredilir.
Kimlik bilgisinin motora ait olup olmadığı Manifest’in seçtiği Recipe’ten çıkar; bu yüzden yuvayı operatör, Release’te, db girdisinde bağlar. Onu, yazılacak bir şey olmadığı için hiçbir şey yapılandırmayan ve FeatureRecipe’i (terraform/generated-secret) hiçbir şey işlemeyen saf bir bağlantı olan core/generated-secret ile bağlar. Vendor edilmiş modül ve kök yapılandırma, hiç ek olmasaydı nasıl olacaklarsa bayt bayt öyle çıkar. Manifest’in referansı sağlayıcı nitelikli yazılır, çünkü yalın bir recipe adı yalnızca onu tam olarak bir sağlayıcı taşıdığında çözümlenir ve standart kütüphane birden fazla sağlayıcı altında bir generated-secret FeatureRecipe’i sunar — bu yüzden yalın bir ad hiç çözümlenmez ve derleme sizin yerinize sessizce bir sağlayıcı seçmek yerine açıkça durur.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example terraform-rds-moduleArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd terraform-rds-moduleDerleme
aggrega build --release release.yaml --auto-pull--auto-pull, yeni bir klonda bulunmayan lockfile’ı derleme sırasında yazar.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `terraform-rds-module` klasörü yoksa `scaffold` aracını `example` değeri `terraform-rds-module` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `terraform-rds-module` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `terraform-rds-module`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `terraform-rds-module/dist/` altındadır.