Terraform Provider
terraform provider’ı, Aggrega Recipes’i Terraform yapılandırmasına dönüştürür. Yapılandırma üretir ve Terraform’u hiçbir zaman çalıştırmaz: bir Aggrega derlemesi önceden (ahead-of-time) yapılan bir derlemedir, bu nedenle yalnızca terraform apply sonrasında var olan kaynak kimliklerini, IP adreslerini ve çıktıları çözümleyemez. Terraform’un ${ ... } ara değer yerleştirmeleri, Terraform çalışma zamanının daha sonra çözümlediği belirlenimci işaretçi dizeleri olarak dokunulmadan aktarılır. Provider çevrimdışı ve dış etkilerden yalıtılmıştır; ağa hiçbir zaman erişmez ve terraform ya da tofu komutlarını hiçbir zaman çağırmaz.
Bir sınırın yerleşimi
terraform sağlayıcısı bir sınırın bileşenlerini yan yana yaymak yerine sınırı birleştirir. İşlediği her sınır tek bir kök yapılandırma alır: aggrega.modules.tf. Bu dosya, orada işlenen her bileşeni, source değeri o bileşenin modules/ altındaki kendi alt dizini olan bir module bloğu olarak bildirir:
module "cache" { source = "./modules/cache"}
module "db" { source = "./modules/db"
allocated_storage = 100 db_name = "appdb" engine_version = "11.4"}Her bileşenin kendi dosyaları — vendor edilmiş modül ya da yazılmış gövde ve köken damgası — bloğunun işaret ettiği alt dizinde bulunur. Bu, Terraform’un standart kökün-alt-modülleri-birleştirdiği yapısıdır; bu yapının uzlaşımı, iç içe modüllerin bir modules/ alt dizini altında bulunmasıdır ve ister tek bir bileşen ister birkaç bileşen barındırsın, her terraform sınırının aldığı yerleşim budur. Bir bileşene ya da sınıra eklenmiş bir Feature, aynı kök yapılandırmada kendine ait bir module bloğu olarak bildirilir — bkz. Eklenmiş bir Feature’ın çıktısının yeri.
Bu biçim kozmetik değil, iki nedenle taşıyıcıdır.
Bir Terraform bağımlılık grafiği yapılandırma başınadır. Ayrı dizinlere yazılan Components, aralarında hiçbir ilişki olmayan ayrı grafiklerdir: ne bir başvuru ne de bir depends_on birinden diğerine ulaşabilir ve hiçbir tek terraform plan ikisini birden görmez. Her bileşeni bir alt modül olarak birleştiren tek bir kök, bütün bir sınırı tek bir grafiğe ve tek bir plana yerleştirir.
Bir bileşenin dosyaları kendi dizini üzerinden adreslenir. Bir sınırdaki iki bileşen, aynı adlı dosyalar — main.tf, variables.tf — yazan modülleri vendor edebilir ve her küme, tek bir yol için çekişmek yerine kendi bileşeninin dizini altında bulunur.
Bir sağlayıcının yapılandırıldığı yer
Bir sağlayıcının yapılandırması — bir provider bloğu — bir bileşenin modülünün içine asla yazılmaz, kökte yazılır. Terraform’un belgelerine göre başka bir modül tarafından çağrılmak üzere tasarlanmış bir modül provider blokları içermemelidir ve çağrılan bir modül, kullandığı her sağlayıcının kökteki varsayılan yapılandırmasını devralır. Kendine ait bir provider bloğu taşıyan bir modül depends_on, count ya da for_each ile çağrılamaz; bu sağlayıcı ise, aşağıdaki Dağıtım sıralaması bölümünde anlatıldığı gibi, aynı kökün başka bir bileşeni daha erken bir syncWave taşıdığında bir bileşenin module bloğuna depends_on yazar; bu durumda Terraform, hiçbir şeyi planlamadan önce, yapılandırma yüklenirken yapılandırmanın tamamını reddeder.
Bu nedenle, sağlayıcısının yapılandırılması gereken bir Recipe bu yapılandırmayı spec.boundary.artifacts altında bir dosya olarak yazar. Bu tür her dosya, Terraform’un onu kök yapılandırmayla birlikte okuduğu aggrega.modules.tf dosyasının yanına bir kez yazılır ve bileşenin modülü yalnızca sağlayıcının kaynağını ve sürümünü bildiren required_providers bildirimini tutar:
infra/terraform/ aggrega.modules.tf provider-azurerm.tf modules/ gateway/main.tfAynı dosyayı aynı baytlarla bildiren tek bir kökün Components’i tek kopyayı paylaşır; aynı adın farklı baytlarla bildirilmesi derlemeyi durdurur. Modüllerin kaynakları o tek yapılandırmaya karşı kaydedilir; dolayısıyla Terraform’un onları yok ederken kullandığı da odur. Dosyayı bildiren son bileşeni kaldıran bir Release, dosyayı da onunla birlikte kaldırır ve Terraform bu durumda, sağlayıcıyı yapılandıran bir provider bloğu isteyerek o modüllerin oluşturduklarının yok edilmesini planlamayı reddeder. Bu kaynakları, bu türden son bileşeni kaldırmadan önce yok edin.
Bir bileşenin girdilerinin sağlandığı yer
Bir bileşenin girdileri, kök yapılandırmadaki module bloğunun argümanlarıdır ve yazıldıkları tek yer burasıdır. Derleyicinin modülün girdilerini sağladığı durumda — bir modülü source: ile vendor eden bir Recipe — blok argüman taşır. Recipe yapılandırma gövdesini kendisi yazıp değerlerini bu gövdeye çözümlediğinde ise blok çıplaktır, çünkü derleyicinin aktaracağı bir şey kalmamıştır.
Bir modül argümanı Terraform’un değerlendirdiği bir konumdur; değerlerin oraya gitmesinin nedeni budur. Bir Recipe’nin sağladığı bir ${ ... } işaretçisi, modüle düz bir dize olarak ulaşmak yerine orada çözümlenir. Neye karşı çözümlendiği kök yapılandırmadır: bir referans, bu yapılandırmanın bildirdiği bir şeyi adlandırır — module.<name>.<output> biçiminde, module bloklarından birini — ve bildirmediği herhangi bir şeye yapılan referans, plan zamanında eksik hedefi adlandıran yüksek sesli bir hatadır.
Bu nedenle bir bileşenin kendi dizini, dağıtıldığı hâliyle planlayabileceğiniz bir yapılandırma değildir. Girdileri bir üst düzeyde, kökte belirtilir; dolayısıyla modules/<component> içinde durup motoru orada çalıştırmak başka bir şeyi planlar ve iki olasılıktan hangisinin gerçekleşeceği modülün kendi variable bloklarına bağlıdır:
- En az bir girdi
defaultbildirmiyorsa plan yüksek sesle başarısız olur —No value for required variable(Gerekli değişken için değer yok); atanmamış her değişkeni ve satırını adlandırır ve Terraform’un kendi-var/-var-fileçözümünü önerir. - Her girdi bir
defaulttaşıyorsa plan başarılı olur ve kök yapılandırmanın sağladığı değerler yerine modülün varsayılanlarından derlenir. Hiçbir uyarı verilmez, bu yüzden bilinmesi gereken durum budur: doğru görünen bir plan, kimsenin istemediği bir yapılandırmayı tanımlamaktadır.
Bunun yerine sınırın kendi çıktı dizinini — aggrega.modules.tf dosyasını barındıran, modules/ dizininin hemen üstündeki dizini — planlayın. Dağıtımın değerleri oradadır ve tek bir planın sınırın tamamını gördüğü tek yer orasıdır.
Başka bir bileşenin yayımladığı değeri tüketme
Başka bir bileşene bir uses kenarıyla bağlanmış bir bileşen, o bileşenin yayımladığı değerleri kendi .context.inject borusu üzerinden (ya da .context.uses.<alias>.provides.<name> üzerinden) okur. Okuduğu şey, derleyicinin yorumlamadan aktardığı bir dizedir ve bu dizenin düştüğü yer, Terraform’un Recipe’nin onu yazdığı kapsamda değerlendirdiği metindir. Bir terraform sınırında bu tür iki kapsam vardır ve bileşenler arası bir referansın ihtiyaç duyduğu modül çağrılarını yalnızca biri bildirir:
- kök yapılandırma her katkıda bulunanı bir
modulebloğu olarak bildirir, dolayısıylamodule.<name>.<output>orada çözümlenir; - bir bileşenin kendi dizini hiçbir modül çağrısı bildirmez, dolayısıyla
module.<name>.<output>orada hiçbir şeyi adlandırmaz —<name>ne olursa olsun. Doğru adı yazmak hiçbir şeyi değiştirmez, çünkü eksik olan yazım değil, bildirimdir.
Dolayısıyla tüketilen bir referansın çözümlenip çözümlenemeyeceğini tüketilen değer değil, tüketen Recipe’nin girdi türü belirler.
Tüketen bir Recipe’yi source: Recipe’si olarak yazın. Onun valuesMapping: alanı, kök yapılandırmadaki kendi module bloğunun argümanları olur — hem değerlendirilen hem de komşularının bildirildiği bir kapsamda bulunan tek konum.
İşlenmiş bir çift örneği
Üretici, kendi modül çağrısını adlandıran bir adres yayımlar; bu, tüketicisinin kapsamının bildirdiği biçimdir. .context.instance_id provides değerlendirme yüzeyindedir ve dağıtımın Aggregate’inin bildirdiği bir bileşen için, o bileşenin module bloğunun taşıdığı addır:
# Recipe — the producer. Its vendored module declares `output "endpoint"`.spec: capability: terraform implements: example/storage/object-store:1.0.0 source: ./module valuesMapping: | bucket: "{{ .values.bucket }}" provides: endpoint: "${module.{{ .context.instance_id }}.endpoint}"Tüketici, bir girdi bildiren bir modülü vendor eder ve enjekte edilen değeri bu girdiye eşler:
# Recipe — the consumer. Its vendored module declares `variable "store_endpoint"`.spec: capability: terraform implements: example/compute/reporting-api:1.0.0 source: ./module valuesMapping: | store_endpoint: "{{ .context.inject.env.STORE_ENDPOINT }}"Aggregate, kenarın taşıdığı yayımlanmış anahtarı adlandırarak onları birbirine bağlar:
spec: components: store: type: example/storage/object-store values: bucket: app-artifacts
api: type: example/compute/reporting-api uses: store: store: target: store inject: env: - in: STORE_ENDPOINT from: endpointDerleme, referansın ve hedefinin birlikte bildirildiği tek bir kök yapılandırma yayar:
module "api" { source = "./modules/api"
store_endpoint = "${module.store.endpoint}"}
module "store" { source = "./modules/store"
bucket = "app-artifacts"}Aynı yapılandırma module "store" bildirdiği için Terraform module.store.endpoint referansını çözümler ve değer tüketicinin modülüne sıradan bir girdi olarak ulaşır.
aws-rds-and-ecs-service örneği bu çifti standart kütüphane Recipes’inden derler: yayımlanmış RDS modülüyle sağlanan bir PostgreSQL veritabanı ve Amazon ECS üzerinde çalışan bir sunucu; sunucunun environment argümanı, module "db" bildiren kök yapılandırmada ${module.db.db_instance_address} taşır.
Bunun ters gitmesinin üç yolu ve her birinin görünümü
Kendi gövdesini yazan bir Recipe, bileşenler arası bir başvuruyu tüketemez. Bir artifacts: Recipe’i değerlerini yazdığı gövdeye çözümler ve bu gövde bileşenin kendi dizinine yazılır. Başvuru bu durumda hiçbir modül çağrısı bildirmeyen bir kapsamda kalır:
Error: Reference to undeclared module on modules/api/main.tf line 11, in output "seen": 11: value = "${module.store.endpoint}"No module call named "store" is declared in module.api.Bunu düzelten bir yazım yoktur, çünkü iç içe bir modülün ifadeleri kardeş bir modülü hiçbir şekilde adlandıramaz; iç içe bir modül bir komşusunun değerini yalnızca bir girdi olarak alır ve bu, kaynaklı yolun zaten sağladığı module bloğu argümanıdır. Başka bir bileşenin yayımladığı değeri tüketen bir bileşen, source: Recipe’i olarak yazılır.
Üreticinin kendi modülü içindeki bir şeyi adlandıran bir adres, o modüle göre değil köke göre çözümlenir. aws_db_instance.this.endpoint yazan bir provides girdisi, üreticinin modülünün bildirdiği bir kaynağı adlandırır; bir enterpolasyon olarak yazıldığında, tüketicinin argümanının bulunduğu yerde, yani kökte değerlendirilir:
Error: Reference to undeclared resource on aggrega.modules.tf line 19, in module "api": 19: store_endpoint = "${aws_db_instance.this.endpoint}"There is no managed resource "aws_db_instance" "this" definition in the root module.Modülün kaynaklarına uzanmak yerine ${module.<...>.<output>} yayımlayın ve modüle değer için bir output bloğu verin.
Enterpolasyon taşımayan bir provides girdisi metin olarak iletilir. Başarısız olmayan durum budur: derleyici dizeleri aktarır ve bir işaretçiyi bir değişmezden ayırt edemez; bu nedenle ${ ... } olmadan yazılan aws_db_instance.this.endpoint tırnaklı bir dize olarak işlenir, derleme başarılı olur, motor doğrulamayı geçer ve tüketici aws_db_instance.this.endpoint karakterlerini alır. Değer bir başvuru olarak kastedildiğinde ${ ... } sarmalayıcısını yazın; dizeyi Terraform’un değerlendireceği bir şey olarak işaretleyen budur.
Buna güvenmeden önce bilinmesi gereken bir sınır
.context.instance_id bileşenin kimliğini yazar; bir module bloğunun adı ise bileşenin dosyalarının bulunduğu dizinden türetilir. Dağıtımın kendi Aggregate’inin bildirdiği bir bileşen için bunlar aynı addır. Başka bir Aggregate’ten bileşime katılan bir bileşen için aynı değildir: bileşik kimlik ve modül adı kendi iki alfabelerine farklı biçimde yazılır ve başvuru bu durumda sessizce değil, kökte açıkça başarısız olur:
Error: Reference to undeclared module on aggrega.modules.tf line 25, in module "api": 25: store_endpoint = "${module.nested-zdinner.endpoint}"No module call named "nested-zdinner" is declared in the root module.Adresini başka bir bileşenin çözümlediği bir üreticiyi, onu tüketen bileşenle birlikte dağıtımın kendi Aggregate’inde bildirin.
Eklenen bir Feature’ın çıktısının yer aldığı yer
Kendi yapılandırmasını işleyen bir Feature eki, yanındaki bileşenlerle aynı kök yapılandırmada bildirilen kendine ait bir modül alır. Yapılandırmasını dağıtımın bir parçası yapan budur: Terraform yalnızca doğrudan bir dizinde bulunan dosyaları yükler ve iç içe bir dizini açıkça çağrılması gereken tamamen ayrı bir modül olarak ele alır; bu nedenle bir ekin dosyaları, kök bulundukları dizini adlandıran bir blok bildirdiği için okunur.
Bir ekin modül dizini bileşeninkinin yanında, modules/ altında bir düzey aşağıda bulunur ve onu tanımlayan iki şeye göre adlandırılır: onu barındıran bileşen ve eklendiği ad, -- ile birleştirilir. Dolayısıyla aux adlı bir eki taşıyan bir api bileşeni için kök yapılandırma iki modül bildirir:
module "api--aux" { source = "./modules/api--aux"}
module "api" { source = "./modules/api"}Bir bileşene değil sınıra eklenen bir Feature’ın adlandırılacak bir barındırıcı bileşeni yoktur, bu nedenle dizini yalnızca kendi adıdır: api bileşenini barındıran bir sınırdaki aux adlı bir ek, ./modules/api yanında ./modules/aux oluşturur.
Neden içinde değil de yanında. Terraform bir modül dizinindeki her üst düzey dosyayı tek bir ad alanında birleştirir (output, variable, resource ve locals aynı şekilde); bu nedenle bir dizini paylaşan iki katkıcı, dosyalarının adı ne olursa olsun, ikisinin de bildirdiği her adda çakışır. Onları ayrı tutan, her birine bir dizin verilmesidir. İçinde değil yanında olması, Terraform’un iç içe modüller için kendi yönergesinin istediği şeydir de: bunların birbirini doğrudan çağırıp derin iç içe bir modül ağacı oluşturmak yerine çağıran tarafından bileşime katılabilir olması.
Birleştirme her koordinat için ayrı kaçışlanır. İki koordinatın her biri birleştirilmeden önce dizin alfabesine yazılır; böylece kendisi -- içeren bir koordinat birleştirmeyle karıştırılamaz: c ekine sahip a--b adlı bir barındırıcı, b--c ekine sahip a barındırıcısından ayırt edilebilir. Her iki harf büyüklüğündeki ASCII harfleri, rakamlar, nokta ve alt çizgi yazıldığı gibi geçer; yazdığınız bir kısa çizgi, ardından gelen karakter bunlardan biri olduğu her durumda korunur; geri kalan her şey kaçışlanır. Aynı kural ve aynı alfabe, bir chart hedefinin alt dizinlerini de üretir; böylece bir ekin dizini, iki hedeften hangisi işlerse işlesin aynı biçimde yazılır.
Bir bloğun adı, source değerinin gösterdiği dizinden türetilir; Terraform’un modül adı dilbilgisi dışında kalan her karakter alt çizgiyle değiştirilir. Bu eşleme bire bir değildir; bu nedenle iki katkıcının tek bir modül adına ulaşacağı durumda derleme, Terraform’un reddedeceği bir yapılandırma üretmek yerine durur ve ikisini de adlandırır.
Bir ekin kendine ait bir modül olmasından üç şey çıkar.
Girdileri kendi eşlemesine aittir. FeatureRecipe’i bir modülü kaynak olarak alan ve bir valuesMapping bildiren bir ekte, bu eşlemenin ürettiği değerler, bir bileşenin kaynaklı modülünün değerlerini aldığı şekilde, kendi module bloğunun argümanları olarak yazılır. valuesMapping bildirmeyen bir FeatureRecipe, modülüne hiçbir argüman geçirmez: modülün default ile bildirdiği bir değişken onu alır, varsayılansız bildirilen ise ayarlanmamış kalır ve Terraform planı reddeder.
Kaynakları sınırın tek bağımlılık grafiğinde yer alır. Bir başvuru ya da bir depends_on, bir ek ile eklendiği bileşen arasında erişir ve tek bir terraform plan ikisini birden görür; bu, kökün alt öğeleri bileşime kattığı yapının bileşenlere aynı nedenle sağladığı özelliğin aynısıdır.
Üst düzey adları kendine aittir. Yukarıda açıklanan ad alanı birleştirmesi dizin başına olduğundan, kendine ait bir dizinde bulunan bir katkıcı output, variable, resource ve locals adlarını komşularınınkilerle çekişmeden bildirir; böylece bir ek, barındırıcısının zaten bildirdiği bir adı yeniden kullanabilir ve hiçbirinin diğerinin neyi nasıl adlandırdığını bilmesi gerekmez.
Bu hedefin neyi gerektirmediğine dikkat edin, çünkü bir chart hedefinin kısıtı farklıdır ve paylaşılan düzen, olduğundan fazlasını ima ediyormuş gibi okunabilir: başka bir katkıcının dizini içine yerleştirilmiş bir modüle burada yine erişilebilir, çünkü kök yapılandırma her katkıcının source değerini bir tanımlayıcıdan yeniden oluşturmak yerine derlemenin oluşturduğu konumdan okur. Bu hedefin reddettiği şey, iki katkıcının bir dizini paylaşmasıdır. Bir chart hedefi ise iç içe konumu doğrudan reddeder, çünkü bir alt chart’ı yalnızca bir düzey aşağıda bulur, daha derinde değil.
Desteklenen girdi türleri
terraform sağlayıcısı, üç Recipe girdi türünden ikisini kabul eder:
- Artifacts modu. Bir Recipe, Terraform yapılandırmasını şablonlu bir gövde olarak yazar; sağlayıcı Aggrega şablonunu değerlendirir ve sonucu yeniden yazmadan üretir. HCL (
main.tf) kullanışlı varsayılandır; Terraform JSON (.tf.json) da eşdeğer biçimde kabul edilir. Derleme kaynağı bilgisi, bir HCL gövdesinin başına bir Terraform yorumları bloğu olarak eklenir; yorum sözdizimi olmayan bir JSON gövdesi için kaynak bilgisi satır içine değil, eşlik edenaggrega.provenance.tfdosyasına yazılır. - Kaynaklı mod. Bir Recipe,
source:ile bir Terraform modülüne başvurur. Modülün dosyaları olduğu gibi o bileşenin dizinine vendor edilir ve Recipe’ninvaluesMapping:alanı, sınırın kök yapılandırmasındaki o bileşeninmodulebloğunun argümanları olur. Modül gövdesi tam yazıldığı gibi korunur ve içine hiçbir şey yazılmaz; değerler bir kez, Terraform’un onları değerlendirdiği kökte belirtilir. Düğümün bildirilenvaluesyaprakları doğrudan modülün girdileri olduğunda —valuesMapping:içermeyen birsource:Recipe’si — bir yazarın hassas olarak bildirdiği içeriği taşıyan girdi için ayrıca Terraform’un kendi hassasiyet özniteliğini taşıyan, üretilmiş bir geçersiz kılma dosyası da oluşturulur; birvaluesMapping:şablonu kendi çıktı adlarını uydurduğundan bu durumda işaretleme yapılmaz ve derleme bunu bir uyarıyla bildirir. Her ikisi de Hassas olarak bildirilmiş modül girdileri bölümünde açıklanır.
Bir valuesMapping: içindeki null, bir null argümanıdır. Eşlemenin null olarak ayarladığı bir anahtar, modül bloğuna <name> = null olarak yazılır ve motor, değişken nullable = false bildirmedikçe modülün değişkenine default değerini geçersiz kılarak null değerini verir; bildirirse default değeri uygulanır. Bir girdiye modülün varsayılanını vermek için anahtarı eşlemeye koymayın.
Sentezlenmiş girdi türü sunulmaz. Platformun Workload türünden rastgele Terraform kaynaklarına sadık ve yetenekten bağımsız bir eşleme yoktur; bu yüzden terraform sağlayıcısına karşı workload: bildiren bir Recipe, uydurulmuş bir çeviri yerine açıkça bildirilen bir hatadır.
omits: bildiren bir Recipe reddedilir. omits: anahtarı, bir kaynağın oluşturduğu belgeleri derlemenin dışında bırakır; bu sağlayıcı ise derleme sırasında kaynaklı bir modülden hiçbir şey oluşturmaz: modülün dosyalarını olduğu gibi vendor eder ve Terraform, yapılandırma planlanıp uygulandığında onları değerlendirir. Hiçbir şey oluşturulmadığından dışarıda bırakılacak bir şey de yoktur; bu yüzden bu sağlayıcı anahtarı desteklediğini bildirmez ve onu bildiren bir Recipe ya da FeatureRecipe, herhangi bir şey vendor edilmeden önce reddedilir — bkz. The provider does not support omits (Sağlayıcı omits desteklemiyor). Recipe’nin yanında tuttuğunuz bir modül için, oradaki .aggregaignore dosyasındaki bir satır, Recipe bir sonraki sabitlendiğinden itibaren modülün bir dosyasını bunun yerine dışarıda bırakır.
Bir kayıt defterinin yayımladığı modülü kaynak olarak kullanma
Bir modül kayıt defteri, bir modülün her sürümünü modülün kendi git deposunun bir etiketi olarak yayımlar ve bir sürümü indirmesi istendiğinde döndürdüğü şey, o etiketin gösterdiği commit’e sabitlenmiş bir git kaynağıdır. Bu yüzden bir Recipe, yayımlanmış bir modülü git-repository kaynak türüyle o depodan, o etiketle alır:
spec: capability: terraform implements: example/storage/database:1.0.0 source: kind: git-repository url: https://github.com/terraform-aws-modules/terraform-aws-rds.git ref: v7.2.2 valuesMapping: | identifier: "{{ .values.identifier }}" provides: host: "${module.{{ .context.instance_id }}.db_instance_address}" port: "${module.{{ .context.instance_id }}.db_instance_port}"ref:, deponun adlandırdığı haliyle sürüm etiketidir. valuesMapping:, modülün girdilerini variable bloklarının bildirdiği adlarla sağlar — Terraform, default bildirmeyen her girdi için bir değer ister — ve bunlar, her kaynaklı modülde olduğu gibi, kök yapılandırmadaki bu bileşenin module bloğunun argümanları olur.
Neyin sabitlendiği. aggrega pin ve çekme işlemi, etiketi gösterdiği commit’e çözümler ve depoyu o commit’te arşivler. Ardından Release’in kilit dosyası, o commit’i kaynağın sabitlenmiş sürümü, etiketi yazdığınız başvuru ve arşivin özetini kaydeder. Sonraki her derleme arşivi önbellekten okur ve herhangi bir şeyi vendor etmeden önce onu bu özete karşı doğrular; böylece ağa ihtiyaç duymaz ve baytları artık eşleşmeyen önbelleğe alınmış bir arşiv derlemeyi durdurur. Etiket, bir deponun başka bir commit’e taşıyabileceği bir addır; sizinkinin başka bir yere çözümlendiğini bulan sonraki bir çekme işlemi yeni commit’i benimsemek yerine durur ve aggrega pull --upgrade onu bilinçli olarak benimser. Bu, bir yapılandırmanın seçtiği sağlayıcıları kaydeden ve hiçbir modülü kaydetmeyen Terraform’un kendi bağımlılık kilit dosyasından daha sıkı bir sabitlemedir; orada bir yapılandırmaya bir etikette git kaynağı olarak yazılan modül ancak etiket kadar sabittir. Burada modülün commit’i ve baytlarının özeti kilitte sabitlenir, baytlar çıktıya vendor edilir ve kök yapılandırma onları yerel bir yolla çağırır; böylece motor modülün kendisini yüklemek için hiçbir şey indirmez — vendor edilen modülün bir kayıt defteri ya da uzak kaynak üzerinden çağırdığı bir modül yine de indirilir ve derleme, Motorun başlatılırken indirdiği modül çağrısı bölümünde açıklandığı gibi, bu tür her çağrıyı bildirir.
Neyin vendor edildiği. Sabitlenmiş commit’teki deponun tamamı, .git/ dizini dışında, bileşenin modules/ altındaki kendi dizinine bayt bayt yerleşir — modülün kendi yapılandırma dosyaları ve alt modülleri, ayrıca deponun taşıdığı diğer her şey: examples/ ve wrappers/ dizinleri, belgeleri, CI yapılandırması ve ikili olanlar dahil tüm test verileri. Motor yalnızca modülün çağırdığını okur: kök yapılandırma bileşenin dizinini çağırdığında motor, doğrudan o dizindeki ve oradan yerel bir source ile ulaşılan her dizindeki yapılandırma dosyalarını yükler. Bu nedenle başka kayıt defteri modüllerini çağıran bir örnek dizini vendor edilir ama hiç yüklenmez ve çağırdığı hiçbir şey indirilmez.
Vendor edileni daraltma. İndirilmiş bir kaynak, indirildiği arşivin kendisidir; bu yüzden onu daraltmanın tek yolu, deponun bir dizinini yapıt haline getiren module_subdir: alanıdır. Bu yalnızca istediğiniz modül bir alt dizindeyse işe yarar: deponun kökünde bulunan ve kendi ./modules/* dizinlerini çağıran bir modül tüm ağaca ihtiyaç duyar. Ne deponun taşıdığı bir .terraformignore ne de Recipe’nin yanındaki bir .aggregaignore, indirilmiş bir kaynağın vendor ettiğini değiştirir — ikisi de Recipe’nin yanında tutulan bir modülü şekillendirir ve hiçbiri bir depodan indirilen modül için okunmaz.
Modülün yayımladığını okuma. Modülün yayımladığı bir değer, output bloklarından biridir ve bir tüketici onu ${module.<name>.<output>} olarak okur; burada <name>, üreticinin modül bloğudur — yukarıdaki üreticinin ${module.{{ .context.instance_id }}.<output>} yayımlamasının nedeni budur. Motor, kök yapılandırmayı doğrularken başvuruyu modülün kendi output bloklarına karşı çözümler; böylece modülün bildirmediği bir çıktı adı orada, adı belirtilerek reddedilir:
Error: Unsupported attribute on aggrega.modules.tf line 9, in module "api": 9: db_host = "${module.db.db_instance_addresz}"This object does not have an attribute named "db_instance_addresz".Derleme, modülün variable ya da output bloklarından hiçbirini okumaz, modüle hiçbir şey yazmaz ve ona sağlayıcı yapılandırması eklemez; bu yüzden yanlış yazılmış bir çıktı adını derleme değil motor yakalar. Tüketici tarafı için bkz. Başka bir bileşenin yayımladığı değeri tüketme.
Birebir çıktı üretimi ve modüllerin dahil edilmesi
terraform provider’ı Terraform gövdelerini dönüştürmez, yeniden biçimlendirmez veya yeniden yazmaz. Yazılmış bir HCL veya .tf.json gövdesi tam olarak şablonunun değerlendirdiği gibi çıktıya verilir, bir HCL gövdesi köken yorumlarıyla başlar ve kaynaklı bir modül dosyası dosyasına dahil edilir. terraform çıktısını deterministik ve yeniden üretilebilir kılan budur: aynı girdiler verildiğinde, oluşturulan yapılandırma çalıştırmalar arasında bayt bayt aynıdır ve dahil edilen bir modül değişmeden gidip gelir. provider çalışma zamanı durumunu hiçbir zaman çözümlemediği için, çalışma zamanına bağlı her şey Terraform’un uygulama (apply) anında bağladığı bir enterpolasyon dizesi olarak kalır.
Platform ek açıklamaları
terraform provider’ı aggrega.ai/ ek açıklamalarının hiçbirini okumaz. Vendor edilmiş bir modülün, bir Recipe’nin yapıt dosyalarının ve provider’ın yazdığı kök yapılandırmanın bir ad alanı, kayıt defteri öneki, çekme sırrı veya hizmet hesabı için yeri yoktur; bu nedenle bunlardan biri için ayarlanan bir değer, oluşturulan yapılandırmada hiçbir şeyi değiştirmez. Böyle bir değere ihtiyaç duyan bir modül, onu bileşenin values alanı aracılığıyla kendi girdilerinden biri olarak alır.
Provider bunu Plugin varlığında readsNoWellKnownAnnotations: true ile belirtir (bkz. Plugin varlığı) ve bu nedenle derleme, provider aracılığıyla bir işlemeye ulaşan her aggrega.ai/ ek açıklaması için — anahtar ve işleme başına bir kez, o işlemenin bildirdiği girdi türlerini belirterek — uyarı verir:
warning: node "db" (provider "terraform"): target "terraform" does not support annotation aggrega.ai/namespace on sourced input and ignored itDeğer yine de derlemeden dokunulmadan geçer ve derleme durmaz: bir sınır ek açıklaması altındaki her bileşene kademeli olarak aktarılır ve bileşenleri farklı hedefler üzerinden işlenen bir sınır, bir hata değil olağan bir durumdur. Uyarı unsupported-field sınıfına aittir ve o sınıfın bayrağıyla susturulur.
Hassas olarak bildirilmiş modül girdileri
Terraform, değer başına yerel bir hassasiyet temel öğesine sahip tek standart kitaplık hedefidir; bu nedenle bir yazarın hassas olarak bildirdiği bir veri yalnızca Aggrega’nın terimleriyle kaydedilmekle kalmaz, Terraform’un kendi terimleriyle de işlenebilir.
Vendor edilmiş bir modülün girdisi, bir yazarın hassas olarak bildirdiği malzemeyi taşıdığında provider, modülün yanına bir dosya daha ekler: o girdi için sensitive = true bildiren aggrega_override.tf.json:
{ "variable": { "db_password": { "sensitive": true } }}Terraform, adı yalın override olan ya da _override ile biten bir yapılandırma dosyasını aynı dizindeki yapılandırmaya birleştirir; böylece modülün kendi variable bloğu özniteliği kazanırken vendor edilmiş her bayt tam olarak yazıldığı gibi kalır. Girdinin bildirilen türüne, varsayılanına ve açıklamasına dokunulmaz; override yalnızca hassasiyet özniteliğini taşır, başka hiçbir şeyi taşımaz. İşaretlenmemiş bir düğüm böyle bir dosya almaz.
Bu sınır dosya biçiminin dayattığı bir şey değil, bilinçli bir tercihtir: bir override’daki hiçbir şey ikinci bir özniteliği reddetmez ve baytlarını düzenlemeden vendor edilmiş bir modüle değer taşımak isteseydiniz başvurulacak en yakın yer bir variable bloğunun default alanı olurdu; ancak değer oraya ulaşmazdı. Bu dosyanın yazıldığı JSON yapılandırma sözdiziminde bir default, Terraform’un değerlendirdiği bir konum değildir; bu yüzden oraya yazılmış ${ ... } işaretçisi taşıyan bir değer modüle işaretçinin düz karakterleri olarak ulaşır ve plan başarılı olup hiçbir şey söylemez. Aynı işaretçi yerel HCL’de bir default içine yazıldığında doğrudan reddedilir; bu da o sessizliği override dosyalarının kendisine değil, bu sözdizimine yerleştirir. Bu yüzden override yalnızca sensitive taşır: anlamı değerlendirilmeye bağlı değildir.
Hangi girdinin işaretleneceği bir addan değil, her zaman bir bildirimden gelir. Provider, derlemenin hesapladığı işaretlemeyi okur ve kendisi hiçbir şeyi incelemez: password, secret veya token adlarını tanımaz ve tahmin etmek için modülün metnini okumaz. Değeri hiçbir bildirim taşımayan db_password adlı bir modül girdisi işaretsiz yayılır, bildirilmiş region adlı bir girdi ise işaretlenir.
İşaretleme yalnızca girdinin kimliğinin bildirimden geri kazanılabildiği yerlere taşınır. Bir modülü source: ile vendor eden ve düğümün bildirilen values yapraklarının doğrudan modülün girdileri olmasına izin veren bir Recipe, her girdiye yazarın bildirdiği adın aynısını verir; bu yüzden bağlantı kesindir. Bir modülü aynı şekilde vendor eden bir bileşene eklenmiş bir Feature’ın FeatureRecipe’i de, Feature’ının bildirdiği yapraklar üzerinde aynısını yapar. Bu değerleri bir valuesMapping: şablonuyla yeniden biçimlendiren bir Recipe ya da böyle bir FeatureRecipe çıktı adlarını kendisi üretir ve hiçbir bildirim bu adları belirtmez; bu yüzden işaretleme yaklaşık olarak yapılmaz, hiç yapılmaz ve derleme bunu bildirilen her yaprak için yaprağı ve eşlemesi kendisine ait varlığı adlandıran bir uyarıyla bildirir (bir sınıra eklenmiş bir Feature hiçbir values üzerinde işlenmediğinden işaretleyecek bir şeyi yoktur ve uyarı almaz); bkz. A declared-sensitive value reaches the target through a values mapping (Hassas olarak bildirilmiş bir değer hedefe bir değer eşlemesi üzerinden ulaşıyor). Bu yokluk bilinçlidir: yeniden biçimlendirilmiş hangi girdinin bildirilen veriyi taşıdığını tahmin etmek, herkese açık bir girdiyi gizli olarak işaretler ve Terraform da hiç hassas olmamış bir değeri plan çıktısından gizlerdi.
Çalışılmış örnek terraform-declared-sensitivity bunu baştan sona oluşturur ve tamamen okunabilecek kadar küçüktür: üç values yaprağı bildiren bir bileşen; bunlardan ikisi herkese açık tanımlayıcılar, biri kimlik bilgisini taşır. İşlenmiş çıktısı, module bloğunun argümanlarının üç modül girdisinin tümünü taşıdığını ve override’ın yalnızca bildirilmiş olanı adlandırdığını gösterir; böylece kuralın iki yarısı da aynı derlemede görünür; gizli bilginin yanında duran bir kimlik bilgisi tanımlayıcısının işaretsiz bırakılması da buna dahildir. Tek bildirimi kaldırıp yeniden derlemek hiçbir override dosyası yaymaz.
Terraform’un sensitive özniteliğinin neyi garanti ettiği ve etmediği
Aggrega, tam olarak Terraform’un kendi özniteliğinin sağladığını vaat eder, daha fazlasını değil.
Görüntülemeyi sınırlar. Hassas bir değer plan çıktısında (sensitive value), apply çıktısında <sensitive> olarak görünür. İşaretleme ifadeler boyunca yayılır; bu yüzden hassas bir girdiden türetilen bir değer de hassastır ve Terraform böyle bir değeri kendisi hassas olarak işaretlenmemiş bir kök output üzerinden dışa aktarmayı reddeder: sessiz bir ifşa yerine yüksek sesli bir hata.
Depolamayı değiştirmez ve şifreleme değildir. Terraform hassas bir değeri state içinde açık metin olarak kaydeder. sensitive = true ifadesini state’in commit edilmesinin veya paylaşılmasının güvenli olduğu yönünde bir vaat olarak okumak, kaçınılması gereken tek yanlış okumadır: state’i korumak, hiç işaret taşımayan bir modülde olduğu gibi, state arka ucunun nasıl yapılandırıldığına bağlı bir konu olmaya devam eder. Öznitelik ayrıca değeri kimin okuyabileceğini kısıtlamaz, bir provider’ın neyi ilettiğini etkilemez ve işlenmiş yapılandırmayı başka hiçbir şekilde değiştirmez.
Dolayısıyla işaretleme, biri bir planı okuduğunda hassas olarak bildirilmiş bir girdinin kazara ifşa edilmesini zorlaştırır. Dağıtılabilir çıktıyı yayımlamak için güvenli hâle getirmez. Anahtar kelime ve bir bildirimin her hedefte neyi sağladığı için bkz. Bir yaprağı hassas olarak bildirmek.
Yapısal girdi doğrulaması
terraform provider’ı, kaynaklı bir modülün yapısını işlemeden önce doğrular. Modülün HCL ve .tf.json dosyalarını ayrıştırır ve ayrıştırma hatalarını bildirir; derlemeyi, sorunlu düğümü ve provider’ı adlandıran açık bir iletiyle durdurur. Ayrıştırma anlamı değil biçimi denetler: provider’ları çözümlemez, ifadeleri değerlendirmez ve bir kayıt defterine bağlanmaz. Doğrulama hermetiktir: provider’ın içine derlenmiş, kendi kendine yeten bir HCL ayrıştırıcısı kullanır; terraform ikili dosyası ya da ağ erişimi gerektirmez. Hatalı biçimlendirilmiş bir modül, daha sonraki bir terraform çalıştırmasında kafa karıştırıcı bir hata olarak ortaya çıkmak yerine yazım sınırında yakalanır.
Motorun başlatılırken getirdiği bir modül çağrısı
Aynı okuma, hiçbir şeyi reddetmeyen bir uyarı olarak, kaynağını Terraform’un yapılandırma başlatılırken indirdiği her module bloğunu bildirir. Vendor’lanmış bir modülün commit’i ve arşiv özeti kilitte sabitlenmiştir; ancak içindeki, source değeri bir kayıt defteri adresi, bir git, Mercurial ya da HTTP arşiv URL’si, bir S3 ya da GCS kovası veya mutlak bir yol olan bir module bloğu, motorun başlatma sırasında o an seçtiği sürümle getirdiği bir modülü adlandırır; Terraform’un kendi bağımlılık kilit dosyası yalnızca provider’ları kaydettiğinden o modülü hiçbir şey sabitlemez. Vendor’lanmış modülün dışına çıkan yerel bir source da bildirilir, çünkü derlemenin vendor’lamadığı dosyaları adlandırır. Her bulgu düğümü ve provider’ı, ardından bloğu, bulunduğu dosya ve satırı ve yazıldığı biçimiyle kaynağı adlandırır:
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that moduleNeyin okunduğu. Modül çağrıldığında motorun yüklediği dosyalar: doğrudan modülün kendi dizinindeki yapılandırma dosyaları, ardından oradan yerel bir source değerinin (./ ya da ../ ile başlayan veya bunların ters eğik çizgili yazımları) ulaştığı her dizindekiler; dizinden dizine izlenir ve her biri bir kez okunur. Hiçbir şeyin çağırmadığı bir dizin okunmaz; bu nedenle bir modülün examples/ ya da tests/ dizininin yaptığı çağrılar bildirilmez: motor modül çağrıldığında bunları hiç yüklemez ve çağırdıkları hiçbir şey getirilmez. Yukarıdaki ayrıştırma denetimi yine de vendor’lanmış her yapılandırma dosyasını ayrıştırır. Bir Recipe’nin yazılmış gövdesi de işlendiğinde, gövdenin yazıldığı dizinden başlayarak aynı şekilde okunur; bu nedenle yazılmış bir gövdenin kayıt defteri kaynağıyla yazdığı bir module bloğu da bildirilir. spec.boundary.artifacts altındaki bir dosya derleyicinin kendisi tarafından değerlendirilip yazılır ve hiçbir provider’a verilmez; bu nedenle böyle bir dosyada yazılan bir module bloğu okunmaz ve uyarı üretmez.
Neyin okunmadığı. Yalnızca bir source değerinin söylediği okunur. Derleme, bir çağrının adlandırdığı modülü okumaz, o modülün ne yaptığını değerlendirmez ve çağrının kabul edilebilir olup olmadığına karar vermez. Motorun yazıldığı gibi okumak yerine değerlendirdiği bir source (bir enterpolasyon ya da bir başvuru içeren) baştaki metnine göre değerlendirilir: bir adresle başlayan yazıldığı gibi bildirilir; yerel bir önekle ya da enterpolasyonun kendisiyle başlayan ise ne bildirilir ne de izlenir, çünkü nereye vardığı metinde yer almaz. required_providers içindeki bir source bir modülü değil bir provider’ı adlandırır ve bir modül çağrısı değildir.
Neden reddedilmeyip bildirildiği. Başka bir modülü çağıran bir modül geçerli bir girdidir: Terraform çağrılan modülü getirir ve yapılandırma çalışır. Yazarın vazgeçtiği şey, derlemenin çağrılan modül üzerindeki sabitlemesidir; bu düzeltilecek bir kusur değil, bilinmeye değer bir olgudur ve bu getirmenin kabul edilebilir olup olmadığı yazarın takdiridir. Tamamen sabitlenmiş kalması gereken bir yapılandırma yalnızca böyle bir çağrı yapmayan modülleri vendor’lar. Uyarı, sınıf kodu ve başka nerelere ulaştığı Uyarılar ve linter çıktısı bölümünde açıklanmıştır.
FeatureRecipe yama sınırı
Render sonrası bir FeatureRecipe pipeline adımı yalnızca provider’ın yapılandırılmış bir ağaca render ettiği çıktıyı yamalar. Terraform için bu şu anlama gelir:
- JSON ile yazılmış Terraform yamalanabilir. Bir
.tf.jsonmodülü yapılandırılmış bir belgedir; bu nedenle bir pipeline adımının JSONPatch’i adreslenen değerleri yerinde düzenler ve diğer her baytı (sıralama, biçimlendirme, çevredeki anahtarlar) olduğu gibi bırakır. - Yerel HCL opaktır. Yerel HCL ile yazılmış bir gövde (
main.tf) yapılandırılmış bir yama hedefi değildir. Opak bir gövdeye yönelik bir yama, yapısal olarak adresleyemediği metni değiştirmek yerine derlemeyi bir tanılama iletisiyle durdurur; bir HCL gövdesine karşı pipeline adımı yazmak, sessiz bir etkisiz işlem olarak değil, belirgin bir durma olarak ortaya çıkarılan bir tasarım hatasıdır. - Kaynaktan alınan bir modülün girdileri hiçbir şekilde yama hedefi değildir. Bunlar, bileşenin kök yapılandırmada yer alan
modulebloğunun argümanlarıdır: yerel HCL’dir ve dolayısıyla opaktır; ayrıca tek bir düğümün değil, sınırın tamamının bir ürünüdür. Birpipelineadımı bir düğümün kendi render edilmiş çıktısını yamalar; bu nedenle onları adresleyebileceği bir konum yoktur.
Bu nedenle bir Terraform gövdesinin pipeline ile yamalanabilir olmasını isteyen bir yazar onu .tf.json olarak yazar. Provider’lar genelindeki yama hedefi sınırı için FeatureRecipe sayfasına bakın.
Dağıtım sıralaması
Bir Release sınırının syncWave: değeri, o sınırın içine bir araya getirildiği kök yapılandırmanın module bloklarını sıralar. Sınırdaki her bileşen sınırın dalgasını devralır; birden çok sınır aynı çıktı dizinine çözümlendiğinde — yani bileşenleri tek bir kök yapılandırmada birleştirildiğinde — o kök birden fazla dalga barındırır ve sağlayıcı aralarındaki sıralamayı module blokları üzerinde depends_on olarak ifade eder.
Her modül, hemen önceki dalganın bileşeni olan her modülünü adlandırır, ondan daha erken bir dalgayı adlandırmaz. Gerisini Terraform zincirler: 2 dalgasındaki bir modül 1 dalgasına, o da 0 dalgasına bağlıdır; böylece tüm dizi sıralanırken her modülün kendi listesi tüm sınırın değil, tek bir dalganın boyutunda kalır. Dalgaların ardışık olması gerekmez ve negatif değerler olağandır — -1, yapılandırmanın geri kalanının okuduğu bir bucket ya da rol için yaygın bir seçimdir. En düşük dalga hiçbir şey adlandırmaz, çünkü ondan önce hiçbir şey gelmez.
Sıralamanın ne olduğu: Terraform’un eylemlerini gerçekleştirdiği sıra. Terraform bir bağımlılık grafiği oluşturur ve grafiğin izin verdiği ölçüde bu grafik üzerinde paralel olarak ilerler. depends_on bu grafiğe bir kenar ekler; böylece Terraform, adlandırılan modüller üzerindeki eylemlerini, bağımlılığı bildiren modül üzerindeki eylemlere başlamadan önce tamamlar. Bu nedenle bir dalga çalıştırmayı aşamalara böler: önceki dalganın bileşenleri üzerinde, sonraki dalganınkilere başlanmadan önce işlem yapılır.
Bu bir hazır olma sıralaması değildir. Bir Terraform yapılandırması, bir kaynağın hizmet verebilir olması kavramını ifade etmez; dolayısıyla burada hiçbir şey bir kaynağın hazır olmasını beklemez — yalnızca Terraform’un onun üzerindeki işlemi bitirmesini bekler. Bu, aynı dalganın compose üzerindeki davranışından gerçek bir farktır; orada healthcheck bildiren bir hizmet, sağlıklı olduğunu bildirene kadar beklenir: compose’un üzerine kapı koyabileceği bir hazır olma temel öğesi vardır, bir Terraform yapılandırmasının ise yoktur. Bu hedefin sunduğu şey eylem sırasıdır ve bunu açıkça belirtmek, veremeyeceği bir söze eklenmiş bir uyarıdan daha yararlıdır.
Hiçbir kaldırma sırası vaat edilmez. depends_on’un belirttiği şey, Terraform’un bağımlılığın eylemlerini bağımlı olanınkilere başlamadan önce tamamladığıdır; bir destroy işleminin bunları hangi sırayla kaldırdığı bu ifadenin parçası değildir, bu nedenle burada kaldırma sırası hakkında hiçbir iddiada bulunulmaz. Bu, aynı dalganın cloudformation üzerinde taşıdığından daha dar bir vaattir; oradaki öznitelik her iki yönü de yönetir — bir kaldırmayı sıralamak için bir dalgaya güveniyorsanız bunu bilmeniz gerekir, çünkü bu hedefte dalga bunu yapmaz.
Tüm bileşenleri tek bir dalga taşıyan bir sınır bundan hiçbir şey kazanmaz. Hiç syncWave bildirmeyen bir Release de öyle: her katkıda bulunan, alanın varsayılan değeri olan 0’ı taşır, kök yapılandırma tek bir dalga barındırır ve üretilen baytlar, sağlayıcı hiçbir dalga sıralaması ifade etmeseydi olacağıyla tam olarak aynıdır.
İki kök yapılandırma arasındaki sıralama ifade edilemez ve yaklaşık olarak da sağlanmaz. Bir Terraform bağımlılık grafiği yapılandırma başınadır ve depends_on, onu bildiren yapılandırmanın içindeki bir modülü adlandırır; dolayısıyla bir dalga, o köke birleştirilen her bileşeni sıralar, ötesindeki hiçbir şeyi sıralamaz. İki yapılandırmayı sıralamak operatörün işidir; tıpkı bir remote-state başvurusunun derleme zamanında değil, dağıtım zamanında çözümlenmesi gibi.
Dalga yalnızca uygulanmakla kalmaz, kaydedilir de: düğümün derleme kökeninin geri kalanıyla birlikte, damgalanan yorum bloğunda aggrega.ai/sync-wave olarak ya da gövde JSON veya dahil edilmiş bir modül olduğunda eşlik eden köken dosyasında taşınır. Böylece işlenmiş bir yapılandırma, dalgaya göre sıralanmanın yanı sıra sınırının hangi dalgayı bildirdiğini de kaydeder.
Dalgaların ifade etmediği sıralama Terraform’un kendi işi olarak kalır ve kaynaklar arasındaki başvurular bunun büyük bölümünü zaten taşır: başka bir kaynağın özniteliğine yapılan bir başvuru, Terraform’a önce o kaynak üzerinde işlem yapmasını söyler. Ne başvuruların ne de dalgaların ima ettiği bir kısıta ihtiyaç duyan bir modül, modülün içine kendi depends_on’unu yazar; sağlayıcı bunu gövdenin diğer her parçası gibi olduğu gibi üretir.
İlgili başvurular
- Provider mimarisi — sağlayıcıların derleme hattına ve sağlayıcı başına yönlendirmeye nasıl yerleştiği.
- Provider başvuru dizini — her standart kitaplık sağlayıcısının ne ürettiği ve hangi sayfanın hangi soruyu yanıtladığı.
- Recipe varlığı — Recipe yazım yüzeyi ve üç girdi türü.
- FeatureRecipe — işleme sonrası
pipelineyama modeli ve onun yapılandırılmış/opak sınırı. - Recipe girdi bileşimi — kanonik Provider Yetenek Matrisi.