Terraform RDS (satır içi HCL yapıtı)
Geliştirici niyeti olarak bir kez yazılan ve yönetilen bir AWS RDS örneği sağlayan bir Terraform HCL dosyasına dönüştürülen tek bir MariaDB veritabanı.
Bu örnek, Terraform sağlayıcısının yapıt biçimini gösterir: Recipe, artifacts: altında satır içi bir main.tf gövdesi taşır ve derleyici, şablon ifadelerini çözümledikten sonra bu gövdeyi olduğu gibi üretir. Sağlayıcı hiçbir zaman terraform çalıştırmaz; sonraki aşamadaki bir terraform apply komutunun çalıştıracağı HCL’i üretir.
Dosyalar
aggregate.yaml— geliştirici niyeti: mantıksal bir veritabanı adıylacore/datastore/mariadbtüründe tek birdbbileşeni. Bulut hedefiyle ilgili hiçbir şey burada yer almaz.release.yaml— operatör boyutlandırması:infrasınırı için motor sürümü, depolama ve yüksek erişilebilirlik.dbgirdisi, Component’in zorunluroot_passwordyuvasınıcore/generated-secretile bağlar — kimlik bilgisinin sahibinin motor olduğunu belirten kimlik bilgisi Feature’ı (aşağıya bakın) — ve örneğin yedeklerini ne kadar süre tutacağını belirleyencore/backup’ı ekler.manifest.yaml— MariaDB bileşen türünüterraform/mariadb-rdsTerraform Recipe’ine, kimlik bilgisi Feature türünüterraform/generated-secret’e, yedekleme Feature türünü iseterraform/backup-native’e bağlar..aggrega-config.yaml— katalog varlıklarının çözümlendiği hub kayıt defterini adlandırır.
Ö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-rdsArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd terraform-rdsDerleme
aggrega build --release release.yaml --auto-pull--auto-pull, yeni bir klonda bulunmayan kilit dosyasını derleme sırasında yazar. Oluşturulan main.tf, dist/infra/terraform/modules/db/ altına yerleşir; sınırın kök yapılandırması olan aggrega.modules.tf ise dist/infra/terraform/ konumunda bulunur ve db’yi ona işaret eden bir module bloğu olarak bildirir. Gövde, derlemeyi tanımlayan # yorumlarından oluşan bir köken bloğuyla açılır; ardından AWS sağlayıcı sürümünü kısıtlayan bir required_providers bloğu, çözümlenmiş aws_db_instance kaynağı (depolama ve yüksek erişilebilirlik değerleri Release’ten yerleştirilmiş, yedek saklama süresi core/backup ekiyle belirlenmiş, kimlik bilgileri manage_master_user_password aracılığıyla RDS tarafından yönetilir) ve örneğin ana bilgisayar adını taşıyan bir address çıktısı gelir; Recipe bu çıktıyı ${module.db.address} biçiminde host olarak yayımlar.
Bu module bloğu hiçbir argüman taşımaz ve bunun nedeni bu örneğin biçimidir. Gövdeyi Recipe yazdığı için Release’in değerlerini doğrudan kaynağa yerleştirmiştir; modül hiçbir variable bloğu bildirmez ve derleyicinin aktaracağı hiçbir şey kalmaz:
module "db" { source = "./modules/db"}Bunun yerine bir modülü bünyesine alan bir Recipe (terraform-rds-module örneği) bu girdileri gövdede bildirilmemiş bırakır; böylece derleyici onları bu bloğun argümanları olarak sağlar.
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` klasörü yoksa `scaffold` aracını, `example` değeri `terraform-rds` olarak ayarlanmış ve `dir` verilmeden bir kez çağırın: araç örneği yeni bir `terraform-rds` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `terraform-rds`, `release` değeri `release.yaml`, `auto_pull` değeri true ve `write` değeri true olarak ayarlanmış şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `terraform-rds/dist/` altındadı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. Kendi barındırılan bir MariaDB, yazım sırasında bağlanmış bir parola gerektirir; yönetilen bir RDS örneği ise gerektirmez: RDS ana parolayı kendisi oluşturur ve döndürür, bunu bu Recipe’te etkinleştiren de manage_master_user_password’dür.
Bu nedenle operatör yuvayı Release’te, db girdisinde, malzemesinin sahibi motor olan kimlik bilgisi Feature’ı core/generated-secret ile bağlar. Kimlik bilgisinin sahibinin motor olup olmadığı Manifest’in seçtiği Recipe’ten kaynaklanır; dolayısıyla bağlama operatöre aittir ve Aggregate bu konuda hiçbir şey söylemez:
components: db: features: root_password: type: core/generated-secretEk hiçbir şeyi yapılandırmaz, çünkü yazılacak bir şey yoktur; Manifest’in seçtiği FeatureRecipe (terraform/generated-secret) ise hiçbir şey oluşturmayan salt bir bağlantıdır. Bu yüzden oluşturulan main.tf, hiç ek olmasaydı nasıl olacaksa bayt bayt öyledir: yuva bağlanmıştır ve onun için hiçbir yapıt üretilmez.
Manifest’in FeatureRecipe başvurusunun sağlayıcıyla nitelendirildiğine dikkat edin (terraform/generated-secret:1.0.0). Yalın bir tarif adı yalnızca onu tam olarak bir sağlayıcı taşıdığında çözümlenir ve standart kütüphane generated-secret FeatureRecipe’ini birden fazla sağlayıcı altında sunar; bu nedenle yalın bir generated-secret:1.0.0 hiç çözümlenmez ve derleme, sizin yerinize sessizce bir sağlayıcı seçmek yerine açıkça durur.
Yönetilen bir hedefte yedekleme
RDS örneği kendisi yedekler ve aksi belirtilmedikçe her otomatik yedeği 7 gün tutar. Operatör bunu Release’te, kimlik bilgisinin yanına core/backup ekleyerek değiştirir:
backup: type: core/backup infra: retention_days: 14Manifest, Feature’ı kendi başına hiçbir şey işlemeyen terraform/backup-native’e bağlar: yedekleme örneğin bir ayarıdır; bu nedenle Recipe eki okur ve zaten işlediği kaynağa yazar. main.tf içindeki aws_db_instance’ın yedekleme bölümü:
## ── Backup ─────────────────────────────────────────────── backup_retention_period = 1430 2 * * * gibi bir infra.schedule, örneğin backup_window değerini de UTC olarak okunan 02:30-03:00 yapar; burada olduğu gibi belirtilmezse pencereyi RDS seçer. RDS’in tutamayacağı bir değer — 35 günün üzerinde bir saklama süresi, her günün tek bir saati dışında bir zamanlama — eki adlandırarak derlemeyi durdurur.