Tylko katalog — MariaDB + Adminer bez żadnego tworzenia warstwy platformy
Ten przykład wdraża mały, rzeczywisty stos — bazę danych MariaDB z interfejsem webowym Adminer przed nią — odwołując się wyłącznie do encji katalogu biblioteki standardowej. Nie tworzy się tu żadnej encji Component, Feature ani Recipe: trzy krótkie pliki YAML kierują wszystko do encji, które katalog już dostarcza.
Jest to najmniejsza powierzchnia tworzenia, jaką oferuje Aggrega, i naturalny pierwszy kontakt z językiem. Przykład siostrzany z poziomu tworzenia wdraża ten sam stos, budując własną warstwę katalogu — najpierw warto przeczytać ten przykład, aby zobaczyć, co daje gotowy katalog, a następnie tamten, aby dowiedzieć się, jak powstaje warstwa pod spodem.
Trzy pliki
aggregate.yaml— intencja dewelopera: czym jest stos. Dwa komponenty wybrane z katalogu przeztype:, wymagane poświadczenie jako załącznik wypełniający slot oraz jedna krawędźusespodłączająca bazę danych do gniazdadatabasesAdminera.release.yaml— realizacja operatora dla danego środowiska: jak duże i gdzie. Blokiinfra:(wersja silnika, rozmiar pamięci masowej, opublikowany port) należą do operatora; encja Aggregate nigdy ich nie zawiera.manifest.yaml— routing operatora: która encja Recipe realizuje każdy typ w tym celu. Poniżej wyjaśniono, dlaczego odwołania są kwalifikowane dostawcą.
Co demonstruje
- Components jako odwołania do katalogu.
type: core/datastore/mariadbitype: core/devtool/adminerto cała deklaracja obliczeniowa. Deweloper podaje tylko wartości udostępniane przez schematy encji Component — każde pominięte pole przyjmuje wartość domyślną ze schematu (warto porównać zmienne środowiskowe zestawu znaków i sortowania w wygenerowanym wyjściu z jednowierszowym blokiemvalues:, który je wytworzył). - String Pipe. Katalogowa encja Component Adminera deklaruje gniazdo uses
databases, przyjmujące dowolny komponent oznaczony etykietącomponent.aggrega.ai/type=stateful-server. Krawędź encji Aggregate wstrzykujeprovides.hostencji Recipe bazy danych doADMINER_DEFAULT_SERVER. Kompilator przekazuje ciąg znaków bez jego interpretowania — w tym celu jest to nazwa usługi compose; ta sama krawędź w celu Kubernetes przenosiłaby nazwę DNS obiektu Service. - Filar załączników.
featuresSchemaencji Component bazy danych wymaga sloturoot_password, wypełnionego katalogową encją Featurecore/secret-value. Slot jest czarną skrzynką: encja FeatureRecipe wybrana przez Manifest kontroluje dostarczenie, a deweloper nie może go narzucić. - Routing encji Recipe kwalifikowany przez Provider. Encja Manifest mapuje
core/datastore/mariadb:1.0.0nacompose/mariadb:1.0.0— z kwalifikacją dostawcą — ponieważ biblioteka standardowa dostarcza encję Recipe mariadb dla więcej niż jednego dostawcy (m.in. compose i helm). To mapowanie Operatora rozstrzyga o celu: goła, niekwalifikowana referencja pasująca do encji Recipe więcej niż jednego dostawcy głośno przerywa kompilację, zamiast po cichu wybrać jedną z nich. Aby zmienić cel stosu, wystarczy przekierować te mapowania; encja Aggregate się nie zmienia.
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 catalog-onlyNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd catalog-onlyKompilacja
Z tego katalogu, z encjami katalogu rozwiązywanymi z hub.aggrega.ai, domyślnego rejestru wskazanego w .aggrega-config.yaml:
aggrega pull --release release.yamlaggrega build --release release.yamlPull rozwiązuje każdą przywołaną encję i przypina ją w release.lock (tożsamość + skrót zawartości; aby wygenerować ponownie nieaktualny plik blokady, należy uruchomić pull jeszcze raz). Mając kopię roboczą katalogu biblioteki standardowej (skąd ją pobrać), można wskazać jej katalog aggrega-catalog za pomocą --catalog w obu poleceniach, aby odczytywać encje stamtąd. Kompilacja odczytuje ten plik blokady — bez niego kompilacja zatrzymuje się i wskazuje dwie drogi naprzód: pull lub --auto-pull — i generuje dist/compose/docker-compose.yaml. Encja Release definiuje swoje komponenty bezpośrednio (bez bloku boundaries:), więc kompilator włącza je do syntetyzowanego zakresu domyślnego i emituje płasko pod dist/ — jedna granica, bez segmentu nazwy granicy w ścieżce.
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 `catalog-only`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `catalog-only` i bez `dir`: zapisze ono przykład w nowym folderze `catalog-only`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `catalog-only`, `release` ustawionym na `release.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Powiedz mi, które pliki zapisało budowanie; znajdują się w `catalog-only/dist/`.Odczyt wyjścia
W wygenerowanym pliku compose połączenia stają się widoczne:
- usługa
webzawieraADMINER_DEFAULT_SERVER: db—provides.hostencji Recipe bazy danych (nazwę usługi compose) dostarczone przez krawędź uses; - ta sama krawędź wytworzyła
depends_on: [db]— topologię, nie tylko ciągi znaków; MARIADB_CHARACTER_SET_SERVERiMARIADB_COLLATION_SERVERusługidbpochodzą z wartości domyślnych schematu, o których encja Aggregate nigdy nie wspomina;image: mariadb:11.4i powiązanie portów8080:8080pochodzą z blokówinfra:encji Release — filaru operatora, wygenerowanego obok filaru dewelopera.
Uruchomienie
cd dist/composedocker compose up -dNależy otworzyć http://localhost:8080: pole serwera jest wstępnie wypełnione wartością db.
Należy zalogować się jako root hasłem deweloperskim z załącznika encji Aggregate
(dev-root-pw-change-me — symbol zastępczy do zastąpienia we
wszystkim poza lokalnym środowiskiem deweloperskim), baza danych appdb.
Co dalej
Poziom tworzenia pokazuje samodzielne zbudowanie tej samej warstwy platformy — encji Components, Recipes i FeatureRecipes poświadczeń, które ten przykład wykorzystał w gotowej postaci — i kompiluje jedną encję Aggregate do czterech celów.