Schemat kontekstu szablonów Aggrega
Dokumentacja wygenerowana automatycznie. Nie należy jej edytować ręcznie — należy ją wygenerować ponownie z opublikowanego JSON Schema.
Identyfikator schematu: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
Widok, który kompilator składa i przekazuje do szablonów encji Recipe i FeatureRecipe podczas renderowania. Podczas renderowania dołączanej encji FeatureRecipe kompilator dodatkowo wypełnia .attachment_name i .inject kontekstem o zasięgu dołączenia, .context.render_facts tym, co dostawca hosta zgłosił o renderowaniu hosta, a w szablonach generujących własne zasoby dołączenia także .context.used_by komponentami, które korzystają z jego hosta. W przypadku encji FeatureRecipe o zasięgu granicy (spec.executionScope: boundary) szablony, które uruchamia ona raz dla granicy — wśród nich jej locals, provides, source, valuesMapping, artifacts i kroki pipeline — zastają filary .context, .workload, .attachment_name, .inject i .inject_raw nieobecne, a zamiast nich wypełniony filar .boundary.* — zob. blok boundary na końcu właściwości; jej injectMapping jest uruchamiany raz dla każdego komponentu, do którego sięga dołączenie, w kontekście tego komponentu, więc odczytuje .context.* i .attachment_name, a .boundary nie jest tam ustawiony. Ten widok NIE jest zapisywany na dysku; istnieje wyłącznie w pamięci kompilatora podczas renderowania. Ten schemat dokumentuje kontrakt między kompilatorem a autorami szablonów Ops.
Dostępność na etapach renderowania bazowego, w kolejności wykonywania etapów:
- Provides evaluation (preambuła locals, następnie provides): tylko filary lokalne dla węzła. Wpis locals odczytuje wpisy znajdujące się nad nim we własnym bloku; szablon provides odczytuje całe rozwiązane .locals węzła. Odwołanie do samego siebie jest zabronione (żaden wpis provides nie odczytuje innego).
- Source resolution (publikacja locals + ewaluacja source): wszystkie filary; brak .source i .workload. Te locals są w tym miejscu publikowane w .locals, a następnie source: jest ewaluowane względem nich.
- Values mapping (valuesMapping): wszystkie filary + .source; brak .workload.
- Workload synthesis (ewaluacja workload): wszystkie filary + .source; .workload jest właśnie ewaluowane (niedostępne dla odwołania do samego siebie).
- Artifact evaluation (artifacts): wszystkie filary + .source + .workload (najpełniejszy kontekst).
Typ najwyższego poziomu: object
Właściwości
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
context | object | tak | Kontekst wykonania złożony przez kompilator, dostarczający dane o tożsamości, topologii i dostarczaniu. |
values | object | tak | Nieprzezroczysty ładunek kognitywny dla tego węzła, już zwalidowany przez walidator schematu podczas rozwiązywania. Przekazywany bez zmian. |
infra | object | tak | Ładunek fizycznego wymiarowania wstrzykiwany z encji Release dla tego węzła. Całkowicie omija Developera. |
locals | mapa string | tak | Prywatny stan encji Recipe (np. primary_compute, volumes_path). Obliczany w preambule locals — przed provides danego węzła — i publikowany w tym filarze podczas rozwiązywania source. Każdy wpis jest szablonem Go obliczanym względem samodzielnego, lokalnego dla węzła kontekstu zawierającego dotychczas rozwiązane wpisy tego samego bloku, więc wpis MOŻE odczytać wpis siostrzany zdefiniowany POWYŻEJ niego i otrzymuje jego rozwiązaną wartość. Kolejność autora jest częścią kontraktu wszędzie tam, gdzie jeden wpis odczytuje inny: przeniesienie definicji poniżej wpisu, który ją odczytuje, psuje kompilację. Odwołanie ‘.locals. |
provides | mapa string | nie | Publiczny kontrakt API encji Recipe. Wypełniany na podstawie obliczenia provides. Dostępny w valuesMapping renderowania bazowego do odwołań do samego siebie (np. {{ .provides.host }}). NIEDOSTĘPNY w samym szablonie provides (niezmiennik samodzielności provides). Wywołujący rozwiązują klucze inject względem tych wartości. |
features | mapa template_attachment | nie | Każde dołączenie tego węzła, z kluczem w postaci nazwy instancji nadanej przez autora. Jeden filar przenosi je wszystkie, niezależnie od tego, co wytwarzają — operacyjną encję Feature, encję Feature poświadczeń, encję Feature tożsamości — ponieważ dołączenia różnią się tym, co wytwarzają, a nie tym, jak szablon je odczytuje. Encja Recipe odczytuje je, aby dostosować renderowanie do dołączonych możliwości i korzystać z tego, co publikuje dołączenie. Dołączenie zapisane na jednym z połączeń węzła nie należy do nich: odczytuje się je w ramach tego połączenia, pod .context.uses. |
metadata | object | nie | Metadane encji Release i kompilacji, zapewniające globalną tożsamość na potrzeby deterministycznego nazewnictwa. Dostępne we wszystkich blokach szablonów (valuesMapping, injectMapping, pipeline with). |
attachment_name | string | nie | Wypełniane tylko podczas renderowania dołączenia FeatureRecipe. Zawiera nazwę instancji dołączenia — slot, który wypełnia w featuresSchema encji nadrzędnej, albo dowolną nazwę nadaną przez autora (np. ‘admin_password’, ‘db_credentials’). Służy do tworzenia deterministycznych nazw zasobów, różnych dla każdego dołączenia, złożonych po nazwie komponentu hosta: ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}’, gdy provider hosta zgłasza nazwę renderowaną, jak robi to helm — nazwę hosta zapisaną znakami dozwolonymi w nazwie Kubernetes, z podkreśleniami nazwy dołączenia zamienionymi na łączniki — oraz ’{{ .context.instance_id }}-{{ .attachment_name }}’, gdy provider hosta nie zgłasza żadnej. |
inject | object | nie | Wypełniane tylko podczas renderowania dołączenia FeatureRecipe, które ma napisany przez autora blok inject (np. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Różni się od .context.inject, który jest wstępnie nawodnionym kanałem dostarczania komponentu bazowego z krawędzi uses. Przyjmuje wartość null/jest nieobecne dla dołączeń bez napisanego inject oraz dla bazowych Recipes. |
inject_raw | obiekt lub null | nie | Niezmienna, niezmodyfikowana intencja Developera dla bloku inject. Każdy mechanizm wskazany w bloku — env, file, arg lub niestandardowy, taki jak ssm_param — znajduje się pod własną nazwą i zawiera wpisy dokładnie w zapisanej postaci (in, z from lub value), w zapisanej kolejności, więc .inject_raw.ssm_param odczytuje mechanizm niestandardowy tak samo, jak .inject_raw.env odczytuje mechanizm podstawowy. Przyjmuje wartość null, jeśli Developer całkowicie pominął blok inject. Używana przez Ops do kontroli logicznych (np. {{ if not .inject_raw }}), aby wykryć pominięcie przed modyfikacjami mapowania inject. To, które własne values lub provides komponentu dostarcza każdy wpis, odczytuje się w .context.self_inject, a nie z tekstu wpisów. |
steps | mapa object | nie | Komunikacja między krokami potoku. Dostępna tylko wewnątrz bloków ‘with:’ potoku Wasm. Każdy klucz to identyfikator kroku potoku, zawierający wyjścia eksportowane przez ten krok. |
source | string lub object lub null | nie | Rozwiązana zawartość pola source. W szablonach encji Recipe: wypełniana podczas rozwiązywania source z pola source: encji Recipe po obliczeniu szablonu Go, dostępna od mapowania wartości (valuesMapping, workload, artifacts) i równa null, gdy Recipe nie ma source:. W szablonach encji FeatureRecipe: własne pole source: encji FeatureRecipe po obliczeniu szablonu Go, obliczane przed jej valuesMapping i odczytywane tam oraz w każdym szablonie obliczanym po nim (omits, workload, artifacts, kroki potoku), nigdy pole komponentu hosta; null, gdy FeatureRecipe nie ma source:. Pole injectMapping encji FeatureRecipe jest obliczane przed jej źródłem i odczytuje źródło komponentu hosta. Forma string = ścieżka URI; forma object = ustrukturyzowane źródło (np. deskryptor OCI z rozwiązaną wersją). |
workload | workload-v1beta1.schema.json lub null | nie | Sparsowana specyfikacja encji Workload dla tego węzła. Wypełniana podczas syntezy workload z pola workload: encji Recipe po obliczeniu szablonu Go + walidacji JSON Schema encji Workload (względem workload-v1beta1.schema.json). Dostępna od obliczania artefaktów (artifacts), dzięki czemu artefakty mogą odwoływać się do pól workload bez duplikacji (np. ServiceMonitor odczytujący .workload.services.metrics.ports.prom). Przyjmuje wartość null, gdy Recipe nie ma bloku workload:. Próby dereferencji .workload.* na wartości null w szablonie kończą się czytelnym błędem w czasie obliczania szablonu. |
boundary | object | nie | Kontekst zakresu granicy — wypełniany tylko podczas ewaluacji szablonu, który encja FeatureRecipe, której spec.executionScope ma wartość ‘boundary’, uruchamia raz dla granicy. Encje FeatureRecipes o zakresie Component nie otrzymują tego filaru; zamiast tego ich context.instance_id, context.inject, context.uses oraz filar .workload niosą dane poszczególnych komponentów. Szablony encji FeatureRecipe o zakresie granicy uruchamiane dla granicy otrzymują .boundary.* w miejsce tych filarów dotyczących poszczególnych komponentów; jej injectMapping jest uruchamiany w kontekście każdego komponentu, do którego sięga dołączenie, odczytuje te filary dotyczące poszczególnych komponentów i nie otrzymuje tego filaru. |
Dodatkowe właściwości są niedozwolone.
template-context.context
Kontekst wykonania złożony przez kompilator, dostarczający dane o tożsamości, topologii i dostarczaniu.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
instance_id | string | tak | Bezwzględny, spłaszczony identyfikator bieżącego węzła (np. ‘backend’ lub ‘data-layer-zdmain-db’ dla komponentu main-db instancji modułu data-layer), zapisany w alfabecie, który spełnia każda nazwa komponentu nadana przez autora. Deterministyczny i stabilny między kompilacjami dla tego samego Aggregate. Jest to nazwa zasobów budowanych dla tego węzła, dla których żaden dostawca nie wyprowadza nazwy — zestawu artefaktów umieszczonego z Recipe oraz workloadu syntetyzowanego przez dostawcę, który nazywa go według tożsamości — dlatego adres publikowany dla jednego z nich jest budowany z tej wartości. |
rendered_name | string | nie | Nazwa, którą dostawca powiązany z tym węzłem nadaje zasobom renderowanym dla węzła — dla źródła dostarczonego przez autora jest to nazwa, względem której renderują się same dostarczone szablony, np. nazwa wydania odczytywana przez chart; dla syntetyzowanego workloadu jest to nazwa nadawana zasobom tego workloadu, jeśli dostawca ją wyprowadza, zamiast zapisywać tożsamość węzła, jak robi to dostawca helm z tą samą nazwą wydania. Należy ją odczytywać wszędzie tam, gdzie ten Recipe nazywa zasób zadeklarowany przez dostarczony chart lub moduł albo syntetyzowany przez takiego dostawcę, czy to we wpisie provides, w valuesMapping, w workload, we wpisie artifacts, czy w with lub when kroku pipeline’u, ponieważ dostawca może zapisać tę nazwę w uboższym alfabecie niż ten, w którym zapisana jest nazwa komponentu nadana przez autora, i wtedy obie się różnią. Pusta, gdy powiązany dostawca nie wyprowadza takiej nazwy: zasoby umieszczonego zestawu artefaktów oraz workloadu syntetyzowanego przez dostawcę, który nazywa go według tożsamości, noszą tożsamość węzła, więc dla nich należy odczytywać ’{{ .context.instance_id }}’, a Recipe, który sam zapisał nazwy swoich zasobów, już je zna. Odczyt tego klucza tam, gdzie powiązany dostawca nie zgłasza nazwy, zatrzymuje budowanie i wskazuje, co zapisać zamiast tego. Odmowa obejmuje szablony zapisane przez Recipe inline; valuesMapping, workload lub wpis artifacts dostarczony przez ‘$import’ jest rozwiązywany dopiero wtedy, gdy dotrze do niego renderowanie, więc odwołanie w jednym z nich renderuje się jako pusta wartość zamiast zatrzymać budowanie. W szablonach FeatureRecipe powiązanego z dołączeniem komponentu jest to nazwa komponentu-GOSPODARZA w postaci zgłaszanej przez własnego dostawcę gospodarza — wartość, którą odczytuje własny Recipe gospodarza, tak jak instance_id jest tam tożsamością gospodarza — dzięki czemu dołączenie nazywa zasób według swojego gospodarza i otrzymuje nazwę akceptowaną przez platformę gospodarza. Gdy dostawca gospodarza nie zgłasza nazwy, jest ona pusta, a odczyt jej z szablonu inline dołączenia innego niż jego injectMapping zatrzymuje budowanie; należy tam zamiast tego odczytywać ’{{ .context.instance_id }}’. |
labels | mapa string | nie | Etykiety duck typingu i ontologii bieżącego węzła, łącznie z wszelkimi zmianami wprowadzonymi podczas budowania topologii przez wtyczkę zarządzania dołączoną w roli label-transform. |
annotations | object | nie | Trzy kaskadowe kubełki adnotacji bieżącego węzła, rozdzielone według pochodzenia. |
inject | object | tak | Wstępnie nawodniony i przechwycony kanał dostarczania. Na początku jest to mapa generowana przez kompilator, która rozwiązuje klucze inject dewelopera na wartości provides celu. Modyfikowany w miejscu przez głębokie scalenia injectMapping. W chwili renderowania bazowego Recipe zawiera w pełni rozwiązane fizyczne ciągi znaków. |
uses | mapa enriched_edge | tak | Wzbogacona mapa krawędzi topologicznych. Kluczem jest alias dewelopera (np. ‘my_db’, ‘my_api’). Każdy wpis to złożony przez kompilator widok tożsamości węzła docelowego, rozwiązanych provides, mapowania wstrzykiwania i kaskadowych adnotacji oraz dołączeń zapisanych na tym połączeniu — a w przypadku FeatureRecipe deklarującego readsTargetRenderFacts także tego, co zgłosiły renderowania celu. NIE jest to surowa krawędź IR — to wzbogacona projekcja zbudowana przez kompilator specjalnie na potrzeby szablonów. Szablon iterujący po tej mapie widzi połączenia w kolejności kluczy — posortowane według aliasu — a nie w kolejności zapisu. |
self_inject | object | tak | Które z własnych values i provides komponentu deweloper już opatrzył nazwą dostarczania, odczytywane z bloku inject: zapisanego w samym komponencie — bloku, który .inject_raw przechowuje w zapisanej postaci, a .context.inject w postaci rozwiązanej. Każdy mechanizm wskazany w bloku (env, file, arg lub niestandardowy, taki jak ssm_param) mapuje każdą nazwę zapisaną przez dewelopera na własny klucz, który dostarcza dany wpis, tak jak .context.uses. |
used_by | inbound_edge[] | nie | Komponenty, które używają tego komponentu: jeden wpis na każde połączenie uses, które inny komponent do niego tworzy, w kolejności zapisu łączących się komponentów, a następnie w kolejności własnych wpisów uses każdego z nich. Komponent łączący się dwukrotnie pojawia się dwukrotnie. Odczytywane wyłącznie przez FeatureRecipe dołączony do komponentu i tylko w szablonach tworzących własne zasoby dołączenia — jego valuesMapping, workload i artifacts. Nie występuje we własnych szablonach Recipe komponentu, w injectMapping ani w with i when kroku pipeline’u, ponieważ wynik każdego z nich może trafić do własnego renderowanego wyniku komponentu, który pozostaje taki sam niezależnie od tego, kto się z nim łączy. Każdy wpis jest elementem listy, a nie kluczem, więc szablon iterujący po nim napotyka wywołujących w tej kolejności. |
render_facts | render_facts | nie | To, co dostawca, który wyrenderował ten komponent, zgłosił o emitowanym wyniku — zgłaszane przez niego fakty renderowania — z kluczem w postaci nazwy faktu. To, jakie nazwy zgłasza dostawca i co zawiera każdy wpis, określa własny udokumentowany kontrakt tego dostawcy. Każda wartość jest listą, nawet z jednym wpisem, więc szablon zawsze po niej iteruje; gdy renderowanie komponentu wymagało więcej niż jednego wywołania dostawcy, a jedną nazwę zgłosiło kilka z nich, ich listy są łączone w jedną w kolejności wykonania wywołań. Dostępne w każdym szablonie FeatureRecipe dołączonego do komponentu — jego valuesMapping, workload, artifacts oraz with i when kroków pipeline’u — po wyrenderowaniu komponentu, i puste, gdy jego dostawca niczego nie zgłasza, więc nazwa, której nikt nie zgłosił, odczytuje się jako pusta lista. Nie występuje we własnych szablonach Recipe komponentu ani w injectMapping, które są wykonywane przed wyrenderowaniem komponentu. |
Dodatkowe właściwości są niedozwolone.
template-context.context.annotations
Trzy kaskadowe kubełki adnotacji bieżącego węzła, rozdzielone według pochodzenia.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
release | mapa string | nie | Fizyczne ciągi topologii kaskadowo przekazywane z granic Release. |
catalog | mapa string | nie | Niezmienne cechy wewnętrzne zdefiniowane przez architekta platformy w domenie 2. |
aggregate | mapa string | nie | Metadane kognitywne kaskadowo przekazywane z podsystemów Aggregate. |
Dodatkowe właściwości są niedozwolone.
template-context.context.inject
Wstępnie nawodniony i przechwycony kanał dostarczania. Na początku jest to mapa generowana przez kompilator, która rozwiązuje klucze inject dewelopera na wartości provides celu. Modyfikowany w miejscu przez głębokie scalenia injectMapping. W chwili renderowania bazowego Recipe zawiera w pełni rozwiązane fizyczne ciągi znaków.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
env | mapa string | nie | Dostarczanie przez zmienne środowiskowe. Klucze to lokalne nazwy zmiennych dewelopera, wartości to rozwiązane ciągi docelowe. |
file | mapa string | nie | Dostarczanie przez montowanie plików. Klucze to lokalne ścieżki plików, wartości to rozwiązane ciągi docelowe. |
arg | mapa string | nie | Dostarczanie przez argumenty wiersza poleceń. Klucze to prefiksy flag, wartości to rozwiązane ciągi docelowe. |
all | mapa string | nie | Wstępnie obliczone płaskie scalenie mechanizmów env + file + arg + niestandardowych. Wypełniane po rozwiązaniu uses-inject i przeliczane ponownie po mapowaniu inject. Szablony używają {{ toJson .context.inject.all }} do uniwersalnej serializacji. |
template-context.context.self_inject
Które z własnych values i provides komponentu deweloper już opatrzył nazwą dostarczania, odczytywane z bloku inject: zapisanego w samym komponencie — bloku, który .inject_raw przechowuje w zapisanej postaci, a .context.inject w postaci rozwiązanej. Każdy mechanizm wskazany w bloku (env, file, arg lub niestandardowy, taki jak ssm_param) mapuje każdą nazwę zapisaną przez dewelopera na własny klucz, który dostarcza dany wpis, tak jak .context.uses.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
env | mapa string | nie | Dostarczanie przez zmienne środowiskowe: klucze to nazwy zmiennych dewelopera, wartości to własny klucz, który dostarcza każdy wpis. |
file | mapa string | nie | Dostarczanie przez montowanie plików: klucze to ścieżki plików dewelopera, wartości to własny klucz, który dostarcza każdy wpis. |
arg | mapa string | nie | Dostarczanie przez argumenty wiersza poleceń: klucze to prefiksy flag dewelopera, wartości to własny klucz, który dostarcza każdy wpis. |
template-context.metadata
Metadane encji Release i kompilacji, zapewniające globalną tożsamość na potrzeby deterministycznego nazewnictwa. Dostępne we wszystkich blokach szablonów (valuesMapping, injectMapping, pipeline with).
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
release_name | string | nie | Nazwa budowanej encji Release (np. ‘prod-billing’). Używana przez zespół Ops do tworzenia globalnie unikalnych nazw zasobów chmurowych (kubełki S3, role IAM). W połączeniu z .context.instance_id gwarantuje unikalność między środowiskami. |
release_version | string | nie | Wersja semantyczna Release. |
environment | string | nie | Ciąg środowiska z metadanych Release (np. ‘production’, ‘local’). |
aggregate_name | string | nie | Nazwa kompilowanego głównego Aggregate. |
Dodatkowe właściwości są niedozwolone.
template-context.inject
Wypełniane tylko podczas renderowania dołączenia FeatureRecipe, które ma napisany przez autora blok inject (np. { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Różni się od .context.inject, który jest wstępnie nawodnionym kanałem dostarczania komponentu bazowego z krawędzi uses. Przyjmuje wartość null/jest nieobecne dla dołączeń bez napisanego inject oraz dla bazowych Recipes.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
env | mapa string | nie | Dostarczanie zmiennych środowiskowych w zakresie dołączenia. |
file | mapa string | nie | Dostarczanie montowanych plików w zakresie dołączenia. |
arg | mapa string | nie | Dostarczanie argumentów w zakresie dołączenia. |
all | mapa string | nie | Generowane przez kompilator pomocnicze scalenie wszystkich mechanizmów inject dołączenia. |
template-context.boundary
Kontekst zakresu granicy — wypełniany tylko podczas ewaluacji szablonu, który encja FeatureRecipe, której spec.executionScope ma wartość ‘boundary’, uruchamia raz dla granicy. Encje FeatureRecipes o zakresie Component nie otrzymują tego filaru; zamiast tego ich context.instance_id, context.inject, context.uses oraz filar .workload niosą dane poszczególnych komponentów. Szablony encji FeatureRecipe o zakresie granicy uruchamiane dla granicy otrzymują .boundary.* w miejsce tych filarów dotyczących poszczególnych komponentów; jej injectMapping jest uruchamiany w kontekście każdego komponentu, do którego sięga dołączenie, odczytuje te filary dotyczące poszczególnych komponentów i nie otrzymuje tego filaru.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
path | string | nie | Ścieżka granicy encji Release, do której dołączona jest encja FeatureRecipe: nazwy granic od najbardziej zewnętrznej do wewnątrz, połączone znakiem ’/’ (np. ‘bridge’, ‘bridge/frontend’). Wskazuje granicę, a nie katalog, do którego zapisywane są jej dane wyjściowe; ten katalog ustawia directory: granicy. |
assembly_path | string | nie | Katalog, względny wobec katalogu wyjściowego kompilacji, w którym składane są własne dane wyjściowe tego dołączenia: ewaluowane directory: i subDirectory: jego granicy, czyli katalog, do którego kompilacja kieruje te dane (np. ‘bridge/compose’). Jest dokładnie równy source_assembly_path lub target_assembly_path punktu końcowego połączenia wtedy i tylko wtedy, gdy ten punkt końcowy renderuje się do tego samego złożonego pliku, więc encja FeatureRecipe porównuje je, aby odróżnić połączenie wewnątrz własnego pliku od połączenia w innym pliku. Dane nieprzezroczyste; rdzeń ich nie interpretuje. |
boundary_name | string | nie | Nazwa granicy (klucz mapy w release.spec.boundaries). |
components | object | nie | Mapa instance_id na wpis dla każdego komponentu w poddrzewie granicy (rekurencyjnie, łącznie z komponentami zagnieżdżonych granic). Każdy wpis zawiera rozwiązany URI typu komponentu, identyfikator instancji oraz udostępniane wartości z ewaluacji provides poszczególnych komponentów. |
internal_uses_edges | object[] | nie | Krawędzie uses, których źródło ORAZ cel znajdują się w poddrzewie tej granicy. |
outgoing_cross_boundary_uses_edges | object[] | nie | Krawędzie uses, których źródło znajduje się w poddrzewie tej granicy, a cel poza nim. |
incoming_cross_boundary_uses_edges | object[] | nie | Krawędzie uses, których cel jest w poddrzewie, a źródło poza nim. Używane przez agregatory w stylu ingress, które muszą wiedzieć, kto się do nich odwołuje. |
cross_boundary_uses_edges | object[] | nie | Pomocnicza suma wychodzących i przychodzących krawędzi przekraczających granicę. |
labels | mapa string | nie | Suma etykiet komponentów w poddrzewie, z zachowaniem kolejności nadanej przez autora. |
annotations | mapa string | nie | Własne adnotacje granicy po rozwiązaniu kaskady. |
feature_attachments | template_attachment[] | nie | Dołączenia przyłączone bezpośrednio do tej granicy (do wzajemnych odwołań między dołączeniami w zakresie granicy), w tym samym kształcie dołączenia, jaki ma .features. |
Dodatkowe właściwości są niedozwolone.
Definicje
inbound_edge
Jedno połączenie, które inny komponent nawiązuje z komponentem, dla którego renderuje dołączona encja FeatureRecipe: kto się łączy, przez które gniazdo, co publikuje łączący się komponent oraz w jakiej przestrzeni nazw i granicy jest umieszczony. Każda wartość jest ciągiem znaków, który kompilator przenosi bez interpretowania.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
component_id | string | tak | Spłaszczony identyfikator instancji łączącego się komponentu (np. ‘frontend’ lub ‘data-layer.etl’) — wartość, którą szablon ścieżki subDirectory odczytuje jako .component_id, zapisana tak, jak .context.uses. |
socket | string | tak | Kategoria usesSchema, przez którą łączący się komponent nawiązuje to połączenie (np. ‘databases’, ‘apis’). |
provides | mapa string | tak | Rozwiązane provides łączącego się komponentu, zawężone do kluczy deklarowanych przez jego encję Component — te same wartości, które konsument tego komponentu odczytuje w .context.uses. |
source_namespace | string | nie | Przestrzeń nazw, w której umieszczony jest łączący się komponent: adnotacja aggrega.ai/namespace, którą otrzymuje jego własne renderowanie — adnotacje jego granic, z adnotacjami jego własnego wpisu w encji Release zastosowanymi na końcu, tak że komponent, którego wpis ustawia lub czyści przestrzeń nazw, ma własne ustawienie zamiast ustawienia swojej granicy. Jest to wartość, którą encja FeatureRecipe o zakresie granicy odczytuje jako source_namespace we wpisie tego samego połączenia na listach krawędzi uses w .boundary. Nieobecna, gdy do łączącego się komponentu nie ma zastosowania żadna przestrzeń nazw; przed wypisaniem należy ją zabezpieczyć za pomocą if lub with. |
source_boundary_path | string | nie | Rozdzielona ukośnikami ścieżka granicy w encji Release, która zawiera łączący się komponent (np. ‘edge’ lub ‘aws-prod/payments’) — wartość, którą encja FeatureRecipe o zakresie granicy odczytuje jako source_boundary_path we wpisie tego samego połączenia na listach krawędzi uses w .boundary. |
render_facts | render_facts | nie | To, co renderowania łączącego się komponentu zgłosiły o wygenerowanym wyniku, z kluczami będącymi nazwami faktów: najpierw fakty zgłoszone przez wywołania jego własnego providera, następnie fakty każdej dołączonej do niego encji Feature, która renderowała razem z nim, w kolejności renderowania; listy, które jedna nazwa otrzymuje od kilku z nich, są łączone w jedną w tej kolejności. Każda wartość jest listą, nawet z jednym wpisem, więc szablon zawsze iteruje po niej. Obecne tylko dla encji FeatureRecipe deklarującej readsCallerRenderFacts — której dołączenia renderują się, gdy każdy komponent już się wyrenderował, więc renderowanie każdego wywołującego jest kompletne — i wtedy w każdym wpisie, puste dla wywołującego, którego providery niczego nie zgłaszają. Nieobecne dla każdej innej encji FeatureRecipe. |
Dodatkowe właściwości są niedozwolone.
render_facts
Fakty renderowania z kluczami będącymi nazwami: to, co providery, które wyrenderowały komponent, zgłosiły o wygenerowanym wyniku. Jakie nazwy zgłasza provider i co zawiera każdy wpis, określa udokumentowany kontrakt tego providera; kompilator nie dowiaduje się o żadnym z nich niczego poza tym, że każda wartość jest listą. Lista zachowuje kolejność swoich wpisów. Wpis będący obiektem jest przenoszony z kluczami w kolejności, w jakiej zapisał je provider, a szablon iterujący po nim napotyka je w kolejności kluczy, tak jak w przypadku każdej mapy z kluczami w tym kontekście.
Obiekt o dowolnej postaci; wartości są typu any[].
template_attachment
Pojedynczy załącznik w postaci, w jakiej odczytuje go szablon: widok dołączonej encji Feature dla danej instancji. Każdy załącznik udostępnia te same pola niezależnie od tego, co produkuje, więc .features.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
type | string | nie | URI Feature w katalogu dla dołączonej encji Feature. |
resolved_version | string | nie | Wersja dołączonej encji Feature po rozwiązaniu encji Manifest — wersja faktycznie powiązana w tej kompilacji, odczytywana jako .features. |
labels | mapa string | nie | Etykiety katalogowe dołączonej encji Feature, przenoszone dosłownie w kolejności, w jakiej deklaruje je encja Feature — nic nie jest filtrowane, przemianowywane ani pozbawiane prefiksu, więc szablon odczytuje dokładnie to, co zapisał autor encji Feature. Pozwala szablonowi rozgałęziać się według tego, czym jest dołączona encja Feature, a nie według jej nazwy czy URI. Odpowiada .context.uses.if lub iterować po mapie. |
values | object | nie | Własny filar intencji dewelopera dołączenia, przenoszony dosłownie z deklaracji dołączenia. |
infra | object | nie | Własny filar wymiarowania operacyjnego dołączenia, przenoszony dosłownie z deklaracji dołączenia. |
provides | mapa string | nie | Rozwiązany publiczny kontrakt encji FeatureRecipe powiązanej z tym załącznikiem — nazwa emitowanego zasobu, jego klucz, tożsamość i wszelkie dodatkowe produkowane klucze — udostępniany konsumentowi jako .features. |
Dodatkowe właściwości są niedozwolone.
enriched_edge
Pojedyncza wzbogacona krawędź topologiczna złożona przez kompilator. Zawiera rozwiązaną tożsamość celu, jego provides oraz kaskadowe adnotacje.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
target | string | tak | Bezwzględny spłaszczony identyfikator węzła docelowego (np. ‘data-layer.main-db’). |
socket | string | tak | Kategoria usesSchema, do której należy ta krawędź (np. ‘databases’, ‘apis’). |
source | string | nie | Bezwzględny spłaszczony identyfikator węzła źródłowego (konsumenta). Wypełniany dla widoków o zakresie granicy, które kluczują wyjścia poszczególnych konsumentów według węzła konsumenta. |
source_namespace | string | nie | Surowa adnotacja aggrega.ai/namespace punktu końcowego źródła (pusta, gdy jej brak). Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. Nieprzezroczyste dane dla rozwiązywania tożsamości sieciowej przez dostawcę; rdzeń ich nie interpretuje. |
source_boundary_path | string | nie | Ścieżka granicy punktu końcowego źródła: rozdzielana ukośnikami ścieżka granicy encji Release, która go zawiera (np. ‘bridge/frontend’). Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. |
source_assembly_path | string | nie | Ścieżka składania punktu końcowego źródła: katalog, względny wobec katalogu wyjściowego kompilacji, w którym składane są jego dane wyjściowe, utworzony z ewaluowanych directory: i subDirectory: jego granicy (np. ‘bridge/compose’). Dwa punkty końcowe z tą samą ścieżką składania renderują się do jednego złożonego pliku, a punkt końcowy, którego ścieżka składania jest równa .boundary.assembly_path, renderuje się do pliku, w którym składane są własne dane wyjściowe odczytującej encji FeatureRecipe. Encja FeatureRecipe o zakresie granicy, która umieszcza punkty końcowe w sieciach, może odczytać ją jako sieć punktu końcowego źródła, gdy nie ma zastosowania żadne aggrega.ai/namespace. Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. Dane nieprzezroczyste; rdzeń ich nie interpretuje. |
target_namespace | string | nie | Surowa adnotacja aggrega.ai/namespace punktu końcowego celu (pusta, gdy jej brak). Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. Nieprzezroczyste dane dla rozwiązywania tożsamości sieciowej przez dostawcę. |
target_boundary_path | string | nie | Ścieżka granicy punktu końcowego celu: rozdzielana ukośnikami ścieżka granicy encji Release, która go zawiera (np. ‘bridge/backend’). Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. |
target_assembly_path | string | nie | Ścieżka składania punktu końcowego celu: katalog, względny wobec katalogu wyjściowego kompilacji, w którym składane są jego dane wyjściowe, utworzony z ewaluowanych directory: i subDirectory: jego granicy (np. ‘bridge/compose’). Punkt końcowy, którego ścieżka składania jest równa .boundary.assembly_path, renderuje się do pliku, w którym składane są własne dane wyjściowe odczytującej encji FeatureRecipe. Encja FeatureRecipe o zakresie granicy, która umieszcza punkty końcowe w sieciach, może odczytać ją jako sieć punktu końcowego celu, gdy nie ma zastosowania żadne aggrega.ai/namespace. Wypełniana tylko dla widoków o zakresie granicy, tak jak source; własny wpis .context.uses komponentu zawiera ją pustą. Dane nieprzezroczyste; rdzeń ich nie interpretuje. |
provides | mapa string | tak | W pełni rozwiązany słownik provides węzła docelowego. Obliczany podczas ewaluacji provides, przed hydratacją inject. |
inject | object | tak | Oryginalne mapowanie inject dewelopera dla tej krawędzi (klucze = nazwy zmiennych lokalnych, wartości = klucze provides celu). Jest to SUROWE mapowanie, a nie rozwiązane wartości. |
labels | mapa string | nie | Etykiety duck typingu i ontologii węzła docelowego (po mutacji podczas budowy topologii). |
annotations | object | nie | Trzy kaskadowe zbiory adnotacji węzła docelowego. |
component | string | nie | URI typu komponentu węzła docelowego w katalogu (np. ‘core/postgres’). |
resolved_version | string | nie | Rozwiązana wersja SemVer węzła docelowego. |
boundary_path | string | nie | Fizyczna hierarchia przestrzenna węzła docelowego z encji Release (np. ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | nie | Jeśli tę krawędź zadeklarowała autonomicznie encja Feature (w tym Features z poświadczeniami oznaczone etykietą feature.aggrega.ai/kind: secret), nazwa instancji Feature. Null lub brak dla krawędzi zadeklarowanych przez dewelopera. |
origin_release | logiczna | nie | True, gdy to połączenie podłączyła encja Release, a nie zadeklarowała go encja Aggregate. Brak dla połączenia, które deklaruje Aggregate. |
values | object | nie | Konfiguracja deweloperska dla połączenia, zapisana we wpisie uses encji Aggregate dla tego połączenia, przenoszona dosłownie. Brak, gdy połączenie jej nie zawiera. Trafia wyłącznie do kontekstu węzła konsumującego, nigdy do kontekstu celu. |
infra | object | nie | Konfiguracja operacyjna dla połączenia, zapisana we wpisie uses encji Release dla tego połączenia, przenoszona dosłownie. Brak, gdy połączenie jej nie zawiera. Trafia wyłącznie do kontekstu węzła konsumującego, nigdy do kontekstu celu. |
features | mapa template_attachment | nie | Załączniki zapisane na tym połączeniu, kluczowane nazwą slotu, którą gniazdo połączenia deklaruje dla każdego z nich, każdy w kształcie załącznika, jaki niesie .features: jego typ, rozwiązana wersja, etykiety, values, infra oraz rozwiązane provides encji FeatureRecipe z nim powiązanej. Encja Recipe odczytuje poświadczenie połączenia jako .context.uses. |
render_facts | render_facts | nie | Co renderowania celu zgłosiły o wyemitowanym wyjściu, kluczowane nazwą faktu, w kształcie, jaki ma wpis wywołującego w .context.used_by: najpierw fakty zgłoszone przez wywołania jego własnego dostawcy, potem fakty każdej dołączonej do niego encji Feature, która renderowała się razem z nim, w kolejności renderowania; listy, które jedna nazwa otrzymuje od kilku z nich, są łączone w jedną w tej kolejności. Każda wartość jest listą, nawet z jednym wpisem, więc szablon zawsze po niej iteruje. Obecne tylko w .context.uses dla encji FeatureRecipe, która deklaruje readsTargetRenderFacts — której załączniki renderują się, gdy wyrenderują się już wszystkie komponenty, więc renderowanie każdego celu jest kompletne — i wtedy w każdym wpisie, puste dla celu, którego dostawcy nic nie zgłaszają. Brak dla każdej innej encji FeatureRecipe, w with i when kroku potoku, we własnych szablonach Recipe komponentu oraz w listach krawędzi, które odczytuje FeatureRecipe o zakresie granicy. |
Dodatkowe właściwości są niedozwolone.
enriched_edge.inject
Oryginalne mapowanie inject dewelopera dla tej krawędzi (klucze = nazwy zmiennych lokalnych, wartości = klucze provides celu). Jest to SUROWE mapowanie, a nie rozwiązane wartości.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
env | mapa string | nie | Dostarczanie przez zmienne środowiskowe: klucze to nazwy lokalnych zmiennych konsumenta, wartości to klucze provides celu. |
file | mapa string | nie | Dostarczanie przez montowanie plików: klucze to lokalne ścieżki plików konsumenta, wartości to klucze provides celu. |
arg | mapa string | nie | Dostarczanie przez argumenty wiersza poleceń: klucze to prefiksy flag konsumenta, wartości to klucze provides celu. |
enriched_edge.annotations
Trzy kaskadowe zbiory adnotacji węzła docelowego.
| Właściwość | Typ | Wymagana | Opis |
|---|---|---|---|
release | mapa string | nie | Ciągi topologii fizycznej z granic encji Release węzła docelowego. |
catalog | mapa string | nie | Niezmienne cechy z encji katalogowej węzła docelowego. |
aggregate | mapa string | nie | Metadane poznawcze z podsystemów encji Aggregate węzła docelowego. |
Dodatkowe właściwości są niedozwolone.