Valkey — jedna encja Aggregate, dwa cele, opcjonalne uwierzytelnianie
Ten zwięzły przykład kompiluje pojedynczą pamięć podręczną Valkey działającą w pamięci (protokół sieciowy Redis) z jednej encji Aggregate utworzonej przez programistę do dwóch realizacji:
- Docker Compose do lokalnego programowania oraz
- syntetyzowany Recipe helm uruchamiający oficjalny obraz
valkey/valkeybezpośrednio na Kubernetes (bez zewnętrznego chartu).
Syntetyzowany Recipe helm to ścieżka dla Kubernetes: zależy wyłącznie od oficjalnego tagu obrazu zamiast od chartu zewnętrznego dostawcy, a renderowany zestaw zasobów jest dokładnie tym, co deklaruje workload.
Ten sam plik aggregate.yaml steruje obiema. W poszczególnych realizacjach zmienia się tylko warstwa Recipe wybrana przez encję Manifest. Dwie kolejne encje Aggregates pokazują tę samą pamięć podręczną z dołączonym opcjonalnym poświadczeniem hasła: aggregate-auth.yaml dla ścieżki Compose (poświadczenie typu inject-value, z którym uruchamiany jest serwer) oraz aggregate-helm-synth-auth.yaml dla ścieżki syntetyzowanego helm (poświadczenie referencyjne materializowane jako Secret Kubernetes).
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: jeden komponent cache typu core/datastore/valkey, 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 Valkey na Recipe Compose (compose/valkey), a poświadczenie na dotenv-secret. |
manifest-helm-synth.yaml | Mapuje typ Valkey na syntetyzowany Recipe helm (helm/valkey), 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. Valkey jest tu używany jako pamięć podręczna w pamięci i
niczego nie przechowuje trwale, dlatego komponent ma typ zwykłego
server, a niestateful-server. Na Kubernetes syntetyzowany Recipe helm renderuje Deployment, a nie StatefulSet, i nie żąda trwałego wolumenu; w Compose usługa nie deklaruje wolumenu danych. - Synteza obciążenia (Kubernetes). Syntetyzowany Recipe helm deklaruje
Workload — Deployment oraz Service typu ClusterIP uruchamiające oficjalny
obraz
valkey/valkey— który dostawca helm tłumaczy na manifesty Kubernetes bez zewnętrznego chartu. Renderowany zestaw zasobów jest dokładnie tym, co deklaruje Workload. Ponieważ zarówno Recipe Compose, jak i syntetyzowany Recipe helm noszą nazwęvalkey, encje Manifests odwołują się do nich z zakresem dostawcy jakocompose/valkeyihelm/valkey. - Opcjonalne uwierzytelnianie przez slot poświadczenia. Komponent deklaruje jeden opcjonalny slot
passwordw swoimfeaturesSchema. Gdy żadne poświadczenie nie jest dołączone (bazowa encja Aggregate), Recipe renderuje pamięć podręczną z wyłączonym uwierzytelnianiem — bajtowo identycznie jak Recipe bez slotu. Gdy poświadczenie jest dołączone, oba cele uruchamiają Valkey z--requirepass, więc serwer wymaga hasła: w Compose wartość dociera do serwera przez zmiennąVALKEY_EXTRA_FLAGSobrazu; na Kubernetes ścieżka syntetyzowanego helm materializuje ją 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 valkey-cacheNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd valkey-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 obszaru roboczego nie zawiera jeszcze folderu `valkey-cache`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `valkey-cache` i bez `dir`: zapisze ono przykład w nowym folderze `valkey-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 `valkey-cache`, `release` ustawionym na ten plik, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj mi, jakie pliki zapisała każda kompilacja; znajdują się w `valkey-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 VALKEY_PASSWORD, a encja Recipe przekazuje ją serwerowi jako --requirepass przez zmienną VALKEY_EXTRA_FLAGS obrazu, więc pojawia się ona w środowisku usługi, ale nie w jej wierszu poleceń. Skrypt startowy obrazu rozwija tę zmienną bez cudzysłowów, więc hasło zawierające spację zatrzymuje serwer przy starcie, a hasło zawierające *, ? lub [ jest dopasowywane do nazw plików w katalogu danych serwera — dlatego hasło należy zapisać bez jednych i drugich. Dołączenie hasła, którego wartość dociera do encji Recipe w zmiennej, której ta nie odczytuje, zatrzymuje kompilację ze wskazaniem slotu, zamiast wyrenderować niezabezpieczoną pamięć podręczną.
Ścieżka syntetyzowanego helm używa poświadczenia referencyjnego
(aggregate-helm-synth-auth.yaml): wartość jest materializowana jako Secret
Kubernetes, Deployment odwołuje się do niego przez secretKeyRef w zmiennej środowiskowej, a Valkey 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
valkey/valkey, 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ń.