Kontrak konteks templat
Halaman ini mendokumentasikan tampilan runtime yang diinjeksikan oleh compiler ke dalam templat Go Recipe dan FeatureRecipe: bentuk konteks templat, ketersediaan per bidang di sepanjang pipeline kompilasi, serta kontrak kanonis yang dibutuhkan penulis tingkat lanjut saat menulis templat yang menggunakan state lintas komponen. Ketersediaan per situs templat (bidang mana yang tersedia di situs evaluasi mana) didokumentasikan di expansion-matrix.md; halaman ini mendokumentasikan bentuk bidang dan semantiknya.
Ikhtisar
Compiler menyusun sebuah konteks templat per node selama rendering dan menyuntikkannya ke setiap template Go yang dievaluasi oleh renderer untuk node tersebut. Konteks ini hanya ada di memori — konteks ini tidak pernah disimpan ke disk dan tidak pernah melintasi ABI Wasm sebagai satu payload tunggal. Setiap situs template menerima tampilan dari objek konteks yang sama; beberapa field diisi belakangan (.workload tersedia saat sintesis workload; .source saat resolusi source; .steps diisi oleh eksekusi pipeline: seiring setiap langkah selesai, lihat Status bahasa → Fase pipeline kompilasi).
Skema untuk bentuk runtime ini adalah template-context-v1beta1.schema.json (disertakan dalam distribusi skema Aggrega).
Bidang tingkat atas
Bidang tingkat atas berada di akar konteks templat — diakses sebagai .field dari dalam templat.
.values(map). Muatan kognitif yang ditulis pengembang dari Aggregate. Nilai per komponen diteruskan ke Recipe yang dirender pada bidang ini. Divalidasi olehschema:milik Catalog (deklarasi JSON Schema 2020-12 milik Component atau Feature) saat resolusi. Jika nilai nol / kosong / false yang ditulis untuk suatu bidang secara semantik berbeda dari bidang yang tidak ada, gunakanoptional(lihatsprig-functions.md) alih-alihdefault..infra(map). Ukuran fisik yang ditulis tim operasi dari Release. Divalidasi olehschema:milik Catalog (deklarasi JSON Schema 2020-12 milik Component atau Feature) saat resolusi. Panduanoptionalversusdefaultyang sama seperti untuk.valuesberlaku — utamakanoptionaljika nilai nol atau false yang ditulis merupakan maksud yang sah (scale-to-zero, tanpa percobaan ulang, feature flag nonaktif)..locals(map bernilai string). Status privat Recipe — nama yang dideklarasikan dalam bloklocals:milik Recipe, diresolusi dalam pembuka locals dan dipublikasikan ke pilar ini saat resolusi sumber. Entri diresolusi sesuai urutan penulis dan sebuah entri dapat membaca entri saudara yang didefinisikan di atasnya, sehingga urutan menjadi penting di mana pun satu entri membaca entri lain. Hanya dapat diakses di dalam templat milik Recipe itu sendiri; tidak pernah diekspos ke pemanggil..provides(map bernilai string). String keluaran publik milik Recipe — kontrak yang menjadi acuan resolusi referensifrom:dalam blokinject:milik pemanggil. Diisi saat evaluasi provides..features(map lampiran). Mengiterasi Features yang dilampirkan ke Component ini (tingkat Aggregate + tingkat subsistem + tingkat Release + yang didorong anotasi Manifest, sesuai Model Bawang 5 Tingkat), dengan kunci berupa nama instans yang diberikan penulis pada lampiran tersebut. Setiap entri membawa bidang yang sama — lihat bentuk lampiran di bawah. Lampiran yang ditulis pada salah satu koneksi Component tidak termasuk di dalamnya: lampiran itu dibaca di bawah koneksi tersebut, di.context.uses.<alias>.features.<slot>, sehingga templat yang mengiterasi.featureshanya menemui lampiran milik Component itu sendiri..metadata(struct). Identitas Release untuk penamaan deterministik:release_name,release_version,environment,aggregate_name. Diisi untuk setiap render; nilainya berasal dari blokmetadata:milik Release..source.source:milik Recipe, yang diresolusi oleh evaluasi templat resolusi sumber.niluntuk Recipes tanpa sumber;nilsebelum resolusi sumber berjalan. Pada templat sebuah FeatureRecipe, ini adalahsource:milik FeatureRecipe itu sendiri, tidak pernah milik komponen host — lihat Permukaan FeatureRecipe lampiran..workload. Objek Workload yang telah diurai, diisi setelah dokumenworkload:yang dirender didekode dan lolos validasi yang menjaganya: skema Workload,featuresSchemamilik Component untuk setiap lampiran yang dideklarasikan kontainernya, dan dapat diresolusinya apa yang direferensikan setiap lampiran.niluntuk Recipes yang tidak disintesis;nilsebelum sintesis workload berjalan..steps(map keluaran langkah). Diisi oleh eksekusipipeline:saat plugin Wasm berjalan, mengekspos keluaran yang dikembalikan oleh langkah yang telah selesai kepada langkah berikutnya melalui.steps.<id>.outputs. Sebuah langkah membaca keluaran langkah sebelumnya dari templatwithmiliknya sendiri;outputssebuah langkah hanya terlihat oleh langkah yang dideklarasikan setelahnya. Kosong jika node tidak mendeklarasikan pipeline, dan sebelum langkah pertama node selesai.
Field tingkat atas yang tidak memuat apa pun untuk node ini — .workload pada Recipe yang tidak menyintesis satu pun, .source pada Recipe tanpa source, .features pada Component tanpa lampiran — terbaca sebagai kosong dalam template nilai, persis seperti kunci yang tidak diatur di bawah .values: {{ .workload }} tidak merender apa pun, default di atasnya memberikan nilai cadangannya, dan if atau with di atasnya mengambil cabang false-nya. range di atasnya tidak mengiterasi apa pun. Pembacaan di bawahnya — {{ .workload.containers }} — tetap menghentikan proses, karena tidak ada apa pun yang dapat ditelusuri ke dalamnya. Dan template yang mencetak field semacam itu di tempat yang selalu dijalankan — di luar setiap if, with, dan range — sekaligus mengiterasinya akan berhenti dengan menyebut field tersebut, sebagaimana untuk setiap jalur tanpa isi yang dibaca dengan kedua cara, karena tidak ada satu nilai pun yang tercetak sebagai kosong sekaligus teriterasi sebagai kosong: lihat A template reads and iterates a path that holds nothing (Template membaca dan mengiterasi jalur yang tidak memuat apa pun).
Bentuk lampiran
.features.<name> dan .features.<slot> memiliki bentuk yang sama — satu lampiran, dibaca dengan satu cara:
.type(string). URI katalog dari Feature yang dilampirkan..resolved_version(string). Versi Feature yang dilampirkan setelah resolusi Manifest — versi yang benar-benar terikat untuk build ini, bukan pin yang dinyatakan ulang di sisi konsumen. Mencerminkan.context.uses.<alias>.resolved_version. Kosong apabilatypelampiran tidak teresolusi ke entitas katalog mana pun..labels(map bernilai string). Label katalog dari Feature yang dilampirkan, dibawa apa adanya dalam urutan yang dideklarasikan Feature — tidak ada yang disaring, diganti namanya, atau dihapus prefiksnya, sehingga template membaca persis apa yang ditulis oleh penulis Feature. Mencerminkan.context.uses.<alias>.labels. Tidak ada apabila Feature tidak mendeklarasikan label, dan apabilatypelampiran tidak teresolusi ke entitas katalog mana pun..values(map). Pilar niat pengembang milik lampiran itu sendiri, ditulis pada deklarasi lampiran di dalam Aggregate. Berbeda dari.valuestingkat atas milik komponen host..infra(map). Pilar ukuran operasional milik lampiran itu sendiri, ditulis pada deklarasi lampiran di dalam Release. Berbeda dari.infratingkat atas milik komponen host..provides(map bernilai string). Kontrak publik yang telah teresolusi dari FeatureRecipe yang terikat pada lampiran ini — nama sumber daya yang dihasilkan, kunci datanya, identitas cloud, dan kunci tambahan apa pun yang dipublikasikan FeatureRecipe. Dibaca sebagai.features.<name>.provides.<key>, mencerminkan.context.uses.<alias>.provides: konsumen membaca apa yang dipublikasikan produsen alih-alih menurunkannya kembali. Lampiran yang FeatureRecipe terikatnya tidak mempublikasikan apa pun sama sekali tidak membawa kunciprovides, bukan map kosong, jadi lakukan pemeriksaan sebelum mengakses kunci individual.
.provides adalah yang membuat lampiran dapat dikonsumsi, bukan sekadar hadir. Feature yang mendeklarasikan kontrak schema.provides akan memberlakukan kontrak tersebut terhadap FeatureRecipe yang merealisasikannya — FeatureRecipe harus mempublikasikan setiap kunci yang dideklarasikan — dan konsumen membaca hasilnya di sini. Dengan demikian, Feature identitas yang menghasilkan ServiceAccount dan mempublikasikan namanya memungkinkan Recipe konsumen mengikat padanya:
workload: | serviceAccount: "{{ .features.identity.provides.name }}"Nama yang dihasilkan dinyatakan sekali, oleh produsen, lalu dikonsumsi — tidak pernah dinyatakan ulang di sisi konsumen tempat keduanya dapat tidak sesuai. Contoh workload-identity-binding merender hal ini secara menyeluruh.
.labels adalah yang memungkinkan template menyesuaikan diri dengan apa sebuah lampiran tanpa mencocokkan namanya atau mengurai URI-nya. Compiler tidak membaca satu pun dari label tersebut — compiler membawa string-nya, dan penulis template yang menentukan maknanya.
Feature yang tidak mendeklarasikan label sama sekali tidak membawa .labels, bukan map kosong, jadi lakukan pemeriksaan sebelum mengakses label individual — mengakses kunci yang tidak ada akan menghentikan build. Bacalah label yang mungkin tidak dideklarasikan Feature melalui optional, karena index menghentikan build dengan menyebut kunci tersebut apabila map tidak memuatnya:
{{ if .features.db.labels }}{{ if eq (optional .features.db.labels "feature.aggrega.ai/kind" "") "secret" }}...{{ end }}{{ end }}Karena label tiba apa adanya, namespace milik penulis katalog sampai ke template tanpa perubahan, dan Recipe membaca kunci yang sama dengan yang dideklarasikan Feature.
Blok .context
.context adalah konteks eksekusi yang dirakit oleh compiler untuk satu node — data identitas, topologi, dan pipa pengiriman yang dialirkan renderer ke setiap situs template. Field-nya:
.context.instance_id(string). Identitas node sebagai nama — nilai yang digunakan build itu sendiri untuk menamai dan melabeli apa yang dihasilkannya, sehingga template yang menyusun nama resource atau alamat di dalam cluster darinya dapat memperkirakan nama yang benar-benar dihasilkan build. Untuk node yang dideklarasikan oleh Aggregate Anda sendiri, nilainya adalah nama yang Anda tulis. Untuk node yang disumbangkan oleh Aggregate yang diimpor, nilainya adalah identitas yang diratakan dengan pemisah modul dituliskan (data-layer.main-dbmenjadidata-layer-zdmain-db), karena titik bukan karakter yang dapat dimuat oleh nama resource dan, di dalam alamat cluster, titik memisahkan service dari namespace-nya. Bentuk bertitik adalah bentuk yang digunakan dokumen Anda dan diagnostik build untuk merujuk node tersebut; lihat Konvensi penamaan..context.rendered_name(string). Nama yang diberikan provider node kepada resource yang di-render-nya untuk node tersebut — dari sumber yang Anda berikan, seperti nama release yang dibaca chart, dan dari workload yang disintesisnya di mana ia menamai resource workload tersebut menurut nama miliknya sendiri, seperti yang dilakukanhelmdengan nama release yang sama. Hanya ada jika provider tersebut menurunkan nama. Pada template attachment Feature, nilainya adalah nama komponen host, sebagaimana.context.instance_iddi sana adalah identitas host; lihat Menamai resource yang di-render..context.labels(map bernilai string). Label yang ditulis di katalog ditambah setiap tambahanlabel-transformyang dibuat saat konstruksi topologi..context.annotations(tiga bucket, lihat di bawah). Anotasi bertingkat yang dikelompokkan menurut asalnya..context.inject(map mekanisme, lihat di bawah). Pipa pengiriman yang telah di-hydrate sebelumnya dan diintersepsi — permukaan standar yang dibaca template Recipe untuk nilai lintas komponen..context.uses(map koneksi, lihat di bawah). Proyeksi JOIN atas edge topologi keluar..context.self_inject(peta mekanisme, lihat di bawah). Untuk setiap nama yang ditulis pengembang di blokinject:milik komponen itu sendiri, kunci provides milik sendiri yang dikirimkan entri tersebut atau satu-satunya nilai milik sendiri yang dibaca templatnya..context.used_by(list, lihat di bawah). Komponen-komponen yang entriuses-nya menunjuk ke komponen ini. Dibaca oleh FeatureRecipe yang dilampirkan ke komponen, pada template yang menghasilkan resource milik attachment itu sendiri; kosong di tempat lain..context.render_facts(map berisi list, lihat di bawah). Apa yang dilaporkan provider komponen tentang output yang di-render-nya, dengan kunci nama fakta. Dibaca oleh FeatureRecipe yang dilampirkan ke komponen, pada setiap templatenya yang berjalan setelah komponen selesai di-render; tidak ada di tempat lain.
.context.annotations — tiga bucket
Anotasi mengalir bertingkat ke dalam tiga bucket dengan kunci asalnya:
.context.annotations.release— anotasi batas Release (Domain 4). Digunakan untuk mengatur realitas fisik; renderer mengarahkannya ke fieldinfra:jika sesuai. Anotasi terkenalaggrega.ai/*berada di bucket ini..context.annotations.catalog— anotasi metadata Component dari Domain 2. Sifat intrinsik yang tidak dapat diubah, ditulis oleh Architect; terutama dikonsumsi oleh plugin kebijakan Wasm..context.annotations.aggregate— anotasi subsistem Aggregate dari Domain 1. Metadata kognitif; renderer mengarahkannya ke payloadvalues:jika sesuai.
Setiap bucket adalah map datar string-ke-string. Menurut aturan pemisahan dalam arsitektur, bucket-bucket ini dimaksudkan untuk penggunaan yang berbeda; engine tidak menegakkan pemisahan tersebut, sehingga disiplin penulisanlah yang menjaga bucket tetap selaras dengan semantik yang dimaksudkan. Lihat bab 6 §2 Alur 5 untuk desain anotasi bertingkat.
.context.inject — pipa pengiriman
Pipa ini adalah map pengiriman compiler yang telah di-resolve sebelumnya. Pada saat template Recipe berjalan pada rendering dasar, setiap sumber inject (literal self-inject yang ditulis developer, referensi self-inject from: yang di-resolve terhadap provides milik sendiri, referensi lintas komponen uses[].inject yang di-resolve terhadap provides target, intersepsi injectMapping FeatureRecipe) telah di-resolve menjadi nilai string akhir dan digabungkan ke dalam map ini.
Field:
.context.inject.env— map bernilai string dari nama-variabel-lingkungan → nilai yang di-resolve..context.inject.file— map bernilai string dari path-file → nilai yang di-resolve..context.inject.arg— map bernilai string dari flag-argumen → nilai yang di-resolve..context.inject.all— map bernilai string yang menggabungkan mekanismeenv/file/arg/kustom menjadi satu kamus datar; berguna untuk serialisasi seluruh pipa ({{ toJson .context.inject.all }}).
Sebuah mekanisme hanya ada di pipa ketika sesuatu dikirim melaluinya. Templat yang membaca mekanisme yang tidak dipakai untuk mengirim apa pun — .context.inject.file tanpa pengiriman file — membacanya sebagai kosong, sebagaimana templat nilai membaca kunci apa pun yang tidak ada, dan range atasnya tidak me-render apa pun; pembacaan itu menyediakan nilai kosong untuk seluruh templat, sehingga {{ toJson .context.inject }} dalam templat yang sama menampilkan "file": "". hasKey .context.inject "file" memberi tahu apakah ada sesuatu yang dikirim melaluinya.
- Mekanisme kustom (misalnya,
ssm_param) — dapat dibaca dengan nama field-nya sendiri,.context.inject.<mechanism>.<key>, persis seperti tiga mekanisme inti. Nilai mekanisme kustom mencapai pipa dari self-inject tingkat komponen, dari edgeuses[].inject, dari pemetaaninject:pada attachment Feature, dan dari outputinjectMappingFeatureRecipe. Untuk self-inject tingkat komponen, allowlistspec.injectmilik Component harus menyebutkan mekanisme tersebut, dan mekanisme yang tidak disebutkan allowlist akan menghentikan build. Entri mekanisme kustom juga muncul di.context.inject.allbersama tiga mekanisme inti. Mekanisme kustom boleh memakai nama apa pun kecualiall: nama itu adalah tampilan gabungan itu sendiri, sehingga mekanisme dengan nama itu tidak akan pernah dapat dibaca secara tersendiri. Blok inject yang menamai sebuah mekanismeall, dan allowlist Component atau Feature (spec.inject,injectmilik socket) yang mencantumkannya, menghentikan build saat dokumen dimuat, dan penolakannya menjelaskan bahwa nama tersebut milik tampilan gabungan ini. Nama peka huruf besar-kecil, sehinggaALLadalah mekanisme kustom biasa.
Pipa ini adalah keadaan pasca-intersepsi — blok injectMapping FeatureRecipe telah melakukan deep-merge atas override-nya ke pipa ini selama pemetaan inject, pada saat template Recipe membacanya. Sebuah pemetaan dapat mengganti kunci yang dikirimkan oleh blok inject: milik komponen sendiri, oleh salah satu blok inject: koneksinya, atau oleh blok inject: attachment-nya sendiri; kunci yang sama-sama dikirimkan oleh dua Features yang dilampirkan, melalui blok inject: atau pemetaannya, akan menghentikan build alih-alih mencapai pipa ini dengan salah satu dari kedua nilai. Feature yang dilampirkan ke batas Release mencapai komponen dengan cara yang sama, melalui injectMapping FeatureRecipe-nya, yang berjalan dalam konteks komponen itu sendiri apa pun executionScope FeatureRecipe tersebut — penulisan ulang variabel host konsumen oleh compose bridge adalah salah satu pemetaan semacam itu, yang tunduk pada aturan yang sama.
.context.self_inject — nilai milik sendiri mana yang dikirimkan oleh setiap nama dari pengembang
Jika sebuah Component mendeklarasikan spec.inject, pengembang dapat menulis blok inject: pada komponen itu sendiri dan memilih nama-nama yang digunakan untuk mengirimkan nilai dan provides milik komponen. .context.inject memuat hasil resolusi entri-entri tersebut dan .inject_raw memuatnya sebagaimana ditulis; .context.self_inject menyatakan, untuk setiap entri, kunci provides milik komponen yang dikirimkannya atau satu-satunya nilai milik sendiri yang dibaca templatnya. Bentuknya sama dengan .context.uses.<alias>.inject milik sebuah koneksi — mekanisme, lalu nama dari pengembang, lalu sebuah kunci — dengan kunci yang menyebut salah satu provides atau nilai milik komponen:
provides.<key>— entri yang ditulis denganfrom: <key>, yang mengirimkan salah satu provides milik komponen.values.<key>— entri yang templatvalue:-nya membaca tepat satu nilai milik komponen dan tidak ada yang lain, dengan<key>sebagai kunci tingkat atas nilai tersebut. Teks atau fungsi di sekitar pembacaan tidak berpengaruh, begitu pula seberapa dalam templat membaca ke dalam nilai:'{{ .values.role }}','role={{ .values.role | upper }}', dan'{{ with .values.role }}{{ . }}{{ end }}'semuanya dipetakan kevalues.role, dan'{{ .values.config.port }}','{{ index .values.config "port" }}', dan'{{ (default dict .values.config).port }}'semuanya dipetakan kevalues.config.- string kosong — setiap entri lainnya: literal, templat yang membaca dua nilai, templat yang membaca apa pun selain nilai (
.infra,.metadata,.context), dan templat yang pembacaan nilainya tidak dikaitkan oleh teks ke satu kunci tingkat atas — nilai yang diserahkan ke fungsi melalui akarnya (index .values "role"), nilai yang dibaca secara utuh (toJson .values, atau field yang dibaca di dalam{{ with .values }}atau melalui variabel yang terikat ke.values), atau seluruh konteks yang diteruskan (toJson .).
# The developer's block on the component, in the Aggregateinject: env: - { in: SERVICE_HOST, from: host } - { in: AGENT_ROLE, value: '{{"{{"}} .values.role }}' } - { in: MODE, value: batch } - { in: ROLE_AND_GOAL, value: '{{"{{"}} .values.role }}-{{"{{"}} .values.goal }}' } ssm_param: - { in: /app/goal, value: '{{"{{"}} .values.goal }}' }
# What the Recipe reads at .context.self_injectenv: SERVICE_HOST: provides.host AGENT_ROLE: values.role MODE: "" ROLE_AND_GOAL: ""ssm_param: /app/goal: values.goalDi dalam Aggregate, setiap templat value: diawali dengan {{"{{"}} alih-alih {{, karena seluruh teks Aggregate dibaca sekali sebagai templat, untuk interpolasi parameter, sebelum templat milik blok itu sendiri dievaluasi; templat yang dikutip dalam daftar di atas ditampilkan sebagaimana terbaca setelah escape tersebut. Lihat Teks yang membawa kurung kurawal gandanya sendiri.
Inilah yang memungkinkan sebuah Recipe yang menjalankan image milik pengembang sendiri memperlakukan nama variabelnya sendiri untuk nilai milik komponen sebagai default — konvensi katalog pustaka standar, yang dapat dipilih secara berbeda oleh katalog perusahaan. Sebelum mengirimkan nilai milik sendiri dengan nama miliknya sendiri, Recipe semacam itu memeriksa apakah blok pengembang sudah mengirimkan nilai tersebut, dan melewati default-nya jika demikian — sehingga pengembang yang mengganti nama satu nilai tetap mempertahankan semua default lainnya:
workload: | containers: main: variables: {{- range $name, $value := .context.inject.env }} {{ $name }}: {{ $value | quote }} {{- end }} {{- $named := dict }} {{- with .context.self_inject.env }}{{ range $name, $key := . }}{{ $_ := set $named $key true }}{{ end }}{{ end }} {{- if not (hasKey $named "values.role") }} APP_ROLE: {{ .values.role | quote }} {{- end }}.context.self_inject ada pada setiap render dan kosong jika pengembang tidak menulis blok. Sebuah mekanisme hanya muncul jika blok menyebutnya, jadi lindungi pembacaan mekanisme yang mungkin tidak disebut oleh blok, seperti yang dilakukan with di atas. Templat menerima nama-nama dalam keadaan terurut bagaimanapun ia membacanya, sebagaimana ia menerima setiap peta. Peta ini dibaca dari teks yang ditulis pengembang; tidak ada isinya yang merupakan nilai hasil resolusi, dan kompiler tidak memberikan makna apa pun pada nama maupun kunci.
.context.uses — proyeksi JOIN
.context.uses adalah tampilan yang diperkaya oleh compiler atas setiap edge topologis keluar dari node saat ini. Setiap entri map dikunci oleh alias socket lokal (misalnya, databases.primary menjadi .context.uses.primary ketika Aggregate menulis uses: { databases: { primary: { target: ... } } }) dan membawa proyeksi JOIN dari state target yang telah di-resolve beserta kontrak pengiriman sisi pemanggil:
.target(string) — ID instance node target..socket(string) — nama socket sisi pemanggil (kunciusesSchema)..provides(map bernilai string) — kunciprovides:target yang telah di-resolve (string output publik yang diekspor Recipe target saat evaluasi provides)..inject(map dari mekanisme → map dari kunci → nilai) — direktif inject sisi pemanggil untuk edge ini (blokinject:pada deklarasiuses[].inject). Kunci mekanisme adalahenv/file/arg/kustom; entri map per mekanisme adalah referensi kunci-lokal → kunci-provides-target..labels(map bernilai string) — label milik target, tidak pernah milik komponen konsumen: himpunan yang dibawa.context.labelsmilik target sendiri, yaitu label yang ditulis di katalog ditambah tambahanlabel-transformapa pun yang dibuat saat konstruksi topologi..annotations(tiga bucket) — bucket anotasirelease/catalog/aggregatemilik target..component(string) — URI tipe Component target..resolved_version(string) — versi Component target setelah resolusi Manifest..boundary_path(string) — path boundary Release target, diisi baik target berada di boundary pemanggil maupun di boundary lain..origin_feature(string) — diisi ketika edge disintesis oleh attachment Feature (misalnya, Feature sidecar yang menyumbangkan edgeuseske Feature kredensial)..values(map) — konfigurasi developer per-edge yang telah di-resolve untuk koneksi ini, ditulis pada entriusesmilik Aggregate. Hanya ada ketika edge membawa values per-edge..infra(map) — konfigurasi operator per-edge yang telah di-resolve untuk koneksi ini, ditulis pada entriusesmilik Release. Hanya ada ketika edge membawa infra per-edge..origin_release(boolean) —trueketika Release yang menyambungkan koneksi ini, bukan Aggregate yang mendeklarasikannya; tidak ada untuk koneksi yang dideklarasikan Aggregate..features(map attachment) — attachment yang ditulis pada koneksi ini, dikunci oleh nama slot yang dideklarasikan socket; lihat di bawah. Hanya ada ketika koneksi membawa attachment..render_facts(map berisi list) — apa yang dilaporkan render target tentang output yang dihasilkannya, dikunci oleh nama fakta, dalam bentuk yang sama dengan.render_factsmilik pemanggil pada.context.used_by: setiap fakta berupa list, dengan panggilan provider milik target sendiri lebih dulu lalu setiap Features-nya sesuai urutan render, dan list yang didapat satu nama dari masing-masing digabung menjadi satu. Hanya ada untuk FeatureRecipe yang menetapkanreadsTargetRenderFacts: true— attachment-nya dirender setelah setiap komponen selesai dirender, sehingga render setiap target sudah lengkap — lalu ada pada setiap koneksi, kosong untuk target yang provider-nya tidak melaporkan apa pun. Hanya dibaca divaluesMapping:,workload:danartifacts:milik FeatureRecipe tersebut; tidak ada di template Recipe milik komponen itu sendiri, diinjectMapping:, diwith:danwhen:pada langkahpipeline:, dan di setiap FeatureRecipe yang tidak menetapkan kunci tersebut — template milik FeatureRecipe semacam itu yang membacanya menghentikan build sebelum apa pun dirender.
Kedua map konfigurasi per-edge bercakupan konsumen: keduanya hanya masuk ke konteks render node konsumen, tidak pernah ke konteks render target.
Nilai yang disediakan dibaca di .provides.<name> — nama-nama yang disediakan bersarang di bawah .provides alih-alih langsung berada pada edge, sehingga .context.uses.<alias>.<name> tidak menunjuk field apa pun dan tidak menghasilkan apa-apa.
Pada koneksi yang kedua ujungnya di-render ke output yang berbeda, .provides memuat pengganti, bukan nilainya. Ketika provider menghubungkan koneksi semacam itu dengan referensinya sendiri setelah kedua output dirakit — misalnya stack CloudFormation yang membaca nilai stack lain — setiap nilai yang dibawa .context.uses.<alias>.provides adalah placeholder yang kemudian diganti provider dengan referensi lintas stack atau dengan nilai itu sendiri, sebagaimana dijelaskan halamannya sendiri. Nilai semacam itu harus disalin, bukan dibandingkan — aturan yang sama yang diikuti nilai yang dikirim koneksi semacam itu pada pipa inject, yang juga merupakan placeholder sejenis. Tuliskan secara utuh, di dalam string yang lebih panjang, atau melalui fungsi yang membiarkannya apa adanya, seperti quote. Templat yang membandingkan nilai yang dibacanya dari .provides, bercabang berdasarkan nilai itu, mengukurnya, atau mengubahnya akan memutuskan berdasarkan placeholder, sehingga build justru berhenti, dengan menyebutkan templat itu dan setiap nilai yang dibacanya; bercabanglah berdasarkan nilai milik komponen pengonsumsi sendiri. Penghentian ini mencakup setiap templat yang membaca .provides milik koneksi, termasuk injectMapping: dari FeatureRecipe yang dilampirkan, dan FeatureRecipe lingkup batas yang membaca koneksi yang sama di bawah .boundary. Koneksi yang kedua ujungnya di-render ke satu output membawa nilainya apa adanya.
Satu alias menamai satu koneksi, sehingga map memuat satu entri untuk setiap koneksi yang dibuat komponen. Map dikunci hanya oleh alias, apa pun socket tempat koneksi disambungkan, dan tidak ada dua koneksi dari satu komponen yang berbagi alias — tidak pada satu socket maupun pada dua socket, dokumen atau attachment mana pun yang menuliskan masing-masing. Build menolak pasangan semacam itu, dengan menyebutkan kedua koneksi dan tempat masing-masing ditulis, sebelum apa pun dirender. List yang menyebut satu target dua kali merupakan pasangan semacam itu, karena alias entri list adalah target-nya; begitu pula koneksi local pada socket models di samping koneksi local pada socket databases.
Template Recipe menggunakan proyeksi ini untuk mencari state sisi target tanpa menelusuri graf IR. Template injectMapping milik FeatureRecipe menggunakannya untuk menjangkau anotasi target guna keputusan routing lintas boundary (pola resolver DNS K8s yang didokumentasikan di entities/featurerecipe.md adalah contoh kerja kanonisnya).
Template yang melakukan range atas .context.uses melihat koneksi dalam urutan kunci — diurutkan menurut alias — bukan dalam urutan penulisan oleh Aggregate. Setiap map yang di-range oleh template dikunjungi dengan cara itu, termasuk .features dan .features milik koneksi, sehingga template tidak pernah memperoleh kembali urutan penulisan dengan melakukan range atas map; ketika urutan bermakna, permukaan penulisan memodelkannya sebagai list. Bagaimanapun, output yang dirender identik byte demi byte di setiap build dari input yang sama.
Attachment sebuah koneksi — .context.uses.<alias>.features
Attachment yang ditulis pada koneksi — di bawah features: pada entri uses sebuah komponen di Aggregate, atau pada entri Release untuk koneksi tersebut — mengisi slot yang dideklarasikan socket. Attachment tersebut merupakan attachment milik komponen konsumen untuk segala hal yang dilakukan build terhadapnya: Manifest mengikat realisasinya, FeatureRecipe-nya dirender di sisi konsumen, dan kontrak provides-nya ditegakkan. Template membacanya di bawah koneksi tempat attachment itu ditulis:
{{- range $alias, $edge := .context.uses }}- name: {{ $alias }} api_base: {{ $edge.provides.endpoint }} {{- with $edge.features }}{{ with .credential }} api_key_secret: {{ .provides.name }} api_key_key: {{ .provides.key }} {{- end }}{{ end }}{{- end }}- Dikunci oleh slot.
.context.uses.<alias>.features.<slot>menyebut slot yang dideklarasikan socket koneksi —credentialdi atas — sehingga konsumen yang menjangkau beberapa target membaca kredensial masing-masing target di bawah alias target tersebut. Koneksi yang tidak membawa attachment tidak memiliki.features, itulah sebabnya pembacaan tersebut dijaga. - Bentuk attachment. Setiap entri membawa persis apa yang dibawa
.features.<name>untuk salah satu attachment milik komponen itu sendiri —.type,.resolved_version,.labels,.values,.infra, dan.providesyang telah di-resolve dari FeatureRecipe yang terikat padanya — lihat bentuk attachment. Provides yang dibaca di sini adalah yang dipakai FeatureRecipe milik attachment itu sendiri saat merender, sehingga nama yang dirujuk konsumen dan nama resource yang dihasilkan FeatureRecipe tersebut adalah satu nilai yang dievaluasi. - Tidak pernah di
.features..featuresmilik komponen itu sendiri hanya memuat attachment yang ditulis pada bloknya sendiri. Recipe yang melakukan range atas.featuresdan memilih attachment menurut tipe —{{ range $name, $f := (default dict .features) }}{{ if eq $f.type "core/referenced-secret" }}…— karenanya tidak pernah bertemu kredensial sebuah koneksi, bahkan yang berasal dari Feature yang sama: template menjangkau attachment sebuah koneksi melalui koneksinya, tidak pernah melalui.features. Hal yang sama berlaku di setiap permukaan yang menampilkan attachment sebuah komponen, termasuk konteksassertions.
Komponen yang menggunakan komponen ini — .context.used_by
.context.uses melihat ke luar, ke koneksi yang dibuat sebuah komponen. .context.used_by melihat ke dalam, ke komponen yang entri uses-nya menunjuk ke komponen ini. FeatureRecipe yang dilampirkan ke komponen membacanya, dan di sanalah tempat sumber daya yang mendeskripsikan atau membatasi koneksi tersebut — misalnya, kebijakan jaringan yang hanya mengizinkan komponen yang dideklarasikan untuk memanggil komponen ini:
artifacts: callers.yaml: | apiVersion: v1 kind: ConfigMap metadata: name: {{ .context.rendered_name }}-{{ .attachment_name }} data: callers: | {{- range .context.used_by }} - component: {{ .component_id }} socket: {{ .socket }} selector: {{ .provides.selector }} {{- with .source_namespace }} namespace: {{ . }} {{- end }} {{- end }}Setiap entri memuat:
.component_id(string) — ID instans komponen yang terhubung dalam bentuk datarnya (frontend,data-layer.etl), yaitu nilai yang dibaca templat pathsubDirectory:sebagai.component_id..socket(string) — socket yang diisi koneksi pada komponen yang terhubung (kunciusesSchema-nya)..provides(map bernilai string) — apa yang dipublikasikan komponen yang terhubung, dipersempit ke kunci yang dideklarasikan Component-nya: nilai yang sama dengan yang dibaca konsumen komponen tersebut di.context.uses.<alias>.provides. Kunci yang dipublikasikan Recipe komponen tanpa dideklarasikan oleh Component-nya tidak termasuk di dalamnya..source_namespace(string) — namespace tempat komponen yang terhubung ditempatkan: anotasiaggrega.ai/namespaceyang berlaku padanya, diturunkan melalui batas-batasnya, dengan entrinya sendiri di Release yang diutamakan. Komponen yang entri Release-nya menetapkan namespace, atau mengosongkannya dengannull, membawa pengaturannya sendiri alih-alih pengaturan batasnya, sehingga nilai ini menyebut namespace tempat sumber daya komponen itu sendiri dirender. Tidak ada jika tidak ada namespace yang berlaku pada komponen; bacalah melaluiwithatauif, seperti dalam contoh, alih-alih mencetaknya langsung..source_boundary_path(string) — path batas Release yang memuat komponen yang terhubung, dengan batas bersarang digabung oleh/(edge,edge/inner)..render_facts(map berisi list) — apa yang dilaporkan render komponen yang terhubung tentang keluaran yang dihasilkannya, dikunci berdasarkan nama fakta, dengan bentuk yang sama seperti.context.render_facts. Setiap fakta adalah list, sehingga templat selalu melakukan range atasnya, bahkan ketika hanya berisi satu entri. Entrinya dapat berasal dari render komponen yang terhubung itu sendiri dan dari render Features yang dilampirkan padanya: list yang diperoleh satu nama dari masing-masing digabung menjadi satu, panggilan provider milik komponen itu sendiri terlebih dahulu, lalu setiap Features-nya sesuai urutan render. Hanya ada untuk FeatureRecipe yang menetapkanreadsCallerRenderFacts: true— lampirannya dirender setelah setiap komponen selesai dirender, sehingga render setiap pemanggil sudah lengkap — dan kemudian ada pada setiap entri, kosong untuk pemanggil yang provider-nya tidak melaporkan apa pun. FeatureRecipe yang tidak menetapkan kunci tersebut tidak melihat.render_factspada entri mana pun, dan templatnya yang membacanya akan menghentikan build sebelum apa pun dirender.
Kedua nilai penempatan ini adalah nilai yang dibaca FeatureRecipe lingkup batas sebagai source_namespace dan source_boundary_path pada entri koneksi yang sama dalam list edge .boundary-nya: kedua tampilan membaca penempatan komponen dengan cara yang sama, sehingga keduanya tidak pernah berbeda pendapat tentangnya. Edge dalam list tersebut juga membawa path perakitan setiap endpoint — source_assembly_path dan target_assembly_path, direktori di bawah direktori output build tempat provider endpoint merakitnya — yang tidak dibawa oleh entri .context.used_by.
FeatureRecipe yang menetapkan readsCallerRenderFacts: true membaca fakta setiap pemanggil dengan cara yang sama seperti membaca fakta host. Untuk provider yang mendokumentasikan fakta bernama ports yang setiap entrinya memuat port:
artifacts: callers.yaml: | callers: {{- range .context.used_by }} - component: {{ .component_id }} ports: {{- range .render_facts.ports }} - {{ .port }} {{- end }} {{- end }}Pemanggil yang provider-nya tidak melaporkan ports merender ports: kosong alih-alih gagal, karena nama yang tidak dilaporkan siapa pun dibaca sebagai kosong.
Perilaku list ini:
- Sesuai urutan penulisan. Entri mengikuti urutan penulisan komponen yang terhubung, lalu urutan entri
usesmasing-masing. Komponen yang terhubung dua kali muncul dua kali, sekali per koneksi. Karena ini list dan bukan map,rangemenemui para pemanggil dalam urutan tersebut — tidak ada yang diurutkan. - Hanya di tempat lampiran merender sumber dayanya sendiri.
valuesMapping:,workload:danartifacts:milik FeatureRecipe membacanya. Nilainya kosong dalam templat Recipe milik komponen itu sendiri, dalaminjectMapping:, dan dalamwith:sertawhen:pada langkahpipeline:, karena apa yang dihasilkan masing-masing dapat masuk ke keluaran render komponen itu sendiri:injectMapping:menulis pipa pengiriman komponen, dan langkah pipeline dapat menulis ulang dokumen komponen. Itulah yang menjaga keluaran komponen tetap sama siapa pun yang menggunakannya — menghubungkan satu pemanggil lagi ke sebuah komponen mengubah keluaran Feature yang dilampirkan padanya yang membaca pemanggilnya, dan tidak mengubah apa pun yang dirender komponen itu sendiri. - Tidak ada apa pun tentang koneksi itu sendiri. Entri tidak memuat
valuesatauinfraper koneksi maupun lampiran koneksi; semua itu tetap bersama komponen konsumen, di bawah.context.uses.<alias>-nya. - Kosong jika tidak ada yang menggunakan komponen.
rangeatasnya kemudian tidak merender apa pun. - Diteruskan, tidak pernah ditafsirkan. Identitas, socket, nilai yang dipublikasikan, dan penempatan adalah string yang diteruskan compiler, dan fakta render adalah apa yang dilaporkan provider setiap pemanggil, dikunci berdasarkan nama. Compiler tidak menyimpulkan apa pun dari nama, tidak mengambil apa pun, dan tidak memutuskan apa pun tentang pemanggil mana yang harus diizinkan sebuah sumber daya; templatlah yang memutuskan.
Apa yang dilaporkan provider tentang sebuah render — .context.render_facts
Provider sebuah komponen dapat melaporkan fakta tentang keluaran yang direndernya — properti dokumen yang ditulisnya yang hanya dapat dilihat melalui pengetahuannya sendiri tentang formatnya. Fakta apa yang dilaporkan provider, dengan nama apa dan dengan isi apa di setiap entri, adalah kontrak terdokumentasi milik provider itu sendiri; lihat Reporting facts about what a guest emitted untuk sisi provider. Provider helm, misalnya, melaporkan label templat pod yang dihasilkannya, selector controller dan Services-nya, serta port container-nya — lihat fakta render-nya. FeatureRecipe yang dilampirkan ke komponen membaca apa yang dilaporkan provider komponen di .context.render_facts, dikunci berdasarkan nama fakta. Untuk provider yang mendokumentasikan fakta bernama ports yang setiap entrinya memuat name dan port:
artifacts: ports.yaml: | ports: {{- range .context.render_facts.ports }} - name: {{ .name }} port: {{ .port }} {{- end }}- Setiap fakta adalah list. Provider melaporkan setiap fakta sebagai list, bahkan ketika hanya berisi satu entri, sehingga templat selalu melakukan range atasnya — tidak ada nilai tunggal untuk dibaca secara tersendiri.
- Satu list per nama, digabung di seluruh render komponen. Merender sebuah komponen dapat memerlukan lebih dari satu panggilan provider-nya — misalnya render chart dan penempatan artefak — dan setiap panggilan melaporkan untuk dirinya sendiri. List yang diperoleh satu nama dari panggilan-panggilan tersebut digabung menjadi satu, sesuai urutan panggilan dijalankan. Apa yang dirender Features yang dilampirkan ke komponen tidak termasuk di sini: Feature hanya membaca render milik komponen itu sendiri di
.context.render_facts, apa pun yang dihasilkan Features lain milik komponen. - Pada setiap templat FeatureRecipe yang dilampirkan.
valuesMapping:,workload:danartifacts:-nya membacanya, demikian pulawith:danwhen:pada langkahpipeline:-nya — fakta berasal dari render komponen itu sendiri, sehingga membacanya tidak membuat apa pun bergantung pada siapa yang terhubung ke komponen. Nilai ini tidak ada dalam templat Recipe milik komponen itu sendiri dan dalaminjectMapping:, yang berjalan sebelum komponen dirender. - Kosong, bukan tidak ada. Jika provider komponen tidak melaporkan apa pun,
.context.render_factsadalah map kosong, dan nama yang tidak dilaporkan siapa pun dibaca sebagai kosong, sehinggarangeatasnya tidak merender apa pun alih-alih gagal. - Urutan. List mempertahankan entrinya sesuai urutan provider melaporkannya. Entri objek adalah map berkunci seperti map lain dalam konteks, sehingga templat yang melakukan range atasnya menemui kuncinya dalam urutan kunci.
- Diteruskan, tidak pernah ditafsirkan. Compiler hanya memeriksa bahwa nilai setiap fakta adalah list. Compiler tidak membaca apa pun tentang arti sebuah nama atau entri; templatlah yang memutuskan apa yang dilakukan dengannya.
.uses milik asersi — dikunci berdasarkan soket, lalu berdasarkan alias
Templat assertions: membaca koneksi yang sama melalui tampilan tersendiri yang lebih sempit: .uses di root alih-alih di bawah .context, dan tidak membawa apa pun yang dipublikasikan oleh target koneksi, karena kedua fase asersi dievaluasi sebelum perenderan. Bentuknya mencerminkan bentuk penulisan uses: <socket>: <alias>: { target: … } — dikunci berdasarkan soket, dan di bawah setiap soket berdasarkan alias setiap koneksi padanya; koneksi yang ditulis sebagai entri daftar memakai targetnya sebagai alias. Entri setiap koneksi membawa target, alias dan, untuk koneksi yang dibuat oleh lampiran Feature, origin_feature, serta tiga fakta yang dibawa .context.uses, dengan nama yang sama dan memuat nilai yang sama: .labels, label milik target; .values, nilai yang ditulis pada koneksi; dan .features, lampiran yang ditulis padanya, dikunci berdasarkan slot. Ketiganya ada pada setiap entri, kosong bila koneksi tidak membawanya. Lampiran di bawah .features hanya membawa type, resolved_version dan values — bentuk yang dipakai asersi untuk membaca setiap lampiran, termasuk lampiran milik komponen itu sendiri, karena FeatureRecipe sebuah lampiran belum menyelesaikan provides-nya saat asersi dijalankan.
Soket yang memuat satu koneksi dan soket yang memuat beberapa koneksi memiliki bentuk yang sama, sehingga asersi membaca keduanya dengan cara yang sama. Untuk komponen yang entri Aggregate-nya menulis uses: { models: { local: { target: llama }, fast: { target: turbo } } }:
assertions: two-models-wired: | {{- if lt (len (optional .uses "models" dict)) 2 -}} {{- fail "wire two models to the models socket" -}} {{- end -}} local-is-llama: | {{- if and (hasKey .uses "models") (hasKey .uses.models "local") (ne .uses.models.local.target "llama") -}} {{- fail (printf "the local connection must point at llama; it points at %s" .uses.models.local.target) -}} {{- end -}}hasKey .uses "models" menanyakan apakah soket tersebut terhubung, len menghitung koneksinya, range atasnya mengunjungi setiap koneksi menurut urutan alfabetis aliasnya, dan .uses.models.local.target membaca satu koneksi. .uses.models.target tidak merujuk ke koneksi mana pun, dan menghentikan proses di bawah missingkey=error milik permukaan asersi. Setiap koneksi memiliki entrinya sendiri, dengan alasan yang sama seperti map pada konteks render: dua koneksi dari satu komponen tidak pernah berbagi alias, karena build menolaknya sebelum asersi apa pun dijalankan. Konteks asersi lengkap didokumentasikan di assertions-block.md.
Permukaan terkait inject
Konteks templat memuat bidang-bidang berbentuk inject ini, masing-masing dengan semantiknya sendiri. Penulis Recipe dan FeatureRecipe perlu mengetahui permukaan mana yang harus dibaca.
| Permukaan | Jenis | Diisi ketika | Penggunaan |
|---|---|---|---|
.context.inject | map mekanisme (selalu ada) | Setiap render | Pipa pengiriman standar yang telah dihidrasi sebelumnya — baca ini di templat valuesMapping:/workload:/artifacts: dan di setiap situs templat FeatureRecipe. |
.inject (tingkat atas) | map mekanisme (nullable) | Saat me-render FeatureRecipe sebuah lampiran, jika lampiran tersebut menulis blok inject: | Entri inject: milik attachment itu sendiri, di bawah setiap mekanisme yang disebutkan bloknya — env, file, arg, atau mekanisme kustom seperti vault_ref — dengan setiap nama lokal dipetakan ke kunci yang disebutkan oleh from:-nya. Kunci itu adalah kunci yang dipublikasikan FeatureRecipe dalam provides:-nya, yang juga dikirimkan compiler ke .context.inject milik komponen, atau kunci yang dikonsumsi sendiri oleh FeatureRecipe yang membaca .inject: entri yang menyebutkan kunci yang tidak dipublikasikan FeatureRecipe menghentikan build, kecuali jika sebuah template yang dievaluasi FeatureRecipe terhadap konteks ini — valuesMapping:, workload:, artifacts:, omits: miliknya, atau with: atau when: sebuah langkah pipeline — membaca .inject melalui path yang disebutkan template: .inject, .inject.env, {{ with .inject }} dan sejenisnya, bukan penyerahan seluruh konteks seperti toJson .. injectMapping: miliknya tidak dihitung, karena dievaluasi terhadap konteks komponen, tempat .inject tidak ada. Blok sebuah attachment tidak membawa literal: entri value: di sana menghentikan build, dan literal yang dibutuhkan komponen ditulis di blok inject: milik komponen itu sendiri. Mekanisme kustom dibaca di .inject.<mechanism> persis seperti .inject.env, dan entrinya muncul di .inject.all bersama tiga mekanisme inti. Pembacaan bertitik atas mekanisme yang tidak ditulis attachment berhenti sebagai kunci yang tidak dikenal, bahkan di dalam if atau with, tempat .context.inject.<mechanism> terbaca kosong; bacalah mekanisme yang mungkin tidak ditulis attachment melalui {{ with .inject }}{{ if hasKey . "<mechanism>" }}{{ index . "<mechanism>" "<key>" }}{{ end }}{{ end }}, yang dapat di-build baik attachment menulis mekanisme tersebut atau blok inject: apa pun maupun tidak. Tidak ada pada template Recipe dasar dan pada attachment yang tidak menulis blok inject: apa pun. |
.inject_raw (tingkat atas) | map mekanisme (nullable) | Diatur ketika pengembang menulis blok inject: pada komponen induk | Maksud pengembang yang belum diubah sebelum intersepsi inject-mapping apa pun. Setiap mekanisme yang disebutkan blok itu — env, file, arg, atau mekanisme kustom seperti ssm_param — berada di bawah namanya sendiri, memuat entri persis seperti yang ditulis (in dengan from atau value), dalam urutan penulisannya: .inject_raw.ssm_param membaca mekanisme kustom dengan cara yang sama seperti .inject_raw.env membaca mekanisme inti. Gunakan untuk pemeriksaan logika “apakah pengembang semula meminta kunci pengiriman ini?”; kebal terhadap penulisan ulang injectMapping oleh FeatureRecipe. nil jika pengembang menghilangkan blok inject:. |
.context.self_inject | map mekanisme (selalu ada) | Setiap render; kosong jika pengembang tidak menulis blok inject: pada komponen | Setiap nama dalam blok inject: milik komponen itu sendiri, dipetakan ke kunci milik sendiri yang dikirimkan entrinya — provides.<key>, values.<key>, atau kosong. Gunakan untuk melewati nama default bagi nilai milik sendiri yang sudah dikirimkan pengembang; lihat di atas. |
Penulis yang memerlukan pengiriman yang telah diselesaikan pasca-intersepsi sebaiknya membaca .context.inject. Penulis yang memerlukan maksud asli yang tidak dapat diubah (misalnya, untuk mendeteksi intersepsi atau untuk menghasilkan perilaku cadangan ketika pengembang menghilangkan blok inject) sebaiknya membaca .inject_raw. Penulis yang perlu mengetahui nilai milik komponen mana saja yang telah dinamai pengembang sebaiknya membaca .context.self_inject.
Permukaan FeatureRecipe lampiran
Saat renderer mengevaluasi templat FeatureRecipe lampiran, sebuah field tingkat atas tambahan ditetapkan:
.attachment_name(string) — nama instans lampiran: slot yang diisinya dalamfeaturesSchemaentitas pemiliknya, atau nama bebas yang diberikan penulis kepadanya.locals:,provides:,injectMapping:,valuesMapping:danartifacts:milik sebuah FeatureRecipe membacanya untuk menurunkan pengenal sumber daya yang deterministik —{{ .context.rendered_name }}-{{ .attachment_name | replace "_" "-" }}jika provider host melaporkan nama yang dirender, seperti yang dilakukanhelm, dan{{ .context.instance_id }}-{{ .attachment_name }}jika provider tidak melaporkannya — serta untuk menamai lampiran yang sedang diproses.
Templat milik Recipe dasar tidak sedang me-resolve lampiran, sehingga field ini bukan bagian dari konteksnya: templat provides:, locals: atau source: pada Recipe yang mereferensikannya akan berhenti dengan menyebutkan referensi tersebut alih-alih merender nilai kosong. FeatureRecipe dengan executionScope: boundary di-render sekali untuk boundary, bukan sekali per komponen, sehingga field ini juga tidak tersedia bagi templat yang berjalan untuk boundary; injectMapping:-nya berjalan untuk setiap komponen yang dijangkau lampiran dan membaca field ini di sana.
Pada templat yang menghasilkan sumber daya milik lampiran itu sendiri — valuesMapping:, workload: dan artifacts: miliknya — konteks lampiran juga mencantumkan komponen yang menggunakan host-nya, di .context.used_by, dan, jika FeatureRecipe-nya menetapkan readsTargetRenderFacts: true, memuat apa yang dirender oleh setiap komponen yang terhubung dengan host-nya, di .context.uses.<alias>.render_facts. Templat tersebut dan langkah pipeline: miliknya juga membaca apa yang dilaporkan provider host tentang render host, di .context.render_facts. FeatureRecipe dengan cakupan boundary merender sumber dayanya tanpa komponen host dan tanpa .context; sebagai gantinya, ia membaca setiap koneksi ke dalam boundary-nya di bawah .boundary.internal_uses_edges dan .boundary.incoming_cross_boundary_uses_edges. injectMapping:-nya adalah satu-satunya templat yang ditulisnya yang berjalan dalam konteks komponen — konteks setiap komponen yang dijangkau lampiran, termasuk .context.* — dan referensi ke .boundary di sana menghentikan build.
Field ini adalah satu-satunya jalur menuju nama instans lampiran. .context.instance_id adalah komponen host yang sedang di-resolve oleh lampiran — ia menunjukkan host pada setiap permukaan templat yang dievaluasi compiler, termasuk locals: milik FeatureRecipe itu sendiri — sehingga kedua nama tersebut tidak dapat dipertukarkan, dan tidak ada yang dapat menggantikan yang lain.
.source adalah milik lampiran itu sendiri. Templat source: sebuah FeatureRecipe dievaluasi sebelum valuesMapping: miliknya, sebagaimana halnya pada Recipe, dan apa yang dihasilkannya adalah isi .source pada templat yang menghasilkan sumber daya lampiran — valuesMapping:, omits:, workload:, dan artifacts: miliknya — serta pada langkah-langkah pipeline: miliknya. Nilai ini tidak pernah merupakan source komponen host: FeatureRecipe yang tidak mendeklarasikan source:, atau yang templatnya tidak menghasilkan apa pun, tidak membaca apa pun di sana, bahkan pada host yang Recipe-nya mendeklarasikan source. FeatureRecipe dengan cakupan boundary membaca source-nya sendiri pada templat yang sama. Satu-satunya pengecualian adalah injectMapping:, yang berjalan sebelum source lampiran dievaluasi dan membaca .source seperti yang dilakukan Recipe milik komponen host itu sendiri.
.context.rendered_name juga milik komponen host: pada setiap templat lampiran per komponen, ia memuat nama yang dilaporkan provider milik host untuk host tersebut — nilai yang dibaca Recipe milik host — sehingga lampiran menamai sumber daya berdasarkan host-nya dengan {{ .context.rendered_name }}-{{ .attachment_name }} dan mendapatkan nama yang diterima platform bahkan jika identitas host mengandung garis bawah atau huruf kapital. Field ini ada di mana pun provider host melaporkan nama dan tidak ada jika provider tidak melaporkannya, dan membacanya pada host seperti itu akan menghentikan build dari templat mana pun yang ditulis inline oleh FeatureRecipe selain injectMapping: miliknya; lihat Menamai sumber daya yang dirender.
Ketersediaan per situs
Ketersediaan field bervariasi menurut situs template. Template provides: pada Recipe dijalankan saat evaluasi provides dengan konteks mandiri (tanpa .context.inject/.context.uses); valuesMapping: pada Recipe dijalankan saat rendering dasar dengan konteks template lengkap; injectMapping: pada FeatureRecipe dijalankan saat pemetaan inject dengan konteks template lengkap, termasuk pipe inject yang sedang diintersepsi. Tabel ketersediaan lengkap per situs tersedia di expansion-matrix.md; halaman ini mendokumentasikan bentuk field yang dirujuk oleh kolom “available references” pada matriks tersebut.
Rujukan silang
05-templates.md— ikhtisar templating.expansion-matrix.md— matriks evaluasi per situs templat.sprig-functions.md— helper Sprig yang terhubung ke mesin templat.../entities/recipe.md— permukaan penulisan Recipe.../entities/featurerecipe.md— permukaan penulisan FeatureRecipe (termasuk contoh lengkap resolver DNS K8s untuk penelusuran.context.uses).../vocabulary/topology-triad.md— spesifikasi Kontrak Injeksi (mencakup konteks dua keadaan, aturan tabrakan kunci, dan contoh lengkap).../10-status.md#compilation-pipeline-phases— kesiapan terkini permukaan inject-mapping, base-rendering, dan plugin-pipeline.