FeatureRecipe
Peran konseptual entitas FeatureRecipe (Domain 3 — implementasi antarmuka Feature yang digerakkan oleh plugin Wasm) dijelaskan di architecture/04-entity-taxonomy.md. Halaman ini membahas permukaan penulisan katalog FeatureRecipe.
Lokasi katalog
FeatureRecipes diorganisasi dengan provider pada segmen jalur terdepan (pola yang sama dengan Recipes):
aggrega-catalog/└── feature-recipe/ └── {provider}/ # e.g., `helm`, `compose` └── {feature-recipe-name}/ └── {version}/ └── recipe.yamlURI OCI: hub.aggrega.ai/featurerecipe/{provider}/{name}:{version} (misalnya, hub.aggrega.ai/featurerecipe/helm/k8s-secret-from-parameter:1.0.0).
Kontrak penulisan
FeatureRecipes terikat pada antarmuka Feature melalui implements dan mendeklarasikan provider konkret. Permukaan penulisannya adalah seluruh jenis input milik Recipe dasar ditambah dua blok khusus FeatureRecipe:
- Tiga jenis input —
source+valuesMapping(bersumber),workload(disintesis), danartifacts: bentuknya identik dengan Recipe dasar (lihat Komposisi input Recipe danentities/recipe.md). FeatureRecipe yang membawa salah satu dari input ini bersifat menghasilkan sumber daya — FeatureRecipe tersebut me-render sumber daya di samping komponen dasar. Lokasi sumber daya tersebut memuat komponen tempat Feature dilampirkan, lalu nama yang digunakan untuk melampirkannya, dalam bentuk mana pun dari keduanya yang diizinkan oleh tata letak target itu sendiri: sebagai direktori{component}--{instance}/di samping direktori host-nya, di bawah direktori apa pun yang oleh target tersebut disebut sebagai tempat para kontributornya berada, pada target yang provider-nya memberi setiap kontributor posisinya sendiri; sebagai prefiks nama file{component}--{instance}--di samping file milik komponen itu sendiri, pada target yang hanya membaca file yang berada langsung di dalam sebuah direktori. Pada provider yang menyusun para kontributornya menjadi satu dokumen, sumber daya tersebut justru digabungkan ke dalam dokumen itu — apa pun keluarga Feature tersebut: CRDServiceMonitoratauExternalSecretsebagaiartifacts:inline atau$import; chart atau modul eksternal melaluisource:+valuesMapping:; atau komputasinya sendiri (misalnya Deployment agen sidecar) melaluiworkload:.valuesMapping:berbagi tiga mode penulisan milik Recipe dasar (block scalar inline,$import:file,$import:pustaka ke entri MappingLibrary) — lihatentities/recipe.md“BidangvaluesMapping— tiga mode penulisan”. Menurut konvensi, FeatureRecipe memodifikasi komponen dasar atau menambahkan sumber daya di sampingnya, tetapi skema tidak membatasi jenis input yang boleh digunakannya — kompiler me-render apa pun yang dideklarasikan FeatureRecipe, hanya dibatasi oleh kapabilitas provider yang terikat, dan tetap tanpa opini sendiri mengenai apakah suatu jenis “sesuai untuk modifier” (lihat invarian dasar). Sintesis (workload:) memerlukan provider yang mendukungnya; jika tidak, build berhenti saat render dengan diagnostik kapabilitas provider. injectMapping(intersepsi pra-render): Blok templat Go native yang dieksekusi sebelum Recipe dasar di-render. Blok ini menghasilkan kamus JSON atau YAML yang secara native di-deep-merge oleh compiler di atas pipa memori.context.injectmilik pemanggil, sehingga variabel lingkungan dan string koneksi dapat dimutasi di sisi pemanggil tanpa Wasm.pipeline: Larik berurutan berisi langkah plugin WebAssembly (Wasm) untuk mutasi Workload pasca-render (misalnya, menyuntikkan sidecar Envoy melalui JSONPatch, atau me-mount volume secret). Bidangpluginpada setiap langkah menyebut entitasPluginmelalui URI-nya, yang selalu dicakup oleh tipe soket plugin itu sendiri (<pluginType>/<name>, secara opsional berversi, seperti padaparser/yamlatauparser/yaml:1.0.0); build me-resolve entitas tersebut ke artefak.wasmmiliknya yang dialamatkan berdasarkan konten, yang ditemukan dari identitas plugin dan registry yang dikonfigurasi, dan.wasmmentah atau referensi artefak tidak diterima di sini. Lihat panduan pengembang plugin Wasm untuk menulis dan mereferensikan plugin, serta architecture/04-entity-taxonomy.md §“Domain 3: Infrastructure Base” untuk Prinsip Plugin Dua Bagian (Fetcher / Injector). Kompiler mengeksekusi setiap langkah sesuai urutan deklarasi: kompiler memanggil export guest milik plugin yang disebut terhadap output yang telah di-render, lalu menerapkan JSON Patch yang dikembalikan dan efek samping yang dipancarkan; lihat Status bahasa untuk status eksekusi setiap permukaan pipeline.pipeline:dapat berdiri sendiri: FeatureRecipe boleh mendeklarasikannya tanpa jenis input apa pun, dan dalam hal itu FeatureRecipe tidak menghasilkan sumber daya sendiri dan seluruh efeknya adalah apa yang di-patch oleh langkah-langkahnya ke dalam, atau dipancarkan di samping, dokumen yang telah di-render oleh build.
FeatureRecipe juga boleh tidak membawa satu pun blok ini: Feature murni-pengkabelan yang efeknya adalah sisi uses yang dibawanya tidak me-render apa pun, dan FeatureRecipe-nya hanya ada untuk memenuhi resolusi — setiap instans feature diresolusi ke sebuah FeatureRecipe, sama seperti setiap komponen diresolusi ke sebuah Recipe. Di antara blok-blok di atas, injectMapping adalah satu-satunya bidang yang tidak memiliki padanan pada Recipe dasar; ketiga jenis input dan pipeline digunakan bersama dengan Recipe dasar.
Apa yang di-pin di samping FeatureRecipe sama dengan apa yang di-pin di samping Recipe: digest setiap file yang diimpor oleh entri artifacts, dan setiap source: jarak jauh yang koordinatnya ditulis lengkap, dalam entity.lock di direktori FeatureRecipe itu sendiri, yang ditulis oleh aggrega pin dan Anda commit di sampingnya. Pull atas FeatureRecipe yang lock-nya tidak mencatat pin tersebut akan berhenti dan menyebut langkah itu, kecuali pull diminta untuk menjalankannya. Build berhenti ketika file yang diimpor tidak lagi cocok dengan digest-nya, dan ketika digest suatu source tidak sesuai dengan yang dicatat oleh lockfile Release (source yang ditulis pada ref: git dicatat pada commit hasil resolusinya dan tidak dibandingkan); file FeatureRecipe itu sendiri tidak pernah ditulisi. aggrega pull menjelaskan file tersebut dan cara menanggapi setiap penghentian.
Templating field source
source: milik sebuah FeatureRecipe adalah permukaan templating dengan ketentuan yang sama seperti milik sebuah Recipe: template dievaluasi pada saat resolusi source, dan apa yang dihasilkannya adalah apa yang kemudian di-resolve oleh build. Kedua bentuk menerima template Go — bentuk string universal, dan bentuk objek terstruktur yang sub-field bernilai string-nya dievaluasi sebagai template sementara sub-field non-string diteruskan apa adanya. Inventaris bentuk, penanganan skema, dan cara pembacaan penjangkaran adalah yang dijelaskan dalam entities/recipe.md “Source field templating”, “Source field scheme inventory”, dan “How a source: path is anchored”; bagian ini hanya menyatakan apa yang berbeda untuk sebuah attachment.
locals: chart_dir: ./charts/exportersource: "{{ .locals.chart_dir }}"Terhadap apa hasil relatif di-resolve. Direktori yang memuat dokumen FeatureRecipe yang mendeklarasikannya — file milik attachment itu sendiri, bukan milik komponen — dan hasilnya harus tetap berada di dalam direktori tersebut, persis seperti untuk sebuah Recipe: hasil yang keluar dari direktori itu, atau berupa path absolut, menunjuk file yang tidak akan ikut berpindah bersama FeatureRecipe dan menghentikan build. Hasil yang membawa skema transport diambil alih-alih digabungkan ke sebuah direktori. FeatureRecipe yang di-resolve dari registry dibaca dari file yang dibawa oleh arsip yang dipublikasikannya, yang ditata di cache konten, sehingga hasil relatif di-resolve di dalam apa yang dipublikasikan persis seperti ia di-resolve di samping FeatureRecipe dalam direktori katalog, dengan batas yang sama.
Apa yang dapat dibaca template. Himpunan referensinya adalah himpunan yang digunakan untuk memeriksa entri locals: milik FeatureRecipe itu sendiri, yang berbeda dari milik sebuah Recipe dalam dua hal yang timbul karena yang di-resolve adalah attachment, bukan komponen:
.attachment_nametersedia, yang menamai instans tempat Feature dilampirkan. Template source sebuah Recipe menolaknya, karena source sebuah Recipe di-resolve untuk sebuah node dan tidak ada attachment yang terlibat..context.instance_idmenamai komponen host yang sedang di-resolve oleh attachment, bukan attachment itu sendiri, dan.context.rendered_namemembawa nama yang dilaporkan oleh provider milik host untuk host tersebut — hanya ada jika provider itu melaporkannya, dan menghentikan build jika tidak. Lihat Menamai resource yang di-render.
.locals membawa himpunan yang dibaca oleh template lain dari FeatureRecipe ini: blok miliknya sendiri yang telah di-resolve, dengan blok milik Recipe host di bawahnya, sehingga kunci yang dideklarasikan attachment mengalahkan kunci host dengan nama yang sama. Referensi ke kunci yang tidak dibawa oleh himpunan itu menghentikan build dan menyebutkan kunci tersebut, alih-alih me-render kunci itu menjadi kosong. .provides, .context.inject, dan .context.uses ditolak dengan alasan kemandirian yang sama seperti penolakannya oleh permukaan source sebuah Recipe.
FeatureRecipe dengan cakupan boundary membaca boundary sebagai gantinya. Feature yang FeatureRecipe-nya mendeklarasikan executionScope: boundary di-render sekali untuk boundary, bukan sekali per komponen, sehingga template source-nya tidak memiliki komponen host untuk dibaca. Template tersebut membaca .boundary.* — pilar yang sama yang dibaca oleh locals: dan provides: miliknya — dan pilar per komponen (.context, .workload, .attachment_name, .inject) tidak tersedia baginya.
Hasil kosong. Template yang tidak menghasilkan apa pun membuat attachment tidak memiliki source, yaitu mode tanpa source — cara pembacaan yang sama dengan yang berlaku untuk source sebuah Recipe, dan berbeda dengan menulis source: "" sendiri.
Apa yang dibaca .source setelahnya. Source dievaluasi sebelum valuesMapping:, sebagaimana source sebuah Recipe dievaluasi sebelum pemetaannya sendiri, dan apa yang dihasilkannya menjadi .source pada setiap templat yang berjalan setelahnya: valuesMapping:, omits:, badan workload: dan artifacts:, serta langkah-langkah pipeline:. Jadi valuesMapping: yang membaca .source membaca source milik FeatureRecipe ini sendiri, tidak pernah source dari komponen tempat ia dilampirkan, dan tidak membaca apa pun jika FeatureRecipe ini tidak mendeklarasikan source atau templatnya tidak menghasilkan apa pun. FeatureRecipe dengan cakupan batas membaca source-nya sendiri dengan cara yang sama. injectMapping: berjalan sebelum source lampiran dievaluasi, sehingga .source di sana adalah milik komponen host.
Eksklusivitas injectMapping
Field injectMapping eksklusif untuk FeatureRecipes — field ini sengaja tidak ada dalam skema Recipe dasar. Eksklusivitas ini memisahkan intersepsi variabel dari valuesMapping: valuesMapping milik Recipe dasar mengonsumsi string .context.inject yang telah ditulis ulang oleh blok injectMapping FeatureRecipe tanpa mengetahuinya, sehingga keduanya tetap terpisah. Lihat bagian intersepsi inject-mapping di bawah untuk cara mekanisme ini berjalan, dan architecture/10-compilation-pipeline.md tentang inject mapping untuk semantik intersepsi pra-render secara lengkap.
Intersepsi inject mapping: cara kerja injectMapping
Ketika sebuah pemanggil membutuhkan string koneksi ke targetnya dalam bentuk yang berbeda dari .provides.host milik target yang tidak diubah — menambahkan namespace untuk DNS Kubernetes lintas batas, menambahkan awalan kode region untuk gateway multi-region, atau menambahkan akhiran mode SSL pada DSN — injectMapping menangani mutasi tersebut di sisi pemanggil, sebelum valuesMapping milik Recipe dasar melihat pipa inject.
Field injectMapping adalah sebuah Go text/template yang dievaluasi oleh renderer pada tahap inject mapping, sebelum rendering Recipe dasar berjalan. Template ini menghasilkan kamus JSON atau YAML dengan kunci mekanisme opsional (env, file, arg, atau mekanisme kustom yang dibaca Recipe milik komponen di .context.inject.<name>) — atau map datar yang secara default menjadi env — dan renderer melakukan deep-merge overlay ini di atas pipa .context.inject milik node pemanggil. Perutean di sisi pemanggil melalui injectMapping berjalan pada tahap inject mapping tanpa memanggil sandbox Wasm untuk manipulasi string sederhana; plugin Wasm tetap dikhususkan untuk perubahan AST struktural melalui array pipeline.
Tulis setiap nilai melalui toJson. Renderer membaca keluaran template sebagai YAML, sehingga nilai yang diinterpolasi apa adanya di antara tanda kutip akan merusak keluaran tersebut atau terbaca kembali dalam keadaan berubah begitu nilai itu memuat tanda kutip ganda atau garis miring terbalik — kata sandi adalah kasus yang paling umum. toJson menulis nilai sebagai string JSON, yang dibaca kembali oleh YAML secara persis, sehingga nilai dikirimkan dengan setiap karakter yang dimuatnya:
injectMapping: | env: {{ .values.key }}: {{ .values.origin | toJson }}Nilai yang disusun dari beberapa bagian disusun terlebih dahulu lalu ditulis melalui toJson satu kali, seperti yang dilakukan contoh-contoh di bawah.
Keluaran yang tidak dapat dibaca menghentikan build. Ketika keluaran template tidak terbaca sebagai salah satu dari kedua bentuk — skalar bertanda kutip yang rusak oleh nilai di dalamnya adalah penyebab yang umum — tidak satu pun kuncinya dapat dikirimkan, sehingga build berhenti dengan menyebutkan lampiran dan FeatureRecipe alih-alih merender komponen seolah-olah tidak ada yang dikirimkan; lihat fatal-halts.md “An attached Feature’s injectMapping output cannot be read (Keluaran injectMapping dari Feature yang dilampirkan tidak dapat dibaca)”. Alasan yang diberikannya disembunyikan jika alasan itu bergantung pada nilai yang dideklarasikan sensitif. Keluaran yang kosong, atau yang ter-parse sebagai kamus yang tidak mengirimkan apa pun, tidak mengirimkan apa pun dan bukan merupakan kegagalan.
Kunci tingkat teratas adalah sebuah mekanisme, dan all bukan salah satunya. Setiap kunci tingkat teratas dari keluaran kamus menyebutkan mekanisme yang digunakan untuk mengirimkan entri-entrinya: env, file, dan arg, atau nama lain apa pun, yang dikirimkan sebagai mekanisme tersendiri dengan nama tersebut. .context.inject.all dibangun dari mekanisme-mekanisme itu setelah penggabungan dan tidak pernah digabungkan dari sebuah keluaran, sehingga entri yang ditulis di bawah all: tidak akan mencapai apa pun; sebagai gantinya build berhenti, dengan menyebutkan lampiran, kunci, dan FeatureRecipe, serta menyatakan kunci mana saja yang boleh dibawa oleh keluaran — lihat fatal-halts.md “An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Keluaran injectMapping dari Feature yang dilampirkan menulis pengiriman di bawah kunci yang tidak dikirimkan oleh apa pun)”. Tulislah entri semacam itu di bawah mekanisme tempat komponen membacanya.
Mutasi sepenuhnya bersifat lokal bagi pemanggil. FeatureRecipe hanya mengubah pipa inject milik node tempat ia dilampirkan, tidak pernah output .provides milik target. .provides.host milik sebuah target berpotensi dikonsumsi oleh banyak pemanggil di seluruh kluster; injectMapping di sisi pemanggil hanya digabungkan ke dalam pipa pemanggil tertentu, sehingga mutasi perutean tetap terbatas pada edge yang memintanya.
Apa yang boleh ditulis ulang oleh sebuah mapping. Setiap blok inject: sudah menyerahkan nilainya saat mapping dirender, sehingga output sebuah mapping selalu digabungkan di atas kunci yang sudah ditulis oleh pihak lain — dan siapa yang menulis sebuah kunci menentukan apa yang terjadi. Kunci yang diserahkan oleh blok inject: milik pemanggil sendiri atau oleh salah satu blok inject: milik koneksinya boleh ditulis ulang oleh mapping: itulah intersepsi, dan nilai mapping menggantikan entri tersebut. Kunci yang diserahkan oleh lampiran mapping itu sendiri melalui blok inject:-nya juga boleh ditulis ulang olehnya. Kunci yang sudah diserahkan oleh Feature terlampir lain — melalui blok inject:-nya sendiri atau injectMapping milik FeatureRecipe-nya sendiri — tidak boleh: build dihentikan dengan menyebutkan kedua lampiran, alih-alih membiarkan mapping mana pun yang berjalan terakhir menentukan nilai yang dibaca pemanggil. Jadi dua Features perutean masing-masing dapat mengkualifikasi kuncinya sendiri, tetapi dua Features tidak dapat sama-sama menyerahkan satu kunci — termasuk dua Features perutean yang menulis ulang kunci koneksi yang sama, karena yang pertama adalah intersepsi dan yang kedua bertemu dengan penyerahan yang pertama; lihat fatal-halts.md “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features terlampir menyerahkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)”.
Inferensi target tanpa keterikatan
Karena compiler menyematkan anotasi bertingkat setiap target ke dalam pipa .context.uses milik pemanggil, template injectMapping dapat mengekstrak koordinat perutean tanpa Ops menuliskan identitas target secara langsung ke dalam infra milik Feature:
- Template menelusuri
.context.usesuntuk menemukan edge topologis yang tepat yang menyuntikkan variabel yang diminta developer. - Template mengekstrak
release_annotationsbertingkat milik target (misalnya,aggrega.ai/namespace). - Template memformat Fully Qualified Domain Name (FQDN) atau string koneksi.
- Template menghasilkan kamus override.
Compiler tetap agnostik terhadap semantik jaringan — namespace Kubernetes, region cloud, topologi bridge-proxy — dan hanya menjalankan deep-merge dengan apa pun yang dihasilkan template. Ketika valuesMapping milik Recipe dasar kemudian berjalan, ia mengonsumsi string hasil intersepsi dan penulisan ulang dari .context.inject.env seolah-olah itu adalah string asli developer.
Contoh lengkap: resolver DNS K8s
Katalog standar menyediakan ini sebagai core/k8s-dns-resolver dengan sebuah FeatureRecipe helm. Karena nama variabel lingkungan harus unik dalam sebuah container, target_var (misalnya, API_HOST) berfungsi sebagai pengenal unik global untuk kontrak injeksi tertentu di dalam pemanggil. Dengan melakukan perulangan atas edge eksplisit di .context.uses dan memeriksa edge mana yang mengklaim target_var, template menemukan node target yang benar dan membaca namespace-nya. Satu-satunya parameter adalah variabel yang akan ditulis ulang; target dan namespace-nya ditemukan, tidak pernah ditulis secara langsung.
Skema Feature perutean (core/k8s-dns-resolver):
infra: { target_var: string # Ops dictates WHICH injected var to rewrite}Implementasi FeatureRecipe:
injectMapping: | # 1. Grab the atomic base host directly from the flattened pipe, or an # empty value when nothing was injected under target_var {{ $base_host := optional .context.inject.env .infra.target_var "" }}
# 2. Dynamically locate the specific edge that injected this variable {{ $target_edge := dict }} {{ range $alias, $edge := .context.uses }} {{ if hasKey $edge.inject.env $.infra.target_var }} {{ $target_edge = $edge }} {{ end }} {{ end }}
# 3. Read the target's namespace from its cascaded release annotation, # coalescing an absent namespace to "default" {{ $ns := "default" }} {{ if $target_edge.annotations }}{{ if $target_edge.annotations.release }} {{ $raw := optional $target_edge.annotations.release "aggrega.ai/namespace" "" }} {{ if $raw }}{{ $ns = $raw }}{{ end }} {{ end }}{{ end }}
# 4. Qualify the host with the namespace — but only when a target connection # and a base host were actually found, so a target_var that matches no # connection injects nothing instead of a spurious variable. An unset # namespace resolves to "default", where the helm provider deploys an # unannotated workload, so the qualified host always matches the service's # actual location and is never malformed. {{ if and $target_edge $base_host }} {{ $resolved_host := printf "%s.%s" $base_host $ns }}
# 5. Emit the precise override dictionary for the compiler to deep-merge env: {{ .infra.target_var | toJson }}: {{ $resolved_host | toJson }} {{ end }}Kasus penggunaan di luar perutean
injectMapping paling sering digunakan untuk resolusi alamat lintas batas (seperti resolver DNS K8s di atas), tetapi mutasi di sisi pemanggil tersebut berlaku untuk skenario apa pun yang memerlukan intersepsi dan pemformatan maksud pengembang sebelum perenderan infrastruktur. Dua pola berikut menggambarkan cakupannya.
Pemformatan keamanan dinamis (penambah SSL). Jika suatu perusahaan mewajibkan semua koneksi basis data eksternal menggunakan verifikasi TLS yang ketat, sebuah Feature dapat mengintersepsi DB_URL yang diminta pengembang dan menambahkan mode SSL yang diperlukan sehingga aplikasi dijalankan dengan parameter keamanan yang benar.
# Inside force-ssl-featureinjectMapping: | {{ $base_url := index .context.inject.env .infra.target_var }} env: {{ .infra.target_var | toJson }}: {{ printf "%s?sslmode=verify-full" $base_url | toJson }}Pemberian prefiks gateway multi-region. Jika sebuah komponen API generik di-deploy secara global, sebuah Feature perutean regional dapat secara otonom mencari anotasi batas lingkungannya sendiri untuk memberi prefiks pada string koneksi yang diinjeksikan bagi para pemanggilnya.
# Inside regional-routerinjectMapping: | {{ $base_host := index .context.inject.env .infra.target_var }} {{ $region_code := index .context.annotations.release "cloud.aggrega.ai/region" }} env: {{ .infra.target_var | toJson }}: {{ printf "%s.%s" $region_code $base_host | toJson }}Batas injectMapping. Mekanisme ini terbatas pada mutasi pipa memori .context.inject (Kontrak Pengiriman). Mekanisme ini tidak dapat menambahkan kontainer baru, memasang volume, atau mengubah keluaran valuesMapping dari Recipe dasar. Setiap mutasi yang memerlukan perubahan struktural pada AST yang dirender (seperti array JSON atau YAML) termasuk dalam array pipeline milik FeatureRecipe, yang dieksekusi melalui plugin WebAssembly.
Batas target patch dari pipeline. Sebuah langkah pipeline hanya mem-patch keluaran yang dirender oleh provider ke dalam pohon terstruktur. Keluaran berbentuk YAML dan JSON bersifat terstruktur — termasuk modul Terraform .tf.json yang ditulis dalam JSON — sehingga JSONPatch sebuah langkah menyunting nilai yang dituju di tempatnya, tanpa menyentuh byte lainnya (komentar, urutan, pemformatan). Keluaran yang dihasilkan provider sebagai badan buram, seperti konfigurasi Terraform dalam HCL native, bukan target patch: patch terhadap badan buram menghentikan build dengan diagnostik alih-alih memutasi teks yang tidak dapat dituju secara struktural. Oleh karena itu, menulis langkah pipeline terhadap keluaran buram adalah kesalahan desain yang dimunculkan sebagai penghentian yang jelas, bukan no-op yang diam-diam.
Input dari modul Terraform yang di-vendor bukan target patch, dan ketiadaan ini patut dinyatakan. Input tersebut adalah argumen dari blok module komponen itu, yang ditulis oleh provider terraform ke dalam konfigurasi root batas tersebut: HCL native, sehingga buram menurut aturan di atas, dan merupakan artefak dari seluruh batas, bukan dari node yang keluarannya di-patch oleh langkah tersebut. Jadi tidak ada posisi dari mana sebuah langkah pipeline dapat menuju input tersebut, dan tidak ada yang dapat dilakukannya untuk mengubah apa yang diterima oleh modul Terraform yang bersumber. Nilai-nilai tersebut dibentuk di tempat nilai itu ditulis — dalam valuesMapping: milik Recipe dasar.
Langkah bersyarat — when:
Sebuah langkah pipeline dapat membawa field when: opsional: sebuah templat Go inline yang dievaluasi oleh compiler pada saat penelusuran pipeline, terhadap konteks templat dan evaluator yang sama dengan yang digunakan oleh badan with: langkah tersebut. Hasil render menentukan apakah langkah tersebut dijalankan.
- Hasil yang bernilai salah melewati langkah tersebut sebagai pass-through: kumpulan dokumen diteruskan ke langkah berikutnya tanpa perubahan, dan langkah yang dilewati tidak menyumbangkan apa pun — tidak ada patch, tidak ada efek samping, tidak ada catatan bahwa langkah itu pernah dijalankan.
when:yang kosong atau tidak ada selalu menjalankan langkah tersebut.
when: dan optional: tidak saling bergantung. when: menentukan apakah sebuah langkah dijalankan sama sekali; optional: melunakkan kegagalan langkah yang sedang berjalan. Sebuah langkah dapat mendeklarasikan keduanya — when: mengendalikan masuknya, dan jika langkah tersebut memang berjalan, optional: mengatur bagaimana kegagalan di dalamnya ditangani. Templat when: yang gagal dirender merupakan cacat penulisan dan menghentikan build terlepas dari optional:.
Teks when: hasil render dinilai dengan aturan templat boolean bersama: string true, True, dan TRUE, setiap angka bukan nol, dan setiap string tidak kosong lainnya bernilai benar; string false, False, dan FALSE, string kosong, dan angka nol bernilai salah.
Pola FeatureRecipe kredensial
Ketika sebuah FeatureRecipe mengimplementasikan Feature kredensial (yang berlabel feature.aggrega.ai/kind: secret), FeatureRecipe tersebut dapat mengikuti Prinsip Plugin Dua Bagian: sebuah pipeline yang merangkaikan plugin Fetcher (yang menghasilkan CRD khusus vault) dan plugin Injector (yang memasang secret ke kontainer target), bentuk yang dijelaskan oleh examples/04-secrets. FeatureRecipes kredensial dalam pustaka standar tidak mendeklarasikan pipeline: dan merender sendiri resource secret tersebut; lihat examples/05-credential-features.
FeatureRecipe kredensial dirender melalui tahap Resource Generation yang sama seperti attachment lainnya, dan pipeline: miliknya dieksekusi dengan ketentuan yang sama: compiler menelusuri setiap attachment yang memiliki pekerjaan dalam tahap tersebut sebagai satu urutan berurut dan menjalankan pipeline yang dideklarasikan masing-masing, dengan semantik set dokumen /own dan /host yang sama. Sebuah attachment masuk ke urutan tersebut karena salah satu dari dua alasan — FeatureRecipe-nya mendeklarasikan jenis input, sehingga attachment tersebut menghasilkan resource sendiri, atau FeatureRecipe-nya mendeklarasikan pipeline:, sehingga attachment tersebut menulis ulang dokumen yang sudah dihasilkan. Oleh karena itu, attachment kredensial dapat menjangkau dokumen hasil render dari komponen host — memasang volume secret, menambahkan referensi env — persis seperti attachment operasional, dan satu-satunya perbedaan antara keduanya adalah lokasi file yang dihasilkannya sendiri.
Pada sebuah komponen, deklarasi sensitivitas pada Feature mengikuti valuesMapping: milik FeatureRecipe persis seperti deklarasi pada Component mengikuti milik Recipe-nya. Ketika sebuah FeatureRecipe merender dari source: tanpa valuesMapping:, nilai yang diterima targetnya dikunci oleh jalur leaf yang dideklarasikan Feature, sehingga leaf yang dideklarasikan sensitive: true menandai kunci hasil rendernya. Ketika FeatureRecipe mendeklarasikan valuesMapping:, kunci-kuncinya merupakan ciptaan template itu sendiri, tidak ada deklarasi yang menamainya, dan build mencetak satu peringatan per leaf semacam itu yang menyebutkan attachment, leaf, dan FeatureRecipe. Feature yang dilampirkan pada boundary tidak menghasilkan peringatan: .values miliknya selalu kosong, sehingga tidak ada leaf yang dideklarasikan yang memiliki nilai untuk ditandai — lihat A declared-sensitive value reaches the target through a values mapping (Nilai yang dideklarasikan sensitif mencapai target melalui values mapping).
Blok provides: — memublikasikan ke konsumen
Blok provides: dari sebuah FeatureRecipe adalah keluaran yang dipublikasikannya: sebuah map bernilai string berisi templat Go yang dievaluasi terhadap cakupan attachment itu sendiri (.values, .infra, .locals FeatureRecipe yang telah diselesaikan sepenuhnya, serta .context.instance_id dan .context.rendered_name dari node host). Locals diselesaikan terlebih dahulu, sehingga sebuah entri provides: membacanya dan menerima nilai yang telah diselesaikan; menyebut kunci yang tidak dideklarasikan oleh blok locals: akan menghentikan build. Dengan cara inilah sebuah attachment memberi tahu konsumennya apa yang dihasilkannya — nama resource yang diemisikan, kunci data yang dibangkitkan, identitas cloud — tanpa konsumen harus menurunkan ulang identitas tersebut dari masukan yang sama.
Konsumen membacanya di .features.<instance-name>.provides.<key> (atau .features.<slot>.provides.<key> untuk attachment kredensial), mencerminkan .context.uses.<alias>.provides untuk edge uses. Jika attachment ditulis pada salah satu koneksi konsumen, konsumen membaca map yang sama di bawah koneksi tersebut, di .context.uses.<alias>.features.<slot>.provides.<key>, dan attachment tersebut tidak termasuk dalam .features miliknya (lihat Attachment pada sebuah koneksi). Blok inject: milik attachment itu sendiri menyelesaikan referensi from:-nya terhadap map yang sama, sehingga penulis dapat memilih salah satu saluran: provides untuk pembacaan templat, inject untuk pengiriman ke variabel env, file, atau argumen.
# FeatureRecipe: emits a ServiceAccount and publishes its name.provides: name: "{{ .infra.service_account_name }}"# Consuming Recipe: binds the pod to what the attachment published.workload: | serviceAccount: "{{ .features.identity.provides.name }}"Jika Feature yang di-implements oleh FeatureRecipe ini mendeklarasikan kontrak schema.provides, kontrak tersebut diberlakukan terhadap FeatureRecipe: setiap kunci yang dideklarasikan Feature harus muncul dalam provides: milik FeatureRecipe, atau build berhenti dengan menyebut kunci yang hilang. Kunci tambahan yang dipublikasikan diperbolehkan — kontrak tersebut adalah batas bawah, bukan batas atas. Nilai tidak pernah diperiksa; nilai-nilai tersebut adalah penunjuk deterministik yang buram yang diselesaikan oleh runtime.
Penyelesaian terjadi sekali per attachment, sebelum konsumen dirender, dan map hasil penyelesaian yang sama digunakan untuk pembacaan oleh konsumen, pemeriksaan kontrak, dan Resource Generation milik attachment itu sendiri — sehingga apa yang dibaca konsumen dan apa yang diemisikan attachment tidak mungkin berbeda.
Provider & implements
spec.capability wajib ada dan menyebut provider yang plugin rendering Wasm-nya me-render output FeatureRecipe (helm, helm-chart, compose, dll.), dengan ketentuan yang sama seperti spec.capability milik Recipe (lihat entities/recipe.md): patokan versi memilih versi plugin mana yang me-render-nya, dan bukan bagian dari nama FeatureRecipe — Manifest memetakan FeatureRecipe yang mendeklarasikan capability: "compose:1.2.3" sebagai compose/<name>:<version>, dan nilai pemetaan yang menuliskan patokan ke dalam nama ditolak sebagai referensi recipe yang salah bentuk (E0095) sebelum apa pun dicari. Field implements mengikat FeatureRecipe ke antarmuka Feature-nya dan mendukung pencocokan eksak, rentang yang kompatibel secara mayor, atau tanpa versi — lihat vocabulary/inheritance-and-interface untuk semantik pencocokan versi implements.
Cakupan eksekusi — spec.executionScope
Enum opsional spec.executionScope memilih model dispatch untuk Resource Generation. Dua nilai diterima; nilai default ketika field ini dihilangkan adalah component.
component(default). Resource Generation milik FeatureRecipe dijalankan sekali per instans komponen yang terpasang. Setiap pemanggilan menerima konteks templat per komponen yang berakar di.context.*:.context.instance_id,.context.inject,.context.uses,.context.annotations, dan sebagainya.valuesMapping:,workload:, danartifacts:miliknya juga membaca.context.used_by, yaitu komponen-komponen yang entriuses-nya menunjuk ke host — masing-masing dengan identitasnya, socket-nya, apa yang dipublikasikannya, serta namespace dan boundary tempatnya ditempatkan — yang tidak dapat dilihat oleh templat mana pun yang dirender oleh host itu sendiri.boundary. Resource Generation dijalankan sekali per boundary yang terpasang, berapa pun jumlah komponen di dalam subtree boundary tersebut yang mengonsumsi fitur itu. Setiap pemanggilan menerima konteks templat cakupan boundary yang berakar di.boundary.*, bukan di.context.*.
Intersepsi injectMapping yang dijelaskan di atas selalu per konsumen, apa pun nilai executionScope. Setiap komponen yang menggunakan fitur tersebut tetap mendapatkan penulisan ulang .context.inject sendiri di sisi pemanggil. Hanya langkah Resource Generation (source/valuesMapping dan array pipeline) yang dideduplikasi pada cakupan boundary.
Karena itu, templat FeatureRecipe cakupan boundary berjalan dalam dua cakupan. injectMapping-nya berjalan sekali untuk setiap komponen yang dijangkau attachment, terhadap konteks komponen tersebut — konteks yang dibaca oleh injectMapping milik FeatureRecipe cakupan komponen: .context.*, .attachment_name, .features, serta .values, .infra, dan .locals milik attachment itu sendiri. .infra-nya adalah blok infra: milik attachment boundary, dan .locals-nya adalah blok yang dievaluasi sekali untuk boundary. Setiap templat lain yang ditulisnya — termasuk locals:, provides:, source:, valuesMapping:, dan artifacts: miliknya serta with: dan when: pada langkah-langkah pipeline-nya — berjalan sekali untuk boundary, terhadap konteks cakupan boundary di bawah. Setiap templat diperiksa terhadap cakupan tempatnya berjalan: valuesMapping: yang membaca .context.instance_id menghentikan build, sedangkan injectMapping yang membacanya me-render identitas komponen tersebut. .boundary tidak ditetapkan dalam konteks komponen mana pun, sehingga injectMapping yang membacanya menghentikan build dengan menyebut referensinya, apa pun executionScope milik FeatureRecipe.
Konteks templat cakupan boundary
Ketika executionScope: boundary, templat FeatureRecipe selain injectMapping-nya dievaluasi terhadap tampilan .boundary.* dari boundary tempat fitur tersebut dipasang. Tampilan ini menyediakan:
.boundary.path— path boundary Release tempat fitur dipasang: nama-nama boundary dari yang terluar ke dalam, digabung dengan/(bridge,bridge/frontend). Path ini menyebut boundary, bukan direktori tempat output-nya ditulis, yang ditetapkan olehdirectory:(menggantikan.context.instance_id)..boundary.assembly_path— direktori, relatif terhadap direktori output build, tempat output milik attachment itu sendiri dirakit:directory:dansubDirectory:milik boundary yang telah dievaluasi, yaitu direktori tempat build merutekan output tersebut (bridge/compose). Nilainya sama dengansource_assembly_pathatautarget_assembly_pathmilik endpoint koneksi tepat ketika endpoint tersebut di-render ke file rakitan yang sama, sehingga FeatureRecipe membandingkannya untuk membedakan koneksi di dalam file miliknya sendiri dari koneksi di file lain..boundary.boundary_name— nama boundary sebagaimana ditulis di Release..boundary.components— map dengan kunci ID instans yang berisi setiap komponen dalam subtree boundary (instance_id,component,resolved_version,boundary_path)..boundary.internal_uses_edges— edgeuses:yang kedua endpoint-nya berada di dalam subtree boundary ini (pola compose-bridge mengenumerasi edge ini, mempertahankan edge yang kedua endpoint-nya dirakit ke file compose miliknya sendiri dan ditempatkan pada jaringan yang berbeda dalam file tersebut, untuk menurunkan konfigurasi proxy per edge). Setiap edge membawa provides yang telah di-resolve dari endpoint-nya, variabel lingkungan yang diinjeksi, dan penempatan setiap endpoint:source_namespacedantarget_namespace, anotasiaggrega.ai/namespaceyang berlaku untuk endpoint tersebut — pengaturan pada entri Release miliknya sendiri jika ada, atau milik boundary-nya jika tidak;source_boundary_pathdantarget_boundary_path, path boundary Release yang memuatnya; sertasource_assembly_pathdantarget_assembly_path, direktori di bawah direktori output build tempat provider-nya merakitnya, yang tersusun daridirectory:dansubDirectory:milik boundary-nya yang telah dievaluasi (bridge/compose). Dua endpoint dengan satu path rakitan di-render ke satu file rakitan, dan provider compose membaca path rakitan sebagai jaringan endpoint bila tidak ada namespace yang berlaku..boundary.outgoing_cross_boundary_uses_edges— edge dengan sumber di dalam subtree dan target di luarnya..boundary.incoming_cross_boundary_uses_edges— edge dengan target di dalam subtree dan sumber di luarnya (digunakan oleh agregator bergaya ingress)..boundary.cross_boundary_uses_edges— gabungan edge lintas boundary yang masuk dan keluar, ketika FeatureRecipe memerlukan tampilan lintas boundary yang lengkap..boundary.labels— gabungan label subtree dengan urutan penulisan dipertahankan..boundary.annotations— anotasi milik boundary itu sendiri beserta cascade-nya..boundary.feature_attachments— setiap fitur yang dipasang pada boundary ini (sehingga FR cakupan boundary dapat menginspeksi saudaranya jika diperlukan).
Pilar .infra pada FR cakupan boundary di-resolve ke blok infra: milik fitur yang dipasang pada boundary (ukuran fisik yang ditulis di sisi Release untuk pemasangan boundary tersebut). .values selalu kosong untuk FR cakupan boundary: aturan pemisahan pilar pada skema Release melarang values: pada pemasangan Feature di tingkat Release, sehingga fitur yang dipasang pada boundary tidak membawa nilai untuk diproyeksikan. FR cakupan boundary yang memerlukan data berbentuk parameter sebaiknya mengonsumsinya melalui .infra (permukaan penulisan operator untuk konfigurasi fitur boundary) atau melalui .boundary.annotations (nilai string yang dapat di-resolve secara cascade dan ditulis pada boundary atau leluhur mana pun); .parameters bukan bagian dari tampilan, dan templat yang membacanya berhenti dengan menyebut root yang didefinisikan tampilan. .locals tetap merupakan blok locals milik FR itu sendiri. .steps dan .metadata tetap tidak berubah.
Allowlist field templat cakupan boundary
FR cakupan boundary hanya boleh mereferensikan field yang tersedia dalam tampilan cakupan boundary, di setiap templat kecuali injectMapping. Menulis templat seperti itu yang mereferensikan field khusus per komponen (misalnya .context.instance_id, .context.inject, .context.uses) ketika executionScope: boundary menyebabkan FeatureRecipe gagal validasi saat parsing, dengan error yang menyebutkan FR tersebut, field yang bermasalah, dan field yang didefinisikan tampilan cakupan boundary. Aturan cerminannya berlaku ke arah sebaliknya: FR cakupan komponen yang mereferensikan field .boundary.* gagal pada validator yang sama. injectMapping diperiksa terhadap konteks komponen tempatnya berjalan, di kedua cakupan, sehingga dapat membaca .context.*, dan referensi ke .boundary di dalamnya berhenti dengan menyebut referensi tersebut dan root yang didefinisikan konteks itu.
Validator menjalankan penelusuran AST templat yang sama dengan yang digunakan allowlist variabel templat path, dengan himpunan referensi yang berbeda per cakupan.
Deduplikasi dan output Resource Generation
Untuk executionScope: boundary, compiler mendeduplikasi Resource Generation berdasarkan tuple (boundary_path, FR-instance). Dua komponen dalam subtree boundary yang sama yang sama-sama mengonsumsi fitur terpasang-boundary yang sama memicu satu pemanggilan FR, bukan dua. Pemasangan lintas boundary dari fitur yang sama dijalankan secara independen per boundary.
FR cakupan boundary menghasilkan satu set file non-intermediate per tuple (boundary_path, FR-instance), dan letaknya ditentukan oleh cara provider menggabungkan output boundary-nya. Di sini nama instans saja sudah menjadi koordinatnya, sedangkan pemasangan cakupan komponen juga membawa komponennya: fitur cakupan boundary dipasang pada boundary, bukan pada komponen mana pun, sehingga direktori boundary yang melingkupinya sudah menyatakan semua yang akan dinyatakan oleh segmen komponen, dan tidak ada komponen untuk disebutkan.
Provider yang menulis setiap dokumen langsung di direktori boundary menyatakan bahwa targetnya hanya membaca file yang berada langsung di dalam sebuah direktori. Oleh karena itu, tidak ada direktori pelingkup tempat suatu pemasangan berada, dan nama instans menjadi prefiks nama file: <boundary_directory>/<fr-provider>/<feature-instance>--<file>, di samping file milik boundary itu sendiri. Nama instans dienkode, karena nama file tidak memiliki pemisah sebagai sandaran, dan nama itu bertemu dengan nama file itu sendiri pada batas dua karakter yang tidak dapat dimuat oleh koordinat terenkode mana pun — sehingga dua pemasangan yang menghasilkan satu nama file tetap menghasilkan dua file.
Provider yang menyusun output boundary-nya ke dalam struktur pelingkup — satu chart yang memuat satu chart per kontributor, satu konfigurasi root yang memuat satu modul per kontributor — menempatkan setiap kontributor dalam sub-direktorinya sendiri, dan pemasangan boundary adalah kontributor seperti yang lain. Outputnya kemudian berada di <boundary_directory>/<fr-provider>/<contributors-directory>/<feature-instance>/, dengan <contributors-directory> adalah sebutan target tersebut untuk tempat unit anaknya berada. Sub-direktori tersebut membawa nama instans pemasangan, yaitu nama yang Anda tuliskan untuknya di blok features: milik boundary, sehingga direktori yang dihasilkan build dapat Anda temukan dalam apa yang Anda tulis.
Output intermediate mengalir ke assembler per-(path, provider) milik boundary pada path FR yang telah dievaluasi di bawah spec.capability milik FR itu sendiri — inilah mekanisme yang digunakan Feature core/compose-bridge untuk menggabungkan layanan bridge bersama kontributor compose per komponen pada path assembly yang sama. Output semacam itu hanya ditulis sebagai bagian dari file yang dirakit di sana dari komponen-komponen boundary, sehingga jika tidak ada satu pun yang berada di path tersebut — misalnya setiap komponen dikirim ke tempat lain oleh subDirectory:-nya — build berhenti dengan menyebut boundary, Feature, path tujuan perutean output-nya, dan provider, alih-alih menulis output ke tempat yang tidak ada (lihat “A boundary-level Feature’s output reaches no assembled file (Output Feature tingkat boundary tidak mencapai file rakitan mana pun)” di fatal-halts.md).
Resolusi provides: yang sadar kaskade
FR lingkup boundary menghasilkan satu set provides: per tuple (boundary_path, FR-instance), yang dievaluasi sekali. Template provides: milik FR dievaluasi dengan konteks templat lingkup boundary (sehingga dapat mereferensikan .boundary.components, .boundary.path, .infra, tetapi tidak field per konsumen dan tidak .values). Nilai provides merupakan konstanta relatif terhadap konsumen — setiap konsumen dalam subtree boundary melihat nilai yang disediakan yang sama.
Resolusi provides FR lingkup boundary di sisi konsumen membaca satu evaluasi tersebut di mana pun. Setiap komponen yang dijangkau lampiran membacanya di .features.<instance-name>.provides.<key> — dalam templat Recipe miliknya sendiri dan dalam injectMapping milik FeatureRecipe itu sendiri, yang berjalan dalam konteks komponen tersebut. Component konsumen yang membaca melalui edge uses yang dibawa lampiran, di .context.uses.<feature-alias>.provides.<provided-name>, mendapatkan nilai yang sama: kompiler meresolusinya ke provides: milik FeatureRecipe lingkup boundary untuk boundary tempat konsumen berada, berjalan dari edge uses milik konsumen — yang membawa identitas instans feature per lampiran — ke provides: milik FR lingkup boundary. Sebuah pra-tahap mengevaluasi provides tersebut sebelum perakitan konsumen, sehingga nilainya sudah ada saat pipe konsumen dibangun.
Efek per konsumen adalah tabel dalam provides: yang dibaca oleh injectMapping. FeatureRecipe cakupan boundary yang harus mengubah sesuatu untuk setiap konsumen menghitung, sekali, tabel berkunci konsumen dari koneksi-koneksi boundary dalam provides:-nya, dan injectMapping-nya membaca baris-baris komponen saat ini — (index .features .attachment_name).provides, berkunci .context.instance_id — lalu mengirimkannya melalui pipe milik konsumen sendiri, di bawah aturan yang diikuti setiap pemetaan (lihat Apa yang boleh ditulis ulang oleh pemetaan). Kompiler meneruskan tabel yang ditulis FeatureRecipe dan tidak membaca apa pun di dalamnya.
Pola compose-bridge
FeatureRecipe compose-bridge adalah pola kanonis FR lingkup boundary, dan merupakan konten katalog yang ditulis dengan mekanisme di atas: baik kompiler maupun provider compose tidak memuat logika bridge apa pun, sehingga katalog dapat merealisasikan Feature core/compose-bridge secara berbeda. Sebuah feature core/compose-bridge dilampirkan pada boundary induk yang berisi dua sub-boundary (misalnya, services-net dan data-net) dengan directory: bersama, masing-masing membawa anotasi aggrega.ai/namespace miliknya sendiri (aggrega.ai/namespace: services-net, aggrega.ai/namespace: data-net) sehingga masing-masing berada di jaringannya sendiri; tanpa anotasi tersebut, keduanya berbagi satu jaringan yang dinamai menurut path file compose mereka dan saling menjangkau tanpa bridge. executionScope: boundary miliknya menjalankan FR sekali per lampiran boundary induk.
provides:-nya menghitung tabel bridge, sekali. Dari .boundary.internal_uses_edges, ia mempertahankan edge yang kedua endpoint-nya dirakit ke file compose miliknya sendiri — source_assembly_path dan target_assembly_path keduanya sama dengan .boundary.assembly_path — dan berada di jaringan yang berbeda dalam file tersebut; jaringan sebuah endpoint adalah aggrega.ai/namespace-nya, atau path rakitannya jika tidak ada. Edge di antara dua file compose tidak dijembatani, dan konsumennya mempertahankan nama target itu sendiri. Setiap edge yang dijembatani mendapat port listen — port milik target sendiri, atau, jika edge sebelumnya sudah listen pada port itu, port bebas pertama yang sama dengan atau di atas portBase milik lampiran (default 10000) — dan upstream, yaitu host yang dipublikasikan target (field provides yang disebut oleh providesField milik lampiran, default host) beserta port-nya; upstream diturunkan dari edge, tidak pernah ditulis secara manual. Dari tabel yang sama, ia menghitung penulisan ulang setiap konsumen: variabel yang dikirimkan edge dari field host menjadi aggrega-gw:<listen port>, atau aggrega-gw jika edge yang sama juga mengirimkan variabel dari port, yang kemudian menjadi port listen.
injectMapping-nya mengirimkan baris setiap konsumen. Berjalan dalam konteks setiap konsumen, ia membaca baris tabel milik konsumen tersebut di .features.<attachment>.provides dan mengirimkannya di atas nilai yang dikirimkan oleh koneksi milik konsumen sendiri (misalnya DB_HOST), yang merupakan intersepsi; konsumen tanpa baris tidak menerima apa pun. Jika Feature lain yang dilampirkan pada konsumen mengirimkan kunci tersebut — melalui blok inject: atau injectMapping-nya — build dihentikan dengan menyebutkan kedua Features alih-alih mengganti pengiriman tersebut (lihat “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Dua Features yang dilampirkan mengirimkan satu kunci, yang belakangan melalui injectMapping milik FeatureRecipe-nya)” di fatal-halts.md). listen milik gateway dan penulisan ulang konsumen dibaca dari satu tabel, sehingga selaras per edge secara konstruksi, termasuk tabrakan yang ditetapkan ulang oleh portBase.
valuesMapping-nya menulis gateway. Fragmen compose milik FeatureRecipe itu sendiri mendeklarasikan layanan aggrega-gw. Jika ada yang dijembatani, valuesMapping-nya menambahkan satu blok nginx stream server per edge yang dijembatani (listen <port>; set $uN <target-host>:<target-port>; proxy_pass $uN;, di bawah direktif resolver sehingga setiap upstream diresolusi pada saat koneksi alih-alih sekali saat startup; $ dalam variabel tersebut ditulis sebagai $$ sehingga interpolasi $ Docker Compose menyisakan $ literal untuk nginx), yang dikirimkan sebagai konfigurasi compose yang di-mount — entri configs: tingkat atas dengan content: inline, direferensikan dari aggrega-gw dan di-mount di /etc/nginx/nginx.conf (sehingga nginx memuatnya tanpa command: yang ditulis). configs.content inline memerlukan Docker Compose ≥ 2.23.1. Ia juga menyebut setiap endpoint yang dijembatani di bawah x-aggrega-networks-of milik gateway, yang diresolusi oleh provider compose menjadi jaringan tempat endpoint tersebut ditempatkan, sehingga gateway bergabung ke setiap jaringan yang dicakup oleh edge-edge yang dijembataninya (jaringan konsumen dan jaringan target) — pada runtime konsumen dapat menjangkau aggrega-gw:<port> dan gateway dapat melakukan proxy_pass ke target. Jika tidak ada yang dijembatani, gateway yang dideklarasikan fragmen tetap di-render, dalam keadaan idle: tanpa konfigurasi, tanpa jaringan tambahan, dan tanpa penulisan ulang.
Assembler compose per-(path, provider) menggabungkan gateway bersama kontributor per komponen pada path terevaluasi yang sama: satu docker-compose.yaml yang berisi setiap komponen ditambah gateway jembatan. Jika tidak ada satu pun komponen boundary yang dirakit ke file gateway, build berhenti alih-alih menulis gateway ke tempat yang tidak ada. Upstream adalah penunjuk layanan compose yang deterministik pada waktu kompilasi; DNS runtime compose meresolusinya (tanpa resolusi runtime pada waktu kompilasi).
Merender setelah pemanggil — spec.readsCallerRenderFacts
spec.readsCallerRenderFacts yang bersifat opsional (boolean, default false) menyatakan bahwa templat FeatureRecipe ini membaca apa yang dirender oleh komponen-komponen yang terhubung ke host-nya: fakta render yang dilaporkan oleh provider masing-masing pemanggil tersebut tentang keluaran yang dihasilkannya. Apa yang dilaporkan sebuah provider, dan dengan nama apa, adalah kontrak provider itu sendiri; Melaporkan fakta tentang apa yang dihasilkan guest menjelaskan fakta yang dapat dilaporkan sebuah provider.
Kapan lampiran semacam itu dirender. Build merender komponennya satu per satu, dalam urutan yang tetap, dan sebuah lampiran biasanya dirender tepat setelah komponen tempat lampiran itu dipasang. Komponen yang terhubung ke host dan berada lebih belakang dalam urutan tersebut belum dirender pada titik itu, sehingga belum ada apa pun yang dihasilkannya untuk dibaca. Lampiran yang FeatureRecipe-nya menetapkan readsCallerRenderFacts: true justru dirender setelah setiap komponen dalam build selesai dirender, bersama setiap lampiran yang tidak menetapkan kunci ini maupun readsTargetRenderFacts — sehingga render setiap pemanggil sudah lengkap sebelum lampiran dievaluasi. Keluarannya ditempatkan di lokasi yang sama dan dengan nama yang sama seperti seharusnya; kunci ini mengubah kapan lampiran dirender, bukan apa yang direndernya. Satu urutan muncul akibat render yang lebih belakang ini: bila FeatureRecipe membawa pipeline yang menulis ulang dokumen komponen host-nya dan provider host menulis dokumen-dokumen terpisah, langkah-langkah tersebut dijalankan setelah pipeline lampiran host lainnya, bukan menurut urutan lampirannya.
Apa yang dibacanya. Dengan kunci ini ditetapkan, setiap entri .context.used_by membawa .render_facts: fakta render pemanggil, dengan nama fakta sebagai kunci. Setiap fakta render adalah list, sehingga templat selalu melakukan range atasnya — bahkan ketika list itu hanya berisi satu entri. Entrinya dapat berasal dari render pemanggil itu sendiri dan dari render Features yang dipasang pada pemanggil: list yang diperoleh satu nama dari masing-masing digabung menjadi satu, panggilan provider milik pemanggil sendiri lebih dahulu, kemudian masing-masing Features-nya sesuai urutan render. Feature milik pemanggil yang juga menetapkan kunci ini dirender setelah setiap komponen, sehingga apa yang dilaporkannya tidak termasuk di dalamnya. Pemanggil yang provider-nya tidak melaporkan apa pun membawa .render_facts yang kosong, sehingga nama yang tidak dilaporkan siapa pun terbaca sebagai kosong:
artifacts: callers.yaml: | callers: {{- range .context.used_by }} - component: {{ .component_id }} ports: {{- range .render_facts.ports }} - {{ .port }} {{- end }} {{- end }}Nama fakta apa saja yang ada, dan apa isi setiap entri, adalah kontrak terdokumentasi dari provider pemanggil — misalnya milik provider helm adalah fakta render-nya, yang menyebutkan label pod yang direndernya. Fakta pemanggil berada pada koneksi yang dibaca oleh valuesMapping:, workload: dan artifacts: milik FeatureRecipe; with: dan when: dari sebuah langkah pipeline: sama sekali tidak melihat komponen yang terhubung ke host, sehingga sebuah langkah hanya membaca fakta milik host sendiri. Setiap FeatureRecipe yang dipasang pada sebuah komponen — baik menetapkan kunci ini maupun tidak — membaca fakta milik komponen itu sendiri di .context.render_facts, dengan bentuk yang sama; konteks templat menjelaskan keduanya.
Deklarasikan setiap kali templat membaca fakta. Templat yang ditulis inline dalam FeatureRecipe yang tidak menetapkan kunci ini — valuesMapping:, workload: atau entri artifacts:-nya — yang membaca render_facts di bawah .context.used_by menghentikan build sebelum apa pun dirender, dengan menyebutkan referensi tersebut dan field tempat referensi itu ditulis (lihat “A template reads its callers’ render facts without declaring it (Templat membaca fakta render pemanggilnya tanpa mendeklarasikannya)” di fatal-halts.md). Pemeriksaan ini membaca templat sebagaimana tertulis, sehingga tidak melihat referensi yang dibangun saat templat berjalan, atau yang ditulis dalam konten yang diimpor dari file atau library — dan templat yang membaca field bernama render_facts dari list lain selain .context.used_by, atau yang membaca fakta milik host sendiri sebagai .render_facts di dalam {{ with .context }} di sampingnya, diperlakukan sebagai membaca fakta pemanggil; tuliskan fakta milik host sendiri sebagai .context.render_facts secara lengkap. Kunci inilah, bukan pemeriksaannya, yang menentukan kapan lampiran dirender, jadi tetapkan kunci ini pada setiap FeatureRecipe yang templatnya membaca fakta render pemanggilnya, bagaimanapun cara templat itu mencapainya; menetapkannya tidak menimbulkan biaya selain render yang lebih belakang.
Langkah pipeline hanya membaca fakta milik host-nya sendiri. Sebuah langkah dapat menulis ulang dokumen milik komponen host sendiri, dan keluaran sebuah komponen tetap sama siapa pun yang terhubung kepadanya, sehingga with: dan when: sebuah langkah tidak pernah melihat komponen yang terhubung ke host — baik FeatureRecipe menetapkan kunci ini maupun tidak; kunci ini menentukan kapan lampiran dirender dan tidak menentukan apa pun tentang apa yang dilihat sebuah langkah. Karena itu, with: atau when: sebuah langkah yang ditulis inline dan membaca render_facts di bawah .context.used_by menghentikan build sebelum apa pun dirender, dengan kode singkat E0326, menyebutkan referensi tersebut dan field langkah itu — alih-alih merender nilai kosong. Bacalah fakta milik host sendiri dalam sebuah langkah di .context.render_facts, ditulis secara lengkap, dan bacalah fakta pemanggil di valuesMapping:, workload: atau artifacts: milik FeatureRecipe. Pemeriksaan ini membaca templat sebagaimana tertulis, dengan batasan yang sama seperti pemeriksaan di atas.
Cakupan. Kunci ini berlaku untuk FeatureRecipe yang dirender sekali per komponen — executionScope: component, nilai default. FeatureRecipe yang mendeklarasikan executionScope: boundary dirender di tempat yang selalu sama, baik menetapkan kunci ini maupun tidak, dan templat yang menghasilkan sumber dayanya membaca .boundary, bukan .context.
Merender setelah target — spec.readsTargetRenderFacts
spec.readsTargetRenderFacts yang opsional (boolean, default false) menyatakan bahwa templat FeatureRecipe ini membaca apa yang dirender oleh komponen-komponen yang menjadi tujuan koneksi host-nya: render facts yang dilaporkan oleh provider setiap target tersebut tentang output yang dihasilkannya. Kunci ini membaca ujung lain dari sebuah koneksi dibandingkan readsCallerRenderFacts — komponen yang ditunjuk oleh entri uses milik host, bukan komponen yang entri uses-nya menunjuk ke host — dan segala hal tentang fakta itu sendiri dibaca dengan cara yang sama.
Salah satu kunci membuat attachment dirender setelah setiap komponen. Attachment yang FeatureRecipe-nya menetapkan readsCallerRenderFacts: true, readsTargetRenderFacts: true, atau keduanya dirender setelah setiap komponen dalam build selesai dirender, sebagaimana dijelaskan bagian di atas — hanya ada satu render akhir seperti itu, dan pengaruhnya terhadap tempat output attachment berada dan terhadap urutan langkah pipeline-nya sama, kunci mana pun yang memindahkan attachment ke sana. Kedua kunci hanya berbeda dalam hal koneksi mana yang membawa fakta pada konteks attachment: target yang berada setelah host dalam urutan build sudah dirender pada saat itu, sehingga apa yang dihasilkannya tersedia untuk dibaca.
Apa yang dibacanya. Dengan kunci ini ditetapkan, setiap entri .context.uses membawa .render_facts: render facts milik target, dengan kunci berupa nama fakta, dalam bentuk yang sama dengan entri caller. Setiap render fact adalah list, sehingga templat selalu melakukan range atasnya. Entri-entrinya dapat berasal dari render milik target sendiri dan dari render Features yang terpasang pada target, dengan panggilan provider milik target sendiri terlebih dahulu, lalu setiap Features-nya sesuai urutan render; Feature dari target yang sendiri dirender setelah setiap komponen tidak termasuk di dalamnya. Target yang provider-nya tidak melaporkan apa pun membawa .render_facts yang kosong. Templat membaca fakta satu koneksi di bawah alias-nya, .context.uses.<alias>.render_facts.<name>, atau fakta setiap koneksi secara bergiliran:
artifacts: targets.yaml: | targets: {{- range .context.uses }} - component: {{ .target }} ports: {{- range .render_facts.ports }} - {{ .port }} {{- end }} {{- end }}FeatureRecipe yang tidak menetapkan kunci ini tidak melihat .render_facts pada koneksi mana pun, apa pun yang ditetapkannya selain itu. Nama fakta apa saja yang ada merupakan kontrak terdokumentasi dari provider setiap target — milik provider helm adalah render facts-nya, yang menyebutkan label, selector controller, dan port container dari pod yang direndernya, dan dengan demikian apa yang dibutuhkan kebijakan egress untuk memilih tepat pod yang boleh dijangkau host-nya.
Deklarasikan kunci ini setiap kali templat membaca fakta. Templat yang ditulis inline dalam FeatureRecipe yang tidak menetapkan kunci ini — valuesMapping:, workload:, atau entri artifacts: miliknya — yang membaca render_facts di bawah .context.uses menghentikan build sebelum apa pun dirender, dengan kode singkat E0347, menyebutkan referensi dan field tempat referensi itu ditulis (lihat “A template reads its targets’ render facts without declaring it (Templat membaca render facts target-nya tanpa mendeklarasikannya)” di fatal-halts.md). Menetapkan readsCallerRenderFacts tidak menghilangkannya. Pemeriksaan ini membaca templat sebagaimana ditulis, dengan batasan yang sama seperti pemeriksaan caller: pemeriksaan ini tidak melihat referensi yang dibangun saat templat berjalan, atau yang ditulis dalam konten yang diimpor dari file atau library — dan templat yang membaca .context.uses sama sekali dan juga membaca field bernama render_facts dari nilai lain, termasuk entri caller di dalam {{ range .context.used_by }}, diperlakukan sebagai membaca fakta target-nya. Templat yang membaca fakta di kedua ujung menetapkan kedua kunci.
Langkah pipeline hanya membaca fakta milik host-nya sendiri. with: dan when: sebuah langkah membaca koneksi yang dibuat host, sebagaimana Recipe milik host membacanya, dan tidak pernah membaca render facts target-nya — baik FeatureRecipe menetapkan kunci ini maupun tidak. Sebuah langkah dapat menulis ulang dokumen milik komponen host sendiri, dan render milik host sendiri membaca apa yang dipublikasikan target-nya, tidak pernah apa yang mereka hasilkan. Oleh karena itu, with: atau when: sebuah langkah yang ditulis inline dan membaca render_facts di bawah .context.uses menghentikan build sebelum apa pun dirender, dengan kode singkat E0348, menyebutkan referensi dan field langkah tersebut — alih-alih merender nilai kosong. Bacalah fakta target di valuesMapping:, workload:, atau artifacts: milik FeatureRecipe.
Cakupan. Sama seperti kunci caller: kunci ini berlaku untuk FeatureRecipe yang dirender sekali per komponen. FeatureRecipe yang mendeklarasikan executionScope: boundary dirender di tempat yang selalu sama, baik menetapkan kunci ini maupun tidak, dan koneksi yang dibacanya di bawah .boundary tidak membawa render facts.
Blok locals:
FeatureRecipe.spec.locals: adalah map string templat Go bernama yang opsional, yang keluaran hasil rendernya mengekspos map .locals.* ke setiap templat lain di dalam FeatureRecipe yang sama. Blok ini setara dengan locals: milik Recipe, tetapi bersifat privat bagi FeatureRecipe — tempat untuk menghitung string turunan sekali saja dan mereferensikannya dari injectMapping, valuesMapping, pipeline[].with, dan provides tanpa menghitung ulang. assertions: milik FeatureRecipe tidak membacanya: .locals sebuah asersi adalah milik Recipe dari komponen host, sebagaimana dinyatakan dalam assertions-block.md. Keluaran hasil render setiap entri disimpan setelah spasi putih di awal dan di akhirnya dihapus. Blok ini berupa map, bukan satu badan templat; nilai skalar pada posisi ini ditolak oleh skema.
apiVersion: aggrega.ai/v1beta1kind: FeatureRecipemetadata: name: regional-routerspec: implements: core/regional-router:^1.0.0 capability: helm locals: region_prefix: "{{ .infra.region | lower }}" fqdn_suffix: "{{ printf \"%s.svc.cluster.local\" .infra.namespace }}" injectMapping: | env: "{{ .infra.target_var }}": "{{ .locals.region_prefix }}.{{ .infra.target_var | lower }}.{{ .locals.fqdn_suffix }}".locals.* berlaku per pemanggilan: setiap pemanggilan FR menyelesaikan blok locals: miliknya sendiri, dan hasilnya hanya terlihat oleh templat hilir pemanggilan tersebut. Blok ini diselesaikan sebelum templat permukaan penulisan FR lainnya dievaluasi, sehingga setiap templat tersebut melihat nilai yang sudah diselesaikan.
Setiap entri dievaluasi terhadap konteks yang mandiri: .context.instance_id, .context.rendered_name, .attachment_name, .values, .infra, dan entri-entri blok yang sama ini yang sudah diselesaikan. Konteks ini sengaja dibuat lebih sempit daripada konteks yang dibaca templat FR lainnya — entri locals: tidak dapat menjangkau .context.annotations, .context.inject, .context.uses, atau .provides, dan referensi ke salah satunya menghentikan build dengan menyebutkan referensi tersebut. Nilai turunan yang membutuhkan pilar-pilar tersebut ditempatkan di templat yang membacanya, bukan di locals:.
Nama-nama dalam konteks tersebut menjawab pertanyaan yang berbeda, dan entri locals: membacanya persis seperti templat lain milik FeatureRecipe:
.context.instance_idadalah komponen host yang sedang diselesaikan oleh attachment. Nama ini berarti komponen host di setiap permukaan templat yang dievaluasi compiler, sehingga referensi yang sama dibaca dengan cara yang sama, entitas mana pun yang bloknya sedang Anda tulis..context.rendered_nameadalah nama komponen host sebagaimana dilaporkan oleh provider-nya sendiri — padahelm, nama release, yaitu identitas host yang ditulis dalam alfabet yang diterima nama Kubernetes. Nama ini hanya ada jika provider host melaporkan nama, dan membacanya pada host yang provider-nya tidak melaporkan nama akan menghentikan build..attachment_nameadalah instans attachment yang sedang diselesaikan — slot yang diisinya dalamfeaturesSchemamilik entitas pemilik, atau nama bebas yang Anda berikan kepadanya.
Jadi, entri locals: yang menurunkan nama untuk resource yang dihasilkan menyusun host dan attachment, persis seperti yang dilakukan templat artifacts::
spec: locals: scrape_name: "{{ .context.instance_id }}-{{ .attachment_name }}" # api-scrape_targetJika nama tersebut harus dapat diterima oleh platform dan provider host melaporkan sebuah nama, susunlah dari .context.rendered_name: untuk host bernama my_api pada helm dan attachment scrape, {{ .context.rendered_name }}-{{ .attachment_name }} menghasilkan my-zuapi-scrape, sedangkan identitasnya akan menghasilkan my_api-scrape, yang ditolak oleh nama Kubernetes. Lihat Menamai resource yang dirender.
.values dan .infra dalam entri locals: adalah pilar milik attachment sendiri, yang ditulis pada deklarasi attachment — bukan milik komponen host.
Urutan penulisan menentukan hasil
Entri diselesaikan sesuai urutan penulisannya, dan sebuah entri dapat membaca entri saudara yang didefinisikan di atasnya, dengan menerima nilai saudara tersebut yang sudah diselesaikan:
spec: locals: region_prefix: "{{ .infra.region | lower }}" # defined first bucket: "{{ .locals.region_prefix }}-artifacts" # reads the entry abovePerantaian berjalan hanya ke bawah. Jika satu entri membaca entri lain, urutan entri menentukan apakah build berhasil: pindahkan region_prefix ke bawah bucket dan build akan berhenti. Compiler tidak pernah mengurutkan ulang blok agar sebuah referensi dapat diselesaikan, sehingga mengurutkan ulang blok locals: merupakan perubahan perilaku, bukan perubahan kosmetik.
Referensi ke entri yang didefinisikan blok lebih belakang menghentikan build dengan menyebutkan kesalahan urutan (pindahkan definisi ke atas pembacanya); referensi ke kunci yang sama sekali tidak dideklarasikan blok menghentikan build dengan menyebutkan kunci tersebut (perbaiki ejaannya). Pemeriksaan mengikuti alias untuk blok: kunci yang dijangkau melalui titik yang diikat ulang oleh badan with .locals, atau melalui variabel yang diikat ke .locals, berhenti dengan ketentuan yang persis sama dengan ejaan langsung, demikian pula kunci yang dibaca dari blok dalam tanda kurung — {{ (.locals).nope }} atau {{ ($.locals).nope }}. Satu ejaan lolos dari pemeriksaan ini: kunci yang dijangkau melalui pemanggilan yang hasilnya tidak dapat dinamai oleh teks templat — {{ index .locals "nope" }}, atau {{ (default dict .locals).nope }}. Field yang dibaca dari hasil pemanggilan semacam itu tidak berhenti dan merender teks literal <no value>; pembacaan index berhenti dengan menyebutkan kunci, karena index berhenti di setiap permukaan templat jika map yang dibacanya tidak memuat kunci tersebut — lihat errors/fatal-halts.md “A template indexes a map with a key the map does not hold (Templat mengindeks map dengan kunci yang tidak dimuat map tersebut)”. provides: membaca blok yang sudah diselesaikan sepenuhnya, karena locals FeatureRecipe ini diselesaikan sebelum provides-nya; templat provides: yang menyebut kunci yang tidak dideklarasikan akan berhenti. Ini adalah aturan yang sama dengan yang diikuti blok locals: milik Recipe — lihat entities/recipe.md “Blok locals:”.
Perilaku cakupan. Untuk executionScope: component (default), locals: dievaluasi per instans komponen yang dilampiri terhadap konteks mandiri di atas. Untuk executionScope: boundary, locals: dievaluasi per attachment boundary terhadap tampilan cakupan boundary yang berakar di .boundary.*; field per komponen (.context.instance_id, .context.inject, .context.uses) dan .attachment_name tidak tersedia, karena FeatureRecipe berjalan sekali untuk boundary, bukan sekali per komponen. Allowlist field templat cakupan boundary berlaku untuk locals: dengan cara yang sama seperti untuk templat permukaan penulisan FR lainnya. injectMapping, yang berjalan untuk setiap komponen yang dijangkau attachment, membaca satu evaluasi boundary tersebut sebagai .locals-nya. Kontrak evaluasinya — urutan penulisan, pembacaan saudara yang hanya ke bawah, kedua penghentian — identik di kedua cakupan; hanya bentuk konteks di sekitarnya yang berbeda.
Perbedaan dengan overlay injectMapping dan pemetaan pipeline[].with. locals: menghasilkan map yang terlihat di konteks untuk templat hilir; blok ini tidak menyumbang keluaran. injectMapping menulis ke pipa .context.inject milik konsumen (mutasi di sisi pemanggil). pipeline[].with menyediakan payload args untuk plugin Wasm. Ketiga permukaan ini ortogonal — sebuah FeatureRecipe lazimnya menggunakan ketiganya bersama-sama, dengan locals: membawa string turunan bersama yang direferensikan oleh dua permukaan lainnya.
Blok assertions:
FeatureRecipe.spec.assertions: adalah map opsional berisi aturan bernama yang menyatakan invarian implementasi dari FeatureRecipe — aturan lintas-field yang berlaku berdasarkan pipeline Wasm plugin, chart, atau mekanisme spesifik yang menjadi dasar FeatureRecipe tersebut. Setiap kunci adalah pengenal aturan yang muncul dalam pesan kegagalan; setiap nilai adalah badan Go template. Seperti assertion pada Recipe, assertion pada FeatureRecipe adalah properti dari implementasi spesifik; aturan kontrak tingkat Feature berlaku secara terpisah pada fase pipeline yang lebih awal.
spec: implements: core/referenced-secret:^1.0.0 pipeline: - id: fetch_secret plugin: pipeline-step/aws-secrets-manager:1.2.0 function: step assertions: # aws-secrets-manager plugin 1.x requires an explicit region when none is # implied through the Aggregate's infra block. region-supplied-for-secrets-manager: | {{- if not .values.region -}} {{- if not .infra.aws.region -}} {{- fail "aws-secrets-manager plugin 1.x requires either values.region or infra.aws.region to be set" -}} {{- end -}} {{- end -}}Aturan di atas khusus untuk plugin aws-secrets-manager 1.x; aturan ini tidak berlaku jika FeatureRecipe core/referenced-secret yang berbeda yang terikat. Aturan kontrak tingkat Feature dari definisi Feature tetap berlaku berdampingan.
Assertion FeatureRecipe dievaluasi setelah pengikatan FeatureRecipe dan sebelum Resource Generation. Konteks template untuk FR dengan cakupan komponen mencerminkan konteks assertion Recipe (field instans entitas ditambah .provides, .locals, .recipe.metadata, .recipe.source); untuk FR dengan cakupan boundary (executionScope: boundary), assertion dievaluasi terhadap tampilan cakupan boundary (field .boundary.* tersedia; field per komponen tidak). Untuk tata bahasa penulisan lengkap dan contoh yang dikerjakan, lihat templates/assertions-block.md.
Field omits: — mengecualikan dokumen hasil render dari sebuah sumber
Sebagian besar FeatureRecipes tidak pernah memerlukannya. Field ini ditujukan untuk FeatureRecipe yang source:-nya adalah chart yang Anda gunakan apa adanya — paling sering chart yang diambil dari registry — yang merender dokumen yang tidak boleh dikeluarkan oleh attachment: sebuah Secret yang dibuat ulang oleh chart pada setiap render, atau objek yang sudah disediakan oleh komponen host atau operator. omits: mengecualikan dokumen semacam itu dari apa yang dihasilkan FeatureRecipe — atau, untuk file compose yang menjadi sumber FeatureRecipe, sebuah service, volume, atau config yang tidak boleh disumbangkan oleh attachment, dan untuk template CloudFormation yang menjadi sumbernya, sebuah resource.
spec: capability: helm implements: core/observability/collector:1.0.0 source: kind: helm-oci-chart url: oci://registry.example.com/charts/collector version: "0.9.1" omits: # The collector chart ships its own ServiceAccount; the host supplies one. - kind: ServiceAccount name: collector - when: "{{ .infra.without_dashboards }}" kind: ConfigMap name: collector-dashboardsKey ini ditulis dengan cara yang sama pada Recipe, dan Recipe → Field omits: adalah referensi lengkapnya: apa yang dipilih oleh setiap field entri, bahwa when: dievaluasi terlebih dahulu dan nilai false akan menggugurkan entri, bahwa setiap entri yang berlaku harus mengecualikan sesuatu atau build berhenti dengan menyebut entri tersebut, bahwa sumber tetap dirender sepenuhnya dan hanya keluarannya yang disaring, serta provider mana yang mematuhi key ini. Yang berbeda pada FeatureRecipe hanyalah tempat template dievaluasi:
- Template setiap entri dievaluasi terhadap konteks yang sama dengan konteks evaluasi
valuesMapping:milik FeatureRecipe ini, pada cakupan yang dipilih olehexecutionScope-nya. Entri FeatureRecipe berskala komponen dievaluasi sekali per attachment, terhadap.valuesdan.infraattachment tersebut; entri FeatureRecipe berskala boundary dievaluasi sekali per boundary, terhadap tampilan berskala boundary dan.infraattachment boundary. Aturan tentang apa yang boleh dibaca oleh template attachment berlaku pada entri sebagaimana berlaku padavaluesMapping:-nya. - Hanya apa yang dirender oleh
source:milik FeatureRecipe ini sendiri yang disaring.workload:danartifacts:-nya tidak disaring, begitu pula keluaran komponen host: entri sebuah attachment menjangkau chart-nya sendiri, file compose-nya sendiri, atau template CloudFormation-nya sendiri, dan tidak ada yang lain — service compose yang dideklarasikan host dengan key yang sama dalamdocker-compose.yamltempat keduanya digabungkan tidak tersentuh, begitu pula resource yang dideklarasikan host dengan logical ID yang sama dalam stack tempat keduanya digabungkan. Untuk mengubah dokumen yang dirender host, Recipe milik host mendeklarasikan entri tersebut, atau sebuah langkahpipeline:menambalnya.
Penghentian pada sebuah entri menyebut node, provider, FeatureRecipe ini, dan posisi entri dalam daftar omits:-nya; untuk FeatureRecipe berskala boundary, baris di atas pesan menyebut attachment dan boundary-nya.
Untuk contoh lengkap key ini, yang ditulis pada Recipe — Secret yang dihasilkan chart hasil pengambilan dikecualikan, serta penghentian tanpa entri dan pada entri yang tidak cocok dengan apa pun — lihat ai-gateway-own-webhook-certificate.