Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

PropertiJenisWajibDeskripsi
contextobjectyaKonteks eksekusi yang dirakit oleh compiler, yang menyediakan data identitas, topologi, dan pengiriman.
valuesobjectyaPayload kognitif opak untuk node ini, yang sudah divalidasi oleh validator skema saat resolusi. Diteruskan tanpa diubah.
infraobjectyaPayload ukuran fisik yang diinjeksikan dari Release untuk node ini. Sepenuhnya melewati Developer.
localsmap of stringyaStatus 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.’ ke entri yang lebih belakang, atau ke kunci yang tidak dideklarasikan oleh blok, akan menghentikan proses. Pemeriksaan ini membaca path yang DIRESOLUSI oleh referensi, bukan ketikannya, sehingga mencakup secara sama bentuk langsung, pembacaan di dalam blok ’{{ with .locals }}’, pembacaan melalui variabel yang diikat langsung ke ‘.locals’, dan kunci yang dibaca dari blok dalam tanda kurung, ‘(.locals).’ atau ’($.locals).’. Satu penulisan yang tidak dicakupnya: referensi yang path-nya tidak ditentukan oleh teks template — yang dicapai melalui fungsi, seperti ‘index .locals’ atau ‘(default dict .locals).’, atau melalui blok ‘with’ atau pengikatan variabel yang pipeline-nya menerapkan fungsi tersebut. Referensi semacam itu tidak dianalisis, dan kunci yang tidak ada yang dicapai dengan cara itu tidak menghentikan proses: kunci tersebut merender teks literal '' alih-alih tidak merender apa pun. Satu-satunya pengecualian adalah ‘index’ itu sendiri: pada setiap permukaan template, fungsi ini menghentikan proses, dengan menyebutkan kuncinya, ketika map yang dibacanya tidak memuat kunci yang diminta, sehingga kunci yang tidak ada yang dicapai melalui ‘index .locals’ akan menghentikan proses. Entri locals tidak dapat membaca ‘.provides’. Tersedia di provides (saat evaluasi provides, setelah preamble), source, valuesMapping, workload, artifacts, assertions, dan bagi plugin Wasm hilir melalui pipeline[].with (dan pipeline[].when). Tidak pernah diekspos ke pemanggil.
providesmap of stringtidakKontrak 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.
featuresmap of template_attachmenttidakSetiap 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..features., sehingga template yang melakukan range atas pilar ini hanya menemui lampiran milik node itu sendiri.
metadataobjecttidakMetadata Release dan kompilasi yang menyediakan identitas global untuk penamaan deterministik. Tersedia di semua blok template (valuesMapping, injectMapping, pipeline with).
attachment_namestringtidakHanya 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.
injectobjecttidakHanya 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_rawobject atau nulltidakMaksud 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.
stepsmap of objecttidakKomunikasi 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.
sourcestring atau object atau nulltidakKonten 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).
workloadworkload-v1beta1.schema.json atau nulltidakSpesifikasi 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.
boundaryobjecttidakKonteks 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.

PropertiJenisWajibDeskripsi
instance_idstringyaID 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_namestringtidakNama 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.
labelsmap of stringtidakLabel 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.
annotationsobjecttidakTiga wadah anotasi berjenjang untuk node saat ini, dipisahkan berdasarkan asal.
injectobjectyaSaluran 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.
usesmap of enriched_edgeyaMap 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_injectobjectyaMenunjukkan 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..inject memetakan nama-nama sebuah koneksi ke kunci yang dibacanya: ‘provides.’ untuk entri yang ditulis dengan from: ; ‘values.’ untuk entri yang template value: miliknya membaca tepat satu dari values milik komponen sendiri dan tidak membaca hal lain, dengan sebagai kunci tingkat atas dari nilai itu, apa pun teks atau fungsi yang mengelilingi pembacaan dan seberapa dalam pun pembacaan itu masuk ke dalam nilai — ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’, dan ’{{ (default dict .values.config).port }}’ semuanya dipetakan ke ‘values.config’; dan string kosong untuk setiap entri lainnya — literal, template yang membaca dua nilai, template yang membaca apa pun selain values, atau template yang pembacaan values-nya tidak dikaitkan oleh teks ke satu kunci tingkat atas, seperti ’{{ index .values “role” }}’, values yang dibaca utuh, atau seluruh konteks yang diserahkan ke sebuah fungsi. Jadi, Recipe yang mengirimkan nilai miliknya sendiri dengan nama default memeriksa apakah suatu entri sudah dipetakan ke ‘values.’ dan, jika ada, melewati nama default-nya, misalnya {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Ada dan kosong ketika developer tidak menulis blok apa pun; sebuah mekanisme hanya muncul ketika blok menyebutkannya, dan template menemui nama-nama itu dalam keadaan terurut bagaimanapun template membacanya. Dibaca dari teks yang ditulis developer, tidak pernah dari nilai yang telah di-resolve.
used_byinbound_edge[]tidakKomponen-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_factsrender_factstidakApa 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.

PropertiJenisWajibDeskripsi
releasemap of stringtidakString topologi fisik yang berjenjang dari batas Release.
catalogmap of stringtidakSifat intrinsik yang tidak dapat diubah, ditulis oleh Platform Architect di Domain 2.
aggregatemap of stringtidakMetadata 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.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman variabel lingkungan. Kunci adalah nama variabel lokal Developer, nilai adalah string target yang ter-resolve.
filemap of stringtidakPengiriman mount file. Kunci adalah path file lokal, nilai adalah string target yang ter-resolve.
argmap of stringtidakPengiriman argumen baris perintah. Kunci adalah prefiks flag, nilai adalah string target yang ter-resolve.
allmap of stringtidakGabungan 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..inject memetakan nama-nama sebuah koneksi ke kunci yang dibacanya: ‘provides.’ untuk entri yang ditulis dengan from: ; ‘values.’ untuk entri yang template value: miliknya membaca tepat satu dari values milik komponen sendiri dan tidak membaca hal lain, dengan sebagai kunci tingkat atas dari nilai itu, apa pun teks atau fungsi yang mengelilingi pembacaan dan seberapa dalam pun pembacaan itu masuk ke dalam nilai — ’{{ .values.config.port }}’, ’{{ index .values.config “port” }}’, dan ’{{ (default dict .values.config).port }}’ semuanya dipetakan ke ‘values.config’; dan string kosong untuk setiap entri lainnya — literal, template yang membaca dua nilai, template yang membaca apa pun selain values, atau template yang pembacaan values-nya tidak dikaitkan oleh teks ke satu kunci tingkat atas, seperti ’{{ index .values “role” }}’, values yang dibaca utuh, atau seluruh konteks yang diserahkan ke sebuah fungsi. Jadi, Recipe yang mengirimkan nilai miliknya sendiri dengan nama default memeriksa apakah suatu entri sudah dipetakan ke ‘values.’ dan, jika ada, melewati nama default-nya, misalnya {{ range $name, $key := .context.self_inject.env }}{{ if eq $key “values.role” }}…{{ end }}{{ end }}. Ada dan kosong ketika developer tidak menulis blok apa pun; sebuah mekanisme hanya muncul ketika blok menyebutkannya, dan template menemui nama-nama itu dalam keadaan terurut bagaimanapun template membacanya. Dibaca dari teks yang ditulis developer, tidak pernah dari nilai yang telah di-resolve.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman variabel lingkungan: kunci adalah nama variabel developer, nilai adalah kunci milik komponen sendiri yang dikirimkan setiap entri.
filemap of stringtidakPengiriman mount file: kunci adalah path file developer, nilai adalah kunci milik komponen sendiri yang dikirimkan setiap entri.
argmap of stringtidakPengiriman 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).

PropertiJenisWajibDeskripsi
release_namestringtidakNama 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_versionstringtidakVersi semantik dari Release.
environmentstringtidakString lingkungan dari metadata Release (mis., ‘production’, ‘local’).
aggregate_namestringtidakNama 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.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman variabel lingkungan dengan cakupan attachment.
filemap of stringtidakPengiriman mount file dengan cakupan attachment.
argmap of stringtidakPengiriman argumen dengan cakupan attachment.
allmap of stringtidakGabungan 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.

PropertiJenisWajibDeskripsi
pathstringtidakPath 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_pathstringtidakDirektori, 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_namestringtidakNama boundary (kunci map di release.spec.boundaries).
componentsobjecttidakMap 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_edgesobject[]tidakEdge uses yang sumber DAN targetnya sama-sama berada dalam subtree boundary ini.
outgoing_cross_boundary_uses_edgesobject[]tidakEdge uses yang sumbernya berada di subtree batas ini dan targetnya di luarnya.
incoming_cross_boundary_uses_edgesobject[]tidakEdge 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_edgesobject[]tidakGabungan praktis dari edge lintas boundary yang keluar dan yang masuk.
labelsmap of stringtidakGabungan label komponen dalam subtree, dengan mempertahankan urutan penulisan oleh penulis.
annotationsmap of stringtidakAnotasi milik boundary itu sendiri setelah cascade di-resolve.
feature_attachmentstemplate_attachment[]tidakAttachment 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.

PropertiJenisWajibDeskripsi
component_idstringyaID 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..target mengeja ujung lain dari sebuah koneksi.
socketstringyaKategori usesSchema yang digunakan oleh komponen yang terhubung untuk membuat koneksi ini (misalnya, ‘databases’, ‘apis’).
providesmap of stringyaProvides 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..provides. Kosong jika komponen tersebut tidak memublikasikan apa pun.
source_namespacestringtidakNamespace 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_pathstringtidakPath 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_factsrender_factstidakApa 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. dibaca dengan cara yang sama, baik nama tersebut merupakan slot yang dideklarasikan entitas maupun lampiran bebas.

PropertiJenisWajibDeskripsi
typestringtidakURI Feature Catalog dari Feature yang terlampir.
resolved_versionstringtidakVersi Feature yang dilampirkan setelah resolusi Manifest — versi yang benar-benar terikat untuk build ini, dibaca sebagai .features..resolved_version. Mencerminkan .context.uses..resolved_version, sehingga lampiran dan edge melaporkan versi terikat dengan cara yang sama. Kosong jika tipe lampiran tidak teresolusi ke entitas Catalog mana pun.
labelsmap of stringtidakLabel 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..labels. Kunci ini sama sekali tidak ada jika Feature tidak mendeklarasikan label dan jika tipe lampiran tidak teresolusi ke entitas Catalog mana pun, jadi lindungi dengan if atau lakukan range atas map sebelum mengakses label individual.
valuesobjecttidakPilar developer-intent milik lampiran itu sendiri, dibawa apa adanya dari deklarasi lampiran.
infraobjecttidakPilar operational-sizing milik lampiran itu sendiri, dibawa apa adanya dari deklarasi lampiran.
providesmap of stringtidakKontrak 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..provides.. Konsumen membaca nilai-nilai ini alih-alih menurunkan ulang identitas fisik lampiran. Lampiran yang FeatureRecipe terikatnya tidak memublikasikan apa pun sama sekali tidak membawa kunci provides, bukan map kosong, sehingga templat perlu melakukan pengecekan sebelum mengakses kunci individual.

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.

PropertiJenisWajibDeskripsi
targetstringyaID absolut yang telah diratakan dari node target (mis., ‘data-layer.main-db’).
socketstringyaKategori usesSchema tempat edge ini berada (mis., ‘databases’, ‘apis’).
sourcestringtidakID absolut yang telah diratakan dari node sumber (konsumen). Diisi untuk tampilan boundary-scope yang mengindeks output per konsumen berdasarkan node konsumen.
source_namespacestringtidakAnotasi 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_pathstringtidakPath 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_pathstringtidakPath 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_namespacestringtidakAnotasi 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_pathstringtidakPath 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_pathstringtidakPath 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.
providesmap of stringyaKamus provides node target yang telah di-resolve sepenuhnya. Dievaluasi pada evaluasi provides, sebelum hidrasi inject.
injectobjectyaPemetaan 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.
labelsmap of stringtidakLabel duck-typing dan ontologi node target (setelah mutasi dari konstruksi topologi).
annotationsobjecttidakTiga bucket anotasi bertingkat milik node target.
componentstringtidakURI jenis komponen Catalog dari node target (mis., ‘core/postgres’).
resolved_versionstringtidakSemVer node target yang telah di-resolve.
boundary_pathstringtidakHierarki spasial fisik node target dari Release (mis., ‘aws-eks-cluster/backend-ns’).
origin_featurestringtidakJika 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_releasebooleantidakTrue bila Release yang menyambungkan koneksi ini, bukan Aggregate yang mendeklarasikannya. Tidak ada untuk koneksi yang dideklarasikan oleh Aggregate.
valuesobjecttidakKonfigurasi 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.
infraobjecttidakKonfigurasi 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.
featuresmap of template_attachmenttidakAttachment 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..features..provides., sehingga konsumen yang menjangkau beberapa target membaca kredensial milik masing-masing target. Attachment ini tidak pernah menjadi bagian dari .features milik node konsumen itu sendiri, sehingga templat yang melakukan range atas .features untuk menemukan attachment node berdasarkan type tidak menjumpai attachment milik koneksi. Saat di-range dalam templat, slot muncul dalam urutan kunci. Tidak ada jika koneksi tidak membawa attachment apa pun.
render_factsrender_factstidakApa 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.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target.
filemap of stringtidakPengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target.
argmap of stringtidakPengiriman 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.

PropertiJenisWajibDeskripsi
releasemap of stringtidakString topologi fisik dari boundary Release milik node target.
catalogmap of stringtidakSifat tetap dari entitas Catalog milik node target.
aggregatemap of stringtidakMetadata kognitif dari subsistem Aggregate milik node target.

Properti tambahan tidak diizinkan.