Przegląd słownictwa
Niewielki zestaw słów kluczowych powtarza się w wielu encjach Aggrega. Zamiast objaśniać je od nowa na stronie każdej encji, rozdziały o słownictwie gromadzą wyjaśnienia w jednym miejscu dla każdej rodziny słów kluczowych. Każda encja, która przyjmuje jedno z tych słów kluczowych, robi to z taką samą semantyką, jaką określa ten zestaw rozdziałów.
Słownictwo dzieli się na cztery rodziny: triadę topologii (provides, inject, uses), która łączy węzły jawnymi krawędziami topologicznymi i przenosi kontrakt wstrzykiwania przekazywany przez kompilator; filary danych (values, infra, parameters, locals), które rozdzielają cztery obszary danych — intencję dewelopera, wymiarowanie fizyczne, ustawienia zależne od środowiska i prywatny stan encji Recipe; słowa kluczowe dziedziczenia i interfejsu (extends, implements), które składają encje katalogu i deklarują, którą encję Component implementuje encja Recipe; oraz system modyfikatorów (appliesTo, appliesToAnyOf), który określa, do których węzłów dołącza się encja Feature za pomocą selektorów etykiet. Koncepcyjne omówienie tego, jak filary rozdzielają obszary, znajduje się w ../architecture/06-data-taxonomy-and-composition.md; mechanika rozwiązywania topologii jest opisana w ../architecture/07-dependency-resolution.md.
Dokumentacja według tematów
- Triada topologii:
provides,inject,uses— kontrakt wstrzykiwania i deklaracje jawnych krawędzi topologicznych. Obejmuje zwięzłą i rozbudowaną składnię inject, kształty potoków.context.inject/.context.usesodczytywane przez szablony oraz dwustanowy kontekst, który chroni zespół Ops przed paniką z powodu wskaźnika nil. - Filary danych:
values,infra,parameters,locals— cztery filary danych i ich własność.valuesiparametersnależące do deweloperów,infranależące do zespołu Ops, prywatne dla encji Recipelocalsoraz wzorzec wynoszenia parametrów dla zmienności między środowiskami. - Dziedziczenie i interfejs:
extends,implements— dziedziczenie encji katalogu przezextends(głębokie scalanie koperty YAML wspólne dla Components i Features, filary danych, które rozszerzająca encja Component dziedziczy w całości po encji bazowej, oraz kompozycja JSON Schema 2020-12, której podlega schemat encji Feature) oraz deklaracjaimplementsłącząca encję Recipe z encją Component (formy dokładna, z zakresem wersji i bez wersji), względem której sprawdzane jest mapowanie w encji Manifest —implementsnigdy nie wybiera encji Recipe. - System modyfikatorów:
appliesToi selektory — selektory dołączania encji Feature, natywny silnik dopasowywania etykiet w Go, gramatyka selektorów w formie tekstowej oraz wariantappliesToAnyOfłączący warunki przez OR. - Poza czterema rodzinami: tworzenie w formie kompaktowej, odwołania między dokumentami, etykiety i adnotacje, powierzchnia publikacji, umowy społeczne, powierzchnia walidacji, kompozycja wyjścia, gramatyka URI i rozwiązywanie wersji.