Redis — jedna encja Aggregate, dwa cele, opcjonalne uwierzytelnianie
Ten zwięzły przykład kompiluje pojedynczą pamięć podręczną in-memory Redis (protokół Redis) z jednej encji Aggregate utworzonej przez programistę do dwóch realizacji:
- Docker Compose do lokalnego programowania oraz
- syntetyzowanej encji helm Recipe uruchamiającej oficjalny obraz
redisbezpośrednio w Kubernetes (bez zewnętrznego chartu).
Syntetyzowana encja helm Recipe to ścieżka Kubernetes: zależy wyłącznie od oficjalnego tagu obrazu, a nie od chartu zewnętrznego dostawcy, a wyrenderowany zestaw zasobów jest dokładnie tym, co deklaruje workload.
Ten sam plik aggregate.yaml steruje obiema realizacjami. Między realizacjami zmienia się tylko warstwa Recipe wybrana przez
encję Manifest. Druga encja Aggregate, aggregate-auth.yaml,
pokazuje tę samą pamięć podręczną z dołączonym opcjonalnym poświadczeniem hasła dla
ścieżki Compose; aggregate-helm-synth-auth.yaml dołącza
posświadczenie z możliwością odwołania dla syntetyzowanej ścieżki helm.
Encje Recipes Redis z katalogu, które mapuje ten przykład, compose/redis i helm/redis, deklarują licencję AGPL-3.0. Przykład valkey-cache wdraża Valkey, który posługuje się tym samym protokołem; jego encja Recipe helm/valkey deklaruje BSD-3-Clause.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: jeden komponent cache typu core/datastore/redis, bez poświadczenia — pamięć podręczna działa bez uwierzytelniania. |
aggregate-auth.yaml | Ta sama pamięć podręczna z poświadczeniem hasła dołączonym do opcjonalnego slotu password komponentu (ścieżka Compose). |
aggregate-helm-synth-auth.yaml | Ta sama pamięć podręczna z poświadczeniem referencyjnym dołączonym dla syntetyzowanej ścieżki helm — wartość jest materializowana jako Secret Kubernetes, do którego odwołuje się Deployment. |
manifest-compose.yaml | Mapuje typ Redis na encję Recipe dla Compose (compose/redis), a poświadczenie na dotenv-secret. |
manifest-helm-synth.yaml | Mapuje typ Redis na syntetyzowaną encję helm Recipe (helm/redis), a poświadczenie na k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Rekordy operatora dla obu realizacji, bez uwierzytelniania. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Rekordy operatora włączające uwierzytelnianie. |
Co demonstruje
- Jedna powierzchnia tworzenia, wiele celów. Pojedyncza encja Aggregate jest źródłem prawdy o tym, czym jest stos. Każda encja Manifest mówi, jak go zrealizować.
- Magazyn danych w roli pamięci podręcznej. Redis służy tu jako pamięć podręczna in-memory i
niczego nie przechowuje trwale, dlatego komponent ma typ zwykłego
server, a niestateful-server. W Kubernetes syntetyzowana encja Recipe renderuje Deployment, a nie StatefulSet, i nie żąda trwałego wolumenu; w Compose usługa nie deklaruje wolumenu danych. - Synteza encji Workload (Kubernetes). Syntetyzowana encja helm Recipe deklaruje
encję Workload — Deployment oraz usługę ClusterIP uruchamiające oficjalny
obraz
redis— którą dostawca helm tłumaczy na manifesty Kubernetes bez zewnętrznego chartu. Wyrenderowany zestaw zasobów jest dokładnie tym, co deklaruje Workload. Ponieważ zarówno encja Recipe dla Compose, jak i syntetyzowana encja helm Recipe noszą nazwęredis, encje Manifests odwołują się do nich z zakresem dostawcy jakocompose/redisihelm/redis. - Opcjonalne uwierzytelnianie przez slot poświadczenia. Komponent deklaruje jeden opcjonalny slot
passwordw swoimfeaturesSchema. Gdy żadne poświadczenie nie jest dołączone (bazowa encja Aggregate), encja Recipe renderuje pamięć podręczną z wyłączonym uwierzytelnianiem — bajtowo identycznie jak encja Recipe bez slotu. Gdy poświadczenie jest dołączone, oba cele uruchamiają Redis z--requirepass, więc serwer wymaga hasła: w Compose (aggregate-auth.yaml) wartość jest przekazywana do serwera jako ten argument; na syntetyzowanej ścieżce Kubernetes (aggregate-helm-synth-auth.yaml) jest materializowana jako Secret, do którego odwołuje się Deployment.
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 redis-cacheNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd redis-cacheKompilacja
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:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullWyrenderowane artefakty trafiają do dist/.
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 Workspace nie zawiera jeszcze folderu `redis-cache`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `redis-cache` i bez `dir`: zapisuje ono przykład w nowym folderze `redis-cache`. Następnie wywołaj narzędzie `build` raz dla każdej encji Release, w tej kolejności — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` i `release-helm-synth-auth.yaml` — za każdym razem z `workspace_root` ustawionym na `redis-cache`, `release` ustawionym na ten plik, `auto_pull` ustawionym na true i `write` ustawionym na true. Powiedz mi, jakie pliki zapisała każda kompilacja; znajdują się w `redis-cache/dist/`.Uwaga o dostarczaniu poświadczeń
Na ścieżce Compose poświadczenie jest sekretem typu inject-value (aggregate-auth.yaml): jego wartość jest dostarczana kanałem środowiska komponentu w zmiennej wskazanej przez jego values.key, czyli REDIS_PASSWORD, a encja Recipe przekazuje ją serwerowi jako --requirepass. Oficjalny obraz redis nie odczytuje żadnej zmiennej z hasłem, więc wartość jest przekazywana jako argument i widać ją w poleceniu usługi. Dołączenie, którego wartość dociera do encji Recipe w zmiennej, której ta nie odczytuje, zatrzymuje kompilację ze wskazaniem slotu, zamiast pozostawić pamięć podręczną otwartą.
Syntetyzowana ścieżka helm używa poświadczenia z możliwością odwołania
(aggregate-helm-synth-auth.yaml): wartość jest materializowana jako Secret
Kubernetes, Deployment odwołuje się do niego przez env secretKeyRef, a Redis jest
uruchamiany z --requirepass odczytującym tę zmienną środowiskową. Hasło w postaci jawnej
nigdy więc nie pojawia się w manifeście Deployment — tylko w
Secret. To właśnie faktycznie włącza uwierzytelnianie w oficjalnym obrazie redis,
który sam z siebie nie odczytuje hasła ze środowiska.
Wartość origin w uwierzytelnionych Aggregates jest symbolem zastępczym do celów deweloperskich;
w każdym rzeczywistym wdrożeniu należy dostarczyć prawdziwą wartość ze źródła poświadczeń.