Skema Path-Template Context Aggrega
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
ID skema: https://aggrega.ai/schemas/path-template-context-v1beta1.schema.json
Daftar variabel yang diizinkan yang digunakan oleh template Go yang dievaluasi terhadap Release.spec.boundaries[].directory dan Release.spec.boundaries[].subDirectory (serta override subDirectory per komponen) ketika Aggrega membangun Release. Template path menggunakan missingkey=error (berbeda dari rezim global missingkey=zero untuk template nilai) ditambah validasi pada waktu parse: setiap referensi field dalam template path harus tercantum dalam daftar yang diizinkan ini untuk konteks yang relevan (directory: vs subDirectory:); field yang tidak dikenal menghasilkan error Loud Guardrail pada waktu parse, tidak pernah pada waktu render. Halaman Path-Template Variables dalam referensi bahasa menjelaskan perbedaannya dengan template nilai.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
capability | string | tidak | Tersedia di directory: DAN subDirectory:. Kapabilitas rendering yang dideklarasikan oleh Recipe komponen penyumbang dalam spec.capability, dengan pin versi apa pun dihapus — misalnya ‘helm’, ‘helm-chart’ atau ‘compose’. subDirectory: secara default bernilai {{ .capability }}, yang menempatkan artefak setiap kapabilitas di subfolder masing-masing di bawah direktori boundary. Dalam template directory:, nilai ini di-resolve per komponen, sehingga boundary yang subtree-nya menyumbangkan lebih dari satu kapabilitas dievaluasi menjadi satu direktori per kapabilitas; penelusuran terpisah per boundary yang memublikasikan .parent_boundary.directory berjalan sebelum komponen apa pun diikat dan membiarkan nilai ini kosong. |
boundary_name | string | tidak | Tersedia di directory: DAN subDirectory:. Kunci map dalam release.spec.boundaries. |
parameters | object | tidak | Tersedia di directory: DAN subDirectory:. Map parameter bertipe dari Release. Template path menerima akses .parameters sebagai pengecualian yang disengaja dari siklus hidup single-pass parameters — template nilai TIDAK menerima .parameters; nilai yang berbentuk lingkungan mengalir ke template nilai melalui YAML Aggregate yang sudah diinterpolasi. |
component_id | string | tidak | Tersedia HANYA di subDirectory:. Identitas kontributor yang sedang ditempatkan. Untuk sebuah komponen, ID instans per komponen yang telah diratakan (misalnya, ‘backend’ atau ‘data-layer.main-db’). Untuk Feature yang dilekatkan pada boundary yang FeatureRecipe-nya dijalankan sekali untuk boundary tersebut (executionScope: boundary), identitas komponen tersusun yang dibawa oleh setiap sumber daya yang dipancarkan lampiran itu dalam label aggrega.ai/component-id miliknya (misalnya, ‘bfr—app—shared’ untuk lampiran ‘shared’ pada boundary ‘app’), dipendekkan jika plugin rendering lampiran membatasi nama, sehingga direktori yang dinamainya cocok dengan label tersebut. Tidak bermakna pada tingkat boundary dan ditolak oleh validasi saat parse dalam template directory:. |
parent_boundary | object | tidak | Tersedia di directory: DAN subDirectory:. Nilai boundary induk yang sudah di-resolve. Diisi melalui penelusuran depth-first yang mengevaluasi templat setiap boundary dengan nilai induknya yang sudah di-resolve; anak tidak pernah melihat nilainya sendiri di sini. Boundary tingkat atas tidak memiliki induk, sehingga membaca kunci di bawah parent_boundary di sana menghentikan build, dengan menyebutkan boundary, field templat, dan kunci yang hilang. |
manifest | object | tidak | Tersedia di directory: DAN subDirectory:. Membawa metadata Recipe yang sudah di-resolve sebagaimana dievaluasi per komponen. |
Properti tambahan tidak diizinkan.
path-template-context.parent_boundary
Tersedia di directory: DAN subDirectory:. Nilai boundary induk yang sudah di-resolve. Diisi melalui penelusuran depth-first yang mengevaluasi templat setiap boundary dengan nilai induknya yang sudah di-resolve; anak tidak pernah melihat nilainya sendiri di sini. Boundary tingkat atas tidak memiliki induk, sehingga membaca kunci di bawah parent_boundary di sana menghentikan build, dengan menyebutkan boundary, field templat, dan kunci yang hilang.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
directory | string | tidak | String directory induk yang sudah dievaluasi. |
boundary_name | string | tidak | Nama induk (kunci map dalam release.spec.boundaries). |
parameters | object | tidak | Map parameter milik Release — map yang sama dengan yang dibawa .parameters. |
annotations | map of string | tidak | Anotasi boundary induk setelah kaskade di-resolve. |
Properti tambahan tidak diizinkan.
path-template-context.manifest
Tersedia di directory: DAN subDirectory:. Membawa metadata Recipe yang sudah di-resolve sebagaimana dievaluasi per komponen.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
recipe_name | string | tidak | Nama Recipe yang sudah di-resolve dari pencarian per komponen. |
Properti tambahan tidak diizinkan.