Skema Aggrega Template Context
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
Tampilan yang disusun compiler dan diteruskan ke template Recipe dan FeatureRecipe selama rendering. Saat me-render FeatureRecipe lampiran, compiler juga mengisi .attachment_name dan .inject dengan konteks yang berlingkup lampiran, .context.render_facts dengan apa yang dilaporkan provider host tentang render host tersebut, dan, pada template yang menghasilkan sumber daya milik lampiran itu sendiri, .context.used_by dengan komponen yang menggunakan host-nya. Untuk FeatureRecipe berlingkup batas (spec.executionScope: boundary), template yang dijalankannya sekali untuk batas tersebut — di antaranya locals, provides, source, valuesMapping, artifacts, dan langkah pipeline miliknya — mendapati pilar .context, .workload, .attachment_name, .inject, dan .inject_raw tidak ada dan sebagai gantinya pilar .boundary.* diisi — lihat blok boundary di bagian bawah properti; injectMapping-nya dijalankan sekali untuk setiap komponen yang dijangkau lampiran, dalam konteks komponen tersebut, sehingga membaca .context.* dan .attachment_name, dan .boundary tidak ditetapkan di sana. Ini TIDAK disimpan ke disk; ini hanya ada di memori compiler selama rendering. Skema ini mendokumentasikan kontrak antara compiler dan penulis template Ops.
Ketersediaan tahap base-rendering, dalam urutan tahap-tahap tersebut dijalankan:
- Evaluasi provides (pembuka locals, lalu provides): hanya pilar lokal-node. Entri locals membaca entri di atasnya dalam bloknya sendiri; template provides membaca seluruh .locals node yang telah di-resolve. Referensi diri dilarang (tidak ada entri provides yang membaca entri lain).
- Resolusi source (publikasi locals + evaluasi source): semua pilar; .source dan .workload tidak ada. Locals tersebut dipublikasikan ke .locals di sini, lalu source: dievaluasi terhadapnya.
- Pemetaan nilai (valuesMapping): semua pilar + .source; .workload tidak ada.
- Sintesis Workload (evaluasi workload): semua pilar + .source; .workload sedang dievaluasi (tidak ada dari referensi diri).
- Evaluasi artefak (artifacts): semua pilar + .source + .workload (konteks terlengkap).
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
context | object | ya | Konteks eksekusi yang dirakit oleh compiler, yang menyediakan data identitas, topologi, dan pengiriman. |
values | object | ya | Payload kognitif opak untuk node ini, yang sudah divalidasi oleh validator skema saat resolusi. Diteruskan tanpa diubah. |
infra | object | ya | Payload ukuran fisik yang diinjeksikan dari Release untuk node ini. Sepenuhnya melewati Developer. |
locals | map of string | ya | Status privat milik Recipe itu sendiri (misalnya, primary_compute, volumes_path). Dievaluasi dalam preamble locals — sebelum provides dari node tersebut — dan dipublikasikan ke pilar ini saat resolusi source. Setiap entri adalah template Go yang dievaluasi terhadap konteks lokal-node yang mandiri, yang membawa entri-entri dari blok yang sama yang telah diresolusi sejauh ini, sehingga sebuah entri BOLEH membaca entri saudara yang didefinisikan DI ATASNYA dan menerima nilai saudara tersebut yang telah diresolusi. Urutan penulisan merupakan bagian dari kontrak di mana pun satu entri membaca entri lain: memindahkan definisi ke bawah pembacanya akan merusak build. Referensi ‘.locals. |
provides | map of string | tidak | Kontrak API publik Recipe. Diisi dari evaluasi provides. Tersedia di valuesMapping base-rendering untuk referensi diri (misalnya, {{ .provides.host }}). TIDAK tersedia di dalam template provides itu sendiri (invarian kemandirian provides). Pemanggil meresolusi kunci inject terhadap nilai-nilai ini. |
features | map of template_attachment | tidak | Setiap lampiran pada node ini, dengan kunci berupa nama instans yang diberikan penulis. Satu pilar memuat semuanya, apa pun yang dihasilkannya — Feature operasional, Feature kredensial, Feature identitas — karena yang berbeda antar-lampiran adalah apa yang dihasilkannya, bukan cara template membacanya. Recipe membacanya untuk menyesuaikan perenderannya dengan kapabilitas yang dilampirkan dan untuk mengonsumsi apa yang dipublikasikan oleh lampiran. Lampiran yang ditulis pada salah satu koneksi node tidak termasuk di dalamnya: lampiran tersebut dibaca di bawah koneksi itu, di .context.uses. |
metadata | object | tidak | Metadata Release dan kompilasi yang menyediakan identitas global untuk penamaan deterministik. Tersedia di semua blok template (valuesMapping, injectMapping, pipeline with). |
attachment_name | string | tidak | Hanya diisi saat merender FeatureRecipe lampiran. Berisi nama instans lampiran — slot yang diisinya dalam featuresSchema entitas pemilik, atau nama bebas yang diberikan penulis (misalnya, ‘admin_password’, ‘db_credentials’). Digunakan untuk menyusun nama resource deterministik yang berbeda per lampiran, disusun setelah nama komponen host: ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}’ jika provider host melaporkan nama yang dirender, seperti yang dilakukan helm — nama host yang dieja dengan karakter yang diizinkan untuk nama Kubernetes, dengan garis bawah pada nama lampiran diubah menjadi tanda hubung — dan ’{{ .context.instance_id }}-{{ .attachment_name }}’ jika provider host tidak melaporkannya. |
inject | object | tidak | Hanya diisi saat merender FeatureRecipe lampiran yang membawa blok inject yang ditulis penulis (misalnya, { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Berbeda dari .context.inject, yang merupakan saluran pengiriman pra-hidrasi milik komponen dasar dari edge uses. Bernilai null/tidak ada untuk lampiran tanpa inject yang ditulis dan untuk Recipes dasar. |
inject_raw | object atau null | tidak | Maksud Developer yang tidak dapat diubah dan belum dimutasi untuk blok inject. 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, sehingga .inject_raw.ssm_param membaca mekanisme kustom dengan cara yang sama seperti .inject_raw.env membaca mekanisme inti. Bernilai null jika Developer sama sekali menghilangkan blok inject. Digunakan oleh Ops untuk pemeriksaan logis (misalnya, {{ if not .inject_raw }}) guna mendeteksi penghilangan sebelum mutasi dari inject mapping. Values atau provides milik komponen sendiri yang mana yang dikirimkan oleh setiap entri dibaca di .context.self_inject, bukan dari teks entri-entri tersebut. |
steps | map of object | tidak | Komunikasi antar-langkah pipeline. Hanya tersedia di dalam blok ‘with:’ pipeline Wasm. Setiap kunci adalah ID langkah pipeline, yang berisi output yang diekspor oleh langkah tersebut. |
source | string atau object atau null | tidak | Konten field source yang telah diresolusi. Pada template sebuah Recipe: diisi saat resolusi source dari field source: milik Recipe setelah evaluasi template Go, tersedia sejak values mapping dan seterusnya (valuesMapping, workload, artifacts), dan bernilai null jika Recipe tidak memiliki source:. Pada template sebuah FeatureRecipe: field source: milik FeatureRecipe itu sendiri setelah evaluasi template Go, dievaluasi sebelum valuesMapping-nya dan dibaca di sana serta pada setiap template yang dievaluasi sesudahnya (omits, workload, artifacts, langkah pipeline), tidak pernah milik komponen host; null jika FeatureRecipe tidak memiliki source:. injectMapping sebuah FeatureRecipe dievaluasi sebelum source-nya dan membaca milik komponen host. Bentuk string = path URI; bentuk object = source terstruktur (misalnya, deskriptor OCI dengan versi yang telah diresolusi). |
workload | workload-v1beta1.schema.json atau null | tidak | Spesifikasi Workload yang telah di-parse untuk node ini. Diisi saat sintesis workload dari field workload: milik Recipe setelah evaluasi template Go + validasi JSON Schema Workload (terhadap workload-v1beta1.schema.json). Tersedia sejak evaluasi artifact dan seterusnya (artifacts) sehingga artifacts dapat mereferensikan field workload tanpa duplikasi (misalnya, ServiceMonitor yang membaca .workload.services.metrics.ports.prom). Bernilai null jika Recipe tidak memiliki blok workload:. Upaya template untuk melakukan dereferensi .workload.* pada nilai null akan gagal dengan error yang jelas saat evaluasi template. |
boundary | object | tidak | Konteks lingkup boundary — hanya diisi saat mengevaluasi template yang dijalankan sekali untuk boundary oleh FeatureRecipe yang spec.executionScope-nya bernilai ‘boundary’. FeatureRecipes lingkup Component tidak menerima pilar ini; context.instance_id, context.inject, context.uses, dan pilar .workload miliknya membawa data per komponen sebagai gantinya. Template FeatureRecipe lingkup boundary yang dijalankan untuk boundary menerima .boundary.* sebagai pengganti pilar-pilar per komponen tersebut; injectMapping-nya berjalan dalam konteks setiap komponen yang dijangkau lampiran, membaca pilar-pilar per komponen tersebut, dan tidak menerima pilar ini. |
Properti tambahan tidak diizinkan.
template-context.context
Konteks eksekusi yang dirakit oleh compiler, yang menyediakan data identitas, topologi, dan pengiriman.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
instance_id | string | ya | ID absolut yang diratakan dari node saat ini (mis., ‘backend’, atau ‘data-layer-zdmain-db’ untuk komponen main-db dari instans modul data-layer), ditulis dalam alfabet yang dipenuhi setiap nama komponen yang ditulis penulis. Deterministik dan stabil di seluruh kompilasi untuk Aggregate yang sama. Ini adalah nama sumber daya yang dibangun untuk node ini yang namanya tidak diturunkan oleh provider mana pun — kumpulan artefak yang ditempatkan dari Recipe, dan workload yang disintesis oleh provider yang menamainya berdasarkan identitas — sehingga alamat yang dipublikasikan untuk salah satunya dibangun dari nilai ini. |
rendered_name | string | tidak | Nama yang diberikan provider yang terikat ke node ini kepada sumber daya yang direndernya untuk node tersebut — untuk source yang disediakan penulis, nama yang digunakan oleh templat yang disediakan itu sendiri saat dirender, seperti nama rilis yang dibaca chart; untuk workload yang disintesisnya, nama yang diberikannya kepada sumber daya workload tersebut jika provider menurunkan nama alih-alih menulis identitas node, seperti yang dilakukan provider helm dengan nama rilis yang sama. Bacalah nilai ini di mana pun Recipe ini menamai sumber daya yang dideklarasikan oleh chart atau modul yang disediakan atau yang disintesis oleh provider semacam itu, baik dalam entri provides, valuesMapping, workload, entri artifacts, maupun with atau when dari langkah pipeline, karena provider dapat mengeja nama tersebut dalam alfabet yang lebih terbatas daripada alfabet nama komponen yang ditulis penulis, sehingga keduanya kemudian berbeda. Kosong jika provider yang terikat tidak menurunkan nama semacam itu: sumber daya dari kumpulan artefak yang ditempatkan, dan dari workload yang disintesis oleh provider yang menamainya berdasarkan identitas, membawa identitas node, jadi bacalah ’{{ .context.instance_id }}’ untuk itu, dan Recipe yang menulis nama sumber dayanya sendiri sudah mengetahuinya. Membaca kunci ini di tempat provider yang terikat tidak melaporkan nama akan menghentikan build dan menyebutkan apa yang harus ditulis sebagai gantinya. Penolakan ini mencakup templat yang ditulis Recipe secara inline; valuesMapping, workload, atau entri artifacts yang disediakan melalui ‘$import’ baru di-resolve saat render mencapainya, sehingga referensi di dalamnya dirender sebagai nilai kosong alih-alih menghentikan build. Pada templat FeatureRecipe yang terikat ke attachment sebuah komponen, nilai ini adalah nama komponen HOST sebagaimana dilaporkan oleh provider milik host itu sendiri — nilai yang dibaca oleh Recipe milik host, sama seperti instance_id di sana adalah identitas host — sehingga attachment menamai sumber daya berdasarkan host-nya dari nilai ini dan mendapatkan nama yang diterima platform host. Jika provider host tidak melaporkan nama, nilainya kosong, dan membacanya dari templat inline attachment selain injectMapping-nya akan menghentikan build; bacalah ’{{ .context.instance_id }}’ di sana sebagai gantinya. |
labels | map of string | tidak | Label duck-typing dan ontologi dari node saat ini, termasuk perubahan apa pun yang dibuat pada saat konstruksi topologi oleh plugin tata kelola yang dilampirkan dalam peran label-transform. |
annotations | object | tidak | Tiga wadah anotasi berjenjang untuk node saat ini, dipisahkan berdasarkan asal. |
inject | object | ya | Saluran pengiriman yang telah dihidrasi sebelumnya dan diintersepsi. Dimulai sebagai map yang dihasilkan kompilator yang me-resolve kunci inject Developer ke nilai provides Target. Dimutasi di tempat oleh deep-merge injectMapping. Pada saat Base Recipe dirender, ini berisi string fisik yang sepenuhnya ter-resolve. |
uses | map of enriched_edge | ya | Map edge topologis yang diperkaya. Dikunci berdasarkan alias Developer (mis., ‘my_db’, ‘my_api’). Setiap entri adalah tampilan yang dirakit kompilator atas identitas node target, provides yang ter-resolve, pemetaan injeksi, dan anotasi berjenjang, serta atas attachment yang ditulis pada koneksi tersebut — dan, untuk FeatureRecipe yang mendeklarasikan readsTargetRenderFacts, atas apa yang dilaporkan oleh render target. Ini BUKAN edge IR mentah — ini adalah proyeksi yang diperkaya yang dibangun kompilator khusus untuk dikonsumsi templat. Templat yang melakukan range atas map ini melihat koneksi dalam urutan kunci — diurutkan berdasarkan alias — bukan dalam urutan penulisannya. |
self_inject | object | ya | Menunjukkan values dan provides milik komponen itu sendiri yang telah diberi nama pengiriman oleh developer, dibaca dari blok inject: yang ditulis pada komponen itu sendiri — blok yang disimpan .inject_raw sebagaimana ditulis, dan disimpan .context.inject dalam bentuk yang telah di-resolve. Setiap mekanisme yang disebutkan blok itu (env, file, arg, atau mekanisme kustom seperti ssm_param) memetakan setiap nama yang ditulis developer ke kunci milik komponen sendiri yang dikirimkan entri tersebut, sebagaimana .context.uses. |
used_by | inbound_edge[] | tidak | Komponen-komponen yang menggunakan komponen ini: satu entri per koneksi uses yang dibuat komponen lain kepadanya, dalam urutan penulisan komponen yang terhubung, lalu urutan entri uses masing-masing. Komponen yang terhubung dua kali muncul dua kali. Hanya dibaca oleh FeatureRecipe yang dilampirkan ke komponen, dan hanya dalam templat yang menghasilkan sumber daya attachment itu sendiri — valuesMapping, workload, dan artifacts-nya. Tidak tersedia pada templat Recipe milik komponen itu sendiri, pada injectMapping, dan pada with dan when dari langkah pipeline, karena keluaran masing-masing dapat berakhir di keluaran render komponen itu sendiri, yang tetap sama siapa pun yang terhubung kepadanya. Setiap entri adalah item daftar, bukan kunci, sehingga templat yang melakukan range atasnya menemui pemanggil dalam urutan tersebut. |
render_facts | render_facts | tidak | Apa yang dilaporkan provider yang merender komponen ini tentang keluaran yang dihasilkannya — render facts yang dilaporkannya — dikunci berdasarkan nama fakta. Nama mana yang dilaporkan provider, dan apa isi setiap entri, adalah kontrak terdokumentasi milik provider itu sendiri. Setiap nilai berupa daftar, bahkan dengan satu entri, sehingga templat selalu melakukan range atasnya; jika render komponen memerlukan lebih dari satu panggilan provider dan satu nama dilaporkan oleh beberapa di antaranya, daftarnya digabung menjadi satu dalam urutan panggilan dijalankan. Tersedia pada setiap templat FeatureRecipe yang dilampirkan ke komponen — valuesMapping, workload, artifacts, serta with dan when dari langkah pipeline-nya — setelah komponen dirender, dan kosong jika provider-nya tidak melaporkan apa pun, sehingga nama yang tidak dilaporkan siapa pun terbaca sebagai daftar kosong. Tidak tersedia pada templat Recipe milik komponen itu sendiri dan pada injectMapping, yang dijalankan sebelum komponen dirender. |
Properti tambahan tidak diizinkan.
template-context.context.annotations
Tiga wadah anotasi berjenjang untuk node saat ini, dipisahkan berdasarkan asal.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release | map of string | tidak | String topologi fisik yang berjenjang dari batas Release. |
catalog | map of string | tidak | Sifat intrinsik yang tidak dapat diubah, ditulis oleh Platform Architect di Domain 2. |
aggregate | map of string | tidak | Metadata kognitif yang berjenjang dari subsistem Aggregate. |
Properti tambahan tidak diizinkan.
template-context.context.inject
Saluran pengiriman yang telah dihidrasi sebelumnya dan diintersepsi. Dimulai sebagai map yang dihasilkan kompilator yang me-resolve kunci inject Developer ke nilai provides Target. Dimutasi di tempat oleh deep-merge injectMapping. Pada saat Base Recipe dirender, ini berisi string fisik yang sepenuhnya ter-resolve.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman variabel lingkungan. Kunci adalah nama variabel lokal Developer, nilai adalah string target yang ter-resolve. |
file | map of string | tidak | Pengiriman mount file. Kunci adalah path file lokal, nilai adalah string target yang ter-resolve. |
arg | map of string | tidak | Pengiriman argumen baris perintah. Kunci adalah prefiks flag, nilai adalah string target yang ter-resolve. |
all | map of string | tidak | Gabungan datar yang telah dihitung sebelumnya dari mekanisme env + file + arg + kustom. Diisi setelah resolusi uses-inject dan dihitung ulang setelah pemetaan inject. Templat menggunakan {{ toJson .context.inject.all }} untuk serialisasi universal. |
template-context.context.self_inject
Menunjukkan values dan provides milik komponen itu sendiri yang telah diberi nama pengiriman oleh developer, dibaca dari blok inject: yang ditulis pada komponen itu sendiri — blok yang disimpan .inject_raw sebagaimana ditulis, dan disimpan .context.inject dalam bentuk yang telah di-resolve. Setiap mekanisme yang disebutkan blok itu (env, file, arg, atau mekanisme kustom seperti ssm_param) memetakan setiap nama yang ditulis developer ke kunci milik komponen sendiri yang dikirimkan entri tersebut, sebagaimana .context.uses.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman variabel lingkungan: kunci adalah nama variabel developer, nilai adalah kunci milik komponen sendiri yang dikirimkan setiap entri. |
file | map of string | tidak | Pengiriman mount file: kunci adalah path file developer, nilai adalah kunci milik komponen sendiri yang dikirimkan setiap entri. |
arg | map of string | tidak | Pengiriman argumen baris perintah: kunci adalah prefiks flag developer, nilai adalah kunci milik komponen sendiri yang dikirimkan setiap entri. |
template-context.metadata
Metadata Release dan kompilasi yang menyediakan identitas global untuk penamaan deterministik. Tersedia di semua blok template (valuesMapping, injectMapping, pipeline with).
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release_name | string | tidak | Nama Release yang sedang di-build (mis., ‘prod-billing’). Digunakan oleh Ops untuk menyusun nama sumber daya cloud yang unik secara global (bucket S3, peran IAM). Digabungkan dengan .context.instance_id untuk menjamin keunikan di seluruh lingkungan. |
release_version | string | tidak | Versi semantik dari Release. |
environment | string | tidak | String lingkungan dari metadata Release (mis., ‘production’, ‘local’). |
aggregate_name | string | tidak | Nama Aggregate akar yang sedang dikompilasi. |
Properti tambahan tidak diizinkan.
template-context.inject
Hanya diisi saat merender FeatureRecipe lampiran yang membawa blok inject yang ditulis penulis (misalnya, { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Berbeda dari .context.inject, yang merupakan saluran pengiriman pra-hidrasi milik komponen dasar dari edge uses. Bernilai null/tidak ada untuk lampiran tanpa inject yang ditulis dan untuk Recipes dasar.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman variabel lingkungan dengan cakupan attachment. |
file | map of string | tidak | Pengiriman mount file dengan cakupan attachment. |
arg | map of string | tidak | Pengiriman argumen dengan cakupan attachment. |
all | map of string | tidak | Gabungan praktis yang dihasilkan compiler dari setiap paradigma inject attachment. |
template-context.boundary
Konteks lingkup boundary — hanya diisi saat mengevaluasi template yang dijalankan sekali untuk boundary oleh FeatureRecipe yang spec.executionScope-nya bernilai ‘boundary’. FeatureRecipes lingkup Component tidak menerima pilar ini; context.instance_id, context.inject, context.uses, dan pilar .workload miliknya membawa data per komponen sebagai gantinya. Template FeatureRecipe lingkup boundary yang dijalankan untuk boundary menerima .boundary.* sebagai pengganti pilar-pilar per komponen tersebut; injectMapping-nya berjalan dalam konteks setiap komponen yang dijangkau lampiran, membaca pilar-pilar per komponen tersebut, dan tidak menerima pilar ini.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | tidak | Path batas Release tempat FeatureRecipe dilampirkan: nama-nama batas dari yang terluar ke dalam, digabungkan dengan ’/’ (mis. ‘bridge’, ‘bridge/frontend’). Path ini menamai batasnya, bukan direktori tempat output-nya ditulis, yang ditetapkan oleh directory: milik batas tersebut. |
assembly_path | string | tidak | Direktori, relatif terhadap direktori output build, tempat output milik lampiran ini sendiri dirakit: directory: dan subDirectory: hasil evaluasi dari batasnya, yaitu direktori tujuan build mengarahkan output tersebut (mis. ‘bridge/compose’). Nilainya sama persis dengan source_assembly_path atau target_assembly_path suatu endpoint koneksi jika dan hanya jika endpoint tersebut di-render ke berkas rakitan yang sama, sehingga FeatureRecipe membandingkannya untuk membedakan koneksi di dalam berkasnya sendiri dari koneksi di berkas lain. Data opak; inti tidak menafsirkannya. |
boundary_name | string | tidak | Nama boundary (kunci map di release.spec.boundaries). |
components | object | tidak | Map dari instance_id ke sebuah entri untuk setiap komponen dalam subtree boundary (rekursif, termasuk komponen boundary bersarang). Setiap entri memuat URI tipe komponen yang telah di-resolve, ID instance, dan nilai yang disediakan dari evaluasi provides per komponen. |
internal_uses_edges | object[] | tidak | Edge uses yang sumber DAN targetnya sama-sama berada dalam subtree boundary ini. |
outgoing_cross_boundary_uses_edges | object[] | tidak | Edge uses yang sumbernya berada di subtree batas ini dan targetnya di luarnya. |
incoming_cross_boundary_uses_edges | object[] | tidak | Edge uses yang targetnya berada dalam subtree, sedangkan sumbernya di luar. Digunakan oleh agregator bergaya ingress yang perlu mengetahui siapa yang memanggil masuk. |
cross_boundary_uses_edges | object[] | tidak | Gabungan praktis dari edge lintas boundary yang keluar dan yang masuk. |
labels | map of string | tidak | Gabungan label komponen dalam subtree, dengan mempertahankan urutan penulisan oleh penulis. |
annotations | map of string | tidak | Anotasi milik boundary itu sendiri setelah cascade di-resolve. |
feature_attachments | template_attachment[] | tidak | Attachment yang dipasang langsung pada boundary ini (untuk referensi lintas attachment dalam cakupan boundary), dalam bentuk attachment yang sama dengan yang dibawa .features. |
Properti tambahan tidak diizinkan.
Definisi
inbound_edge
Satu koneksi yang dibuat oleh komponen lain ke komponen yang dirender oleh FeatureRecipe yang terlampir: siapa yang terhubung, melalui socket mana, apa yang dipublikasikan oleh komponen yang terhubung, serta namespace dan boundary tempat komponen tersebut ditempatkan. Setiap nilai adalah string yang dibawa oleh compiler tanpa menafsirkannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
component_id | string | ya | ID instance yang diratakan dari komponen yang terhubung (misalnya, ‘frontend’ atau ‘data-layer.etl’) — nilai yang dibaca oleh template path subDirectory sebagai .component_id, dieja seperti .context.uses. |
socket | string | ya | Kategori usesSchema yang digunakan oleh komponen yang terhubung untuk membuat koneksi ini (misalnya, ‘databases’, ‘apis’). |
provides | map of string | ya | Provides yang telah di-resolve dari komponen yang terhubung, dipersempit ke kunci yang dideklarasikan oleh Component-nya — nilai yang sama yang dibaca oleh konsumen komponen tersebut di .context.uses. |
source_namespace | string | tidak | Namespace tempat komponen yang terhubung ditempatkan: anotasi aggrega.ai/namespace yang diterima oleh render komponen itu sendiri — anotasi dari boundary-nya, dengan anotasi entri Release miliknya sendiri diterapkan terakhir, sehingga komponen yang entrinya menetapkan atau mengosongkan namespace membawa pengaturannya sendiri, bukan pengaturan boundary-nya. Ini adalah nilai yang dibaca oleh FeatureRecipe dengan cakupan boundary sebagai source_namespace pada entri koneksi yang sama dalam daftar uses-edge .boundary. Tidak ada jika tidak ada namespace yang berlaku untuk komponen yang terhubung; lindungi dengan if atau with sebelum mencetaknya. |
source_boundary_path | string | tidak | Path yang dipisahkan garis miring dari boundary Release yang memuat komponen yang terhubung (misalnya ‘edge’ atau ‘aws-prod/payments’) — nilai yang dibaca oleh FeatureRecipe dengan cakupan boundary sebagai source_boundary_path pada entri koneksi yang sama dalam daftar uses-edge .boundary. |
render_facts | render_facts | tidak | Apa yang dilaporkan oleh render komponen yang terhubung tentang output yang dihasilkannya, dengan kunci nama fakta: fakta yang dilaporkan oleh pemanggilan provider miliknya sendiri, kemudian fakta dari setiap Feature yang terlampir padanya yang dirender bersamanya, sesuai urutan render, dengan daftar yang diperoleh satu nama dari beberapa di antaranya digabungkan menjadi satu dalam urutan tersebut. Setiap nilai adalah daftar, bahkan dengan satu entri, sehingga template selalu melakukan range atasnya. Hanya ada untuk FeatureRecipe yang mendeklarasikan readsCallerRenderFacts — yang lampirannya dirender setelah setiap komponen selesai dirender, sehingga render setiap pemanggil telah lengkap — dan dalam hal itu ada pada setiap entri, kosong untuk pemanggil yang provider-nya tidak melaporkan apa pun. Tidak ada untuk setiap FeatureRecipe lainnya. |
Properti tambahan tidak diizinkan.
render_facts
Fakta render dengan kunci nama: apa yang dilaporkan oleh provider yang merender sebuah komponen tentang output yang dihasilkannya. Nama mana yang dilaporkan oleh provider, dan apa isi setiap entri, merupakan kontrak terdokumentasi milik provider itu sendiri; compiler tidak mengetahui apa pun tentang keduanya selain bahwa setiap nilai adalah daftar. Sebuah daftar mempertahankan urutan entrinya. Entri berupa objek dibawa dengan kunci-kuncinya dalam urutan yang ditulis oleh provider, dan template yang melakukan range atasnya menemuinya dalam urutan kunci, seperti halnya setiap map berkunci pada konteks ini.
Objek bebas; nilainya adalah any[].
template_attachment
Satu lampiran sebagaimana dibaca oleh templat: tampilan per instans dari Feature yang dilampirkan. Setiap lampiran mengekspos bidang yang sama terlepas dari apa yang dihasilkannya, sehingga .features.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | tidak | URI Feature Catalog dari Feature yang terlampir. |
resolved_version | string | tidak | Versi Feature yang dilampirkan setelah resolusi Manifest — versi yang benar-benar terikat untuk build ini, dibaca sebagai .features. |
labels | map of string | tidak | Label Catalog dari Feature yang dilampirkan, dibawa apa adanya dalam urutan yang dideklarasikan Feature — tidak ada yang difilter, diganti namanya, atau dihapus prefiksnya, sehingga templat membaca persis apa yang ditulis oleh pembuat Feature. Memungkinkan templat bercabang berdasarkan jenis Feature yang dilampirkan, bukan berdasarkan nama atau URI-nya. Mencerminkan .context.uses.if atau lakukan range atas map sebelum mengakses label individual. |
values | object | tidak | Pilar developer-intent milik lampiran itu sendiri, dibawa apa adanya dari deklarasi lampiran. |
infra | object | tidak | Pilar operational-sizing milik lampiran itu sendiri, dibawa apa adanya dari deklarasi lampiran. |
provides | map of string | tidak | Kontrak publik teresolusi dari FeatureRecipe yang terikat pada lampiran ini — nama sumber daya yang dihasilkan, kuncinya, sebuah identitas, dan kunci tambahan apa pun yang dihasilkan — diekspos ke konsumen sebagai .features. |
Properti tambahan tidak diizinkan.
enriched_edge
Satu edge topologis yang diperkaya, yang disusun oleh compiler. Berisi identitas target yang telah di-resolve, provides, dan anotasi yang di-cascade.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
target | string | ya | ID absolut yang telah diratakan dari node target (mis., ‘data-layer.main-db’). |
socket | string | ya | Kategori usesSchema tempat edge ini berada (mis., ‘databases’, ‘apis’). |
source | string | tidak | ID absolut yang telah diratakan dari node sumber (konsumen). Diisi untuk tampilan boundary-scope yang mengindeks output per konsumen berdasarkan node konsumen. |
source_namespace | string | tidak | Anotasi aggrega.ai/namespace mentah dari endpoint sumber (kosong bila tidak ada). Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. Data opak untuk resolusi identitas jaringan oleh provider; inti tidak menafsirkannya. |
source_boundary_path | string | tidak | Path boundary dari endpoint sumber: path yang dipisahkan garis miring dari batas Release yang memuatnya (mis. ‘bridge/frontend’). Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. |
source_assembly_path | string | tidak | Path perakitan dari endpoint sumber: direktori, relatif terhadap direktori output build, tempat output-nya dirakit, yang disusun dari directory: dan subDirectory: hasil evaluasi dari batasnya (mis. ‘bridge/compose’). Dua endpoint dengan satu path perakitan yang sama di-render ke satu berkas rakitan, dan endpoint yang path perakitannya sama dengan .boundary.assembly_path di-render ke berkas tempat output milik FeatureRecipe yang membacanya dirakit. FeatureRecipe berlingkup batas yang menempatkan endpoint pada jaringan dapat membacanya sebagai jaringan endpoint sumber ketika tidak ada aggrega.ai/namespace yang berlaku. Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. Data opak; inti tidak menafsirkannya. |
target_namespace | string | tidak | Anotasi aggrega.ai/namespace mentah dari endpoint target (kosong bila tidak ada). Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. Data opak untuk resolusi identitas jaringan oleh provider. |
target_boundary_path | string | tidak | Path boundary dari endpoint target: path yang dipisahkan garis miring dari batas Release yang memuatnya (mis. ‘bridge/backend’). Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. |
target_assembly_path | string | tidak | Path perakitan dari endpoint target: direktori, relatif terhadap direktori output build, tempat output-nya dirakit, yang disusun dari directory: dan subDirectory: hasil evaluasi dari batasnya (mis. ‘bridge/compose’). Endpoint yang path perakitannya sama dengan .boundary.assembly_path di-render ke berkas tempat output milik FeatureRecipe yang membacanya dirakit. FeatureRecipe berlingkup batas yang menempatkan endpoint pada jaringan dapat membacanya sebagai jaringan endpoint target ketika tidak ada aggrega.ai/namespace yang berlaku. Diisi hanya untuk tampilan boundary-scope, sebagaimana source; entri .context.uses milik komponen itu sendiri membawanya dalam keadaan kosong. Data opak; inti tidak menafsirkannya. |
provides | map of string | ya | Kamus provides node target yang telah di-resolve sepenuhnya. Dievaluasi pada evaluasi provides, sebelum hidrasi inject. |
inject | object | ya | Pemetaan inject asli dari Developer untuk edge ini (kunci = nama variabel lokal, nilai = kunci provides target). Ini adalah pemetaan MENTAH, bukan nilai yang telah di-resolve. |
labels | map of string | tidak | Label duck-typing dan ontologi node target (setelah mutasi dari konstruksi topologi). |
annotations | object | tidak | Tiga bucket anotasi bertingkat milik node target. |
component | string | tidak | URI jenis komponen Catalog dari node target (mis., ‘core/postgres’). |
resolved_version | string | tidak | SemVer node target yang telah di-resolve. |
boundary_path | string | tidak | Hierarki spasial fisik node target dari Release (mis., ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | tidak | Jika edge ini dideklarasikan secara otonom oleh sebuah Feature (termasuk Features kredensial berlabel feature.aggrega.ai/kind: secret), nama instans Feature tersebut. Null/tidak ada untuk edge yang dideklarasikan oleh Developer. |
origin_release | boolean | tidak | True bila Release yang menyambungkan koneksi ini, bukan Aggregate yang mendeklarasikannya. Tidak ada untuk koneksi yang dideklarasikan oleh Aggregate. |
values | object | tidak | Konfigurasi developer per koneksi yang ditulis pada entri uses milik Aggregate untuk koneksi ini, dibawa apa adanya. Tidak ada bila koneksi tidak membawanya. Konfigurasi ini hanya sampai ke konteks node konsumen, tidak pernah ke konteks target. |
infra | object | tidak | Konfigurasi operasional per koneksi yang ditulis pada entri uses milik Release untuk koneksi ini, dibawa apa adanya. Tidak ada bila koneksi tidak membawanya. Konfigurasi ini hanya sampai ke konteks node konsumen, tidak pernah ke konteks target. |
features | map of template_attachment | tidak | Attachment yang ditulis pada koneksi ini, dengan kunci berupa nama slot yang dideklarasikan socket koneksi untuk masing-masing, masing-masing dalam bentuk attachment yang dibawa .features: type-nya, versi yang di-resolve, labels, values, infra, dan provides yang di-resolve dari FeatureRecipe yang terikat padanya. Sebuah Recipe membaca kredensial suatu koneksi sebagai .context.uses. |
render_facts | render_facts | tidak | Apa yang dilaporkan render target tentang output yang dihasilkannya, diindeks berdasarkan nama fakta, dalam bentuk yang dibawa entri pemanggil pada .context.used_by: fakta yang dilaporkan oleh panggilan provider miliknya sendiri, lalu fakta dari setiap Feature yang terpasang padanya yang di-render bersamanya, dalam urutan render, dengan daftar yang diperoleh satu nama dari beberapa di antaranya digabung menjadi satu dalam urutan tersebut. Setiap nilai adalah daftar, bahkan dengan satu entri, sehingga template selalu melakukan range atasnya. Hanya ada pada .context.uses untuk FeatureRecipe yang mendeklarasikan readsTargetRenderFacts — yang attachment-nya di-render setelah setiap komponen selesai di-render, sehingga render setiap target sudah lengkap — dan kemudian ada pada setiap entri, kosong untuk target yang provider-nya tidak melaporkan apa pun. Tidak ada untuk setiap FeatureRecipe lainnya, pada with dan when dari langkah pipeline, pada template Recipe milik komponen itu sendiri, dan pada daftar edge yang dibaca FeatureRecipe boundary-scope. |
Properti tambahan tidak diizinkan.
enriched_edge.inject
Pemetaan inject asli dari Developer untuk edge ini (kunci = nama variabel lokal, nilai = kunci provides target). Ini adalah pemetaan MENTAH, bukan nilai yang telah di-resolve.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target. |
file | map of string | tidak | Pengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target. |
arg | map of string | tidak | Pengiriman melalui argumen baris perintah: kunci adalah prefiks flag konsumen, nilai adalah kunci provides milik target. |
enriched_edge.annotations
Tiga bucket anotasi bertingkat milik node target.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release | map of string | tidak | String topologi fisik dari boundary Release milik node target. |
catalog | map of string | tidak | Sifat tetap dari entitas Catalog milik node target. |
aggregate | map of string | tidak | Metadata kognitif dari subsistem Aggregate milik node target. |
Properti tambahan tidak diizinkan.