Import z biblioteki Workload — współdzielona treść Workload przez `$import`
Pojedyncza bezstanowa usługa webowa, której Recipe syntetyzuje swój Workload Kubernetes
z współdzielonego wpisu biblioteki zamiast z treści wbudowanej. Jest to trzeci
tryb tworzenia spec.workload w encji Recipe:
- Tryb 1 (wbudowany): Workload w postaci szablonu Go zapisany bezpośrednio w encji Recipe.
- Tryb 2 (import pliku):
$import: ./relative/path.yaml— plik lokalny. - Tryb 3 (import z biblioteki):
$import: <Library>#/workloads/<Entry>— wpisWorkloadLibrarywskazywany przez tożsamość samej nazwy.
Recipe web-service używa tutaj trybu 3:
spec: capability: helm implements: example/compute/web-service workload: $import: BaseWorkloads#/workloads/StatelessServiceOdwołanie należy zapisać jako jeden nieprzerwany token: bez spacji i bez łamania wiersza w żadnym
miejscu, od nazwy biblioteki aż po fragment. Odwołanie zawierające białe znaki jest
odrzucane, a nie przycinane, i budowanie zostaje zatrzymane — zob.
errors/fatal-halts.md „A reference to a library
entry carries whitespace” (Odwołanie do wpisu biblioteki zawiera białe znaki).
BaseWorkloads to WorkloadLibrary opublikowana w katalogu hub
(workloadlibrary/base-workloads). Jej wpis StatelessService to szablon Go
ewaluowany w kontekście renderowania tej encji Recipe, więc .values.image (z encji
Component/Aggregate) oraz .infra.* (repliki, port, zasoby obliczeniowe — z encji Release)
trafiają do niego dokładnie tak, jak trafiałyby do treści wbudowanej. Wydzielenie Workload do
biblioteki nie zmienia niczego w tym, co jest wdrażane: wyrenderowany wynik jest identyczny bajt w bajt
z równoważnym wbudowanym Workload.
Wersję biblioteki dostarcza plik blokady danej encji Release — w odwołaniu nie pojawia się
żaden host rejestru. Przy aggrega pull biblioteka BaseWorkloads zostaje przypięta w
sekcji workload_libraries pliku blokady; przy aggrega build przypięta biblioteka jest
rozwiązywana, a jej wpis renderowany.
Generowanie przykładu
Ten przykład można zbudować za pomocą poniższych poleceń albo zlecić jego zbudowanie asystentowi AI.
Należy zapisać przykład w nowym folderze nazwanym tak jak on:
aggrega scaffold --example workload-library-importNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd workload-library-importKompilacja
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlKatalog jest rozwiązywany z rejestru hub wskazanego w .aggrega-config.yaml (który dostarcza BaseWorkloads i provider helm) oraz z lokalnego katalogu catalog/ tego przykładu (Component i Recipe web-service). Manifests trafiają do dist/app/helm/ — wartość directory: granicy, po której następuje możliwość providera.
Z asystentem AI
Asystent AI skonfigurowany z narzędziami Aggrega może zrobić to samo: wystarczy wkleić mu ten prompt.
Używaj wyłącznie narzędzi Aggrega i nie twórz samodzielnie żadnego folderu. Jeśli folder obszaru roboczego nie zawiera jeszcze folderu `workload-library-import`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `workload-library-import` i bez `dir`: zapisze ono przykład w nowym folderze `workload-library-import`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `workload-library-import`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, jakie pliki zapisała kompilacja; znajdują się w `workload-library-import/dist/`.Weryfikacja identyczności bajt w bajt
Należy zastąpić workload: { $import: … } w encji Recipe blokiem workload: |
zawierającym dosłownie treść StatelessService, zbudować ponownie i porównać oba drzewa dist/.
Są dokładnie zgodne: odwołanie do biblioteki rozwiązuje się do tego samego tekstu
szablonu, ewaluowanego w tym samym kontekście renderowania, więc import jest jedynie wydzieleniem
w warstwie tworzenia, bez wpływu na wyrenderowane bajty.