Stos FerretDB — dokumentowa baza danych złożona jako moduł
Ten przykład kompiluje mały, rzeczywisty stos — dokumentową bazę danych udostępniającą
protokół sieciowy MongoDB — do syntetyzowanych manifestów Kubernetes z jednej
encji Aggregate napisanej przez programistę.
Dokumentowa baza danych nie jest pojedynczym komponentem. Jest modułem: wielokrotnego użytku podagregatem, który składa dwa komponenty z pojedynczym obciążeniem —
- proxy, które obsługuje protokół sieciowy MongoDB i nie przechowuje lokalnego stanu, oraz
- backend, PostgreSQL 17 z rozszerzeniem DocumentDB, który utrwala dane na wolumenie.
Moduł łączy własną wewnętrzną krawędź od proxy do backendu i eksportuje
proxy jako swój publiczny punkt końcowy mongo. Encja Aggregate najwyższego poziomu importuje
moduł po nazwie i renderuje złożony stos; operator określa rozmiary wewnętrznych
komponentów modułu w encji Release.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: importuje moduł dokumentowej bazy danych (core/ferretdb). |
manifest-helm-synth.yaml | Mapuje typy proxy i backendu na odpowiadające im encje Recipes synth helm. |
release-helm-synth.yaml | Rekord operatora dla celu Kubernetes. Określa rozmiary wewnętrznych komponentów modułu według ich identyfikatorów w zakresie modułu; wszystko, co pozostawiono domyślnym wartościom schematu, renderuje się samodzielnie. |
Co demonstruje
- Kompozycja jako moduł. Funkcjonalność z wieloma obciążeniami — dokumentowa baza danych, która w rzeczywistości jest proxy z backendem pamięci masowej — jest spakowana jako podagregat składający dwa komponenty z pojedynczym obciążeniem, a nie jako jeden monolityczny komponent. Moduł jest importowany po nazwie i ponownie używany wszędzie, gdzie potrzebna jest dokumentowa baza danych.
- Wewnętrzna krawędź w module. Proxy deklaruje użycie backendu;
host, port, użytkownik i baza danych z
providesencji Recipe backendu są przekazywane do proxy i składane w jego połączenie z PostgreSQL. Kompilator przekazuje te ciągi znaków bez ich interpretowania. - Publiczny punkt końcowy. Moduł eksportuje swoje proxy jako
mongo, stabilną publiczną nazwę, z którą łączy się konsument dokumentowej bazy danych — niezależną od nazw wewnętrznych komponentów modułu. - Określanie przez operatora rozmiarów wewnętrznych komponentów. Encja Release odwołuje się do wewnętrznych komponentów modułu po ich identyfikatorach w zakresie modułu (
database.backend,database.proxy), aby ustawić moc obliczeniową, bez powtarzania fizycznych rozmiarów w encji Aggregate programisty. - Współdzielone poświadczenie. Proxy deleguje uwierzytelnianie do swojego backendu PostgreSQL, więc oba współdzielą jedno hasło. Ten przykład używa współdzielonej, wbudowanej wartości domyślnej dla środowiska deweloperskiego, więc stos działa samodzielnie, bez zewnętrznego sekretu.
- Ciąg połączenia bez hasła. URL połączenia proxy z PostgreSQL jest
renderowany bez osadzonego hasła; hasło jest dostarczane osobno w
standardowej zmiennej środowiskowej libpq
PGPASSWORD, którą sterownik scala z połączeniem. Dzięki temu poświadczenie nie trafia do ciągu połączenia w wyrenderowanym manifeście. - Powtarzalne obrazy. Zarówno proxy, jak i backend przypinają jawne tagi obrazów, więc wyrenderowane manifesty odwołują się do stabilnych obrazów.
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 ferretdb-stackNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd ferretdb-stackKompilacja
Ta przestrzeń robocza nie zawiera pliku .aggrega-config.yaml, więc encje biblioteki standardowej są rozwiązywane z rejestru hub, hub.aggrega.ai, i flaga katalogu nie jest potrzebna; --auto-pull zapisuje w trakcie kompilacji plik blokady, którego brakuje w świeżym klonie:
aggrega build --release release-helm-synth.yaml --auto-pullWyrenderowane artefakty trafiają do dist/. Cel Kubernetes renderuje zwykłe
manifesty offline — pobieranie chartu nie jest wymagane.
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 `ferretdb-stack`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `ferretdb-stack` i bez `dir`: zapisuje ono przykład w nowym folderze `ferretdb-stack`. Następnie wywołaj narzędzie `build` z `workspace_root` ustawionym na `ferretdb-stack`, `release` ustawionym na `release-helm-synth.yaml`, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, które pliki zapisała kompilacja; znajdują się w `ferretdb-stack/dist/`.Jak wygląda złożony stos
Proxy renderuje się jako bezstanowy Deployment wraz z usługą ClusterIP Service na porcie protokołu. Środowisko jego kontenera zawiera połączenie złożone z krawędzi backendu — wewnątrzklastrową nazwę usługi Service backendu, użytkownika i bazę danych, bez hasła w URL — i utrzymuje nasłuch debugowania FerretDB na adresie pętli zwrotnej poda, gdzie żaden inny pod do niego nie dociera:
env: - name: FERRETDB_LISTEN_ADDR value: :27017 - name: FERRETDB_DEBUG_ADDR value: 127.0.0.1:8088 - name: FERRETDB_POSTGRESQL_URL value: postgres://postgres@database-zdbackend-default:5432/postgres - name: PGPASSWORD value: apppassŻadna z sond nie potrzebuje tego nasłuchu. Sonda gotowości uruchamia ferretdb ping
wewnątrz kontenera, co pinguje port protokołu, a tym samym potwierdza też połączenie
z backendem; sonda żywotności sprawdza tylko, czy port protokołu przyjmuje
połączenia, więc awaria backendu wyłącza proxy z jego usługi Service bez
jego restartowania:
livenessProbe: tcpSocket: port: 27017readinessProbe: exec: command: - /ferretdb - pingBackend renderuje się jako StatefulSet z trwałym wolumenem zamontowanym w
/var/lib/postgresql/data, wraz z usługą ClusterIP Service i usługą headless Service.