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

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 przez type:, wymagane poświadczenie jako załącznik wypełniający slot oraz jedna krawędź uses podłączająca bazę danych do gniazda databases Adminera.
  • release.yaml — realizacja operatora dla danego środowiska: jak duże i gdzie. Bloki infra: (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/mariadb i type: core/devtool/adminer to 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 blokiem values:, 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 wstrzykuje provides.host encji Recipe bazy danych do ADMINER_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. featuresSchema encji Component bazy danych wymaga slotu root_password, wypełnionego katalogową encją Feature core/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.0 na compose/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:

Terminal window
aggrega scaffold --example catalog-only

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

Terminal window
cd catalog-only

Kompilacja

Z tego katalogu, z encjami katalogu rozwiązywanymi z hub.aggrega.ai, domyślnego rejestru wskazanego w .aggrega-config.yaml:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Pull 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 web zawiera ADMINER_DEFAULT_SERVER: db — provides.host encji 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_SERVER i MARIADB_COLLATION_SERVER usługi db pochodzą z wartości domyślnych schematu, o których encja Aggregate nigdy nie wspomina;
  • image: mariadb:11.4 i powiązanie portów 8080:8080 pochodzą z bloków infra: encji Release — filaru operatora, wygenerowanego obok filaru dewelopera.

Uruchomienie

Terminal window
cd dist/compose
docker compose up -d

Należ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.