Przejdź do głównej zawartości
AggregaAggrega
Wybierz język: Polski
Ta strona została przetłumaczona maszynowo. Przeczytaj oryginał w języku angielskim.

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> — wpis WorkloadLibrary wskazywany 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/StatelessService

Odwoł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:

Terminal window
aggrega scaffold --example workload-library-import

Następnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:

Terminal window
cd workload-library-import

Kompilacja

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

Katalog 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.