İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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, source değeri ./modules/db olan ve argümanları modülün girdi değişkenleri olan bir module bloğ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/mariadb türünde tek bir db bileşeni.
  • release.yaml — infra sınırı için operatör boyutlandırması. db girdisi, Component’in zorunlu root_password yuvasını core/generated-secret ile bağlar (aşağıya bakın) ve örneğin otomatik yedeklerinin her birini 14 gün tutmak için core/backup ekler — yukarıdaki backup_retention_period; ek olmadığında örnek bunları 7 gün tutar.
  • manifest.yaml — MariaDB bileşen türünü, modülünü yerelden alan terraform/mariadb-rds-module Terraform Recipe’ine, kimlik bilgisi Feature türünü terraform/generated-secret’e, yedekleme Feature türünü de hiçbir şey işlemeyen terraform/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:

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

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd terraform-rds-module

Derleme

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