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

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

PlikRola
aggregate.yamlIntencja programisty: importuje moduł dokumentowej bazy danych (core/ferretdb).
manifest-helm-synth.yamlMapuje typy proxy i backendu na odpowiadające im encje Recipes synth helm.
release-helm-synth.yamlRekord 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 provides encji 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:

Terminal window
aggrega scaffold --example ferretdb-stack

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

Terminal window
cd ferretdb-stack

Kompilacja

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:

Terminal window
aggrega build --release release-helm-synth.yaml --auto-pull

Wyrenderowane 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: 27017
readinessProbe:
exec:
command:
- /ferretdb
- ping

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