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

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/valkey bezpoś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

PlikRola
aggregate.yamlIntencja programisty: jeden komponent cache typu core/datastore/valkey, bez poświadczenia — pamięć podręczna działa bez uwierzytelniania.
aggregate-auth.yamlTa sama pamięć podręczna z poświadczeniem hasła dołączonym do opcjonalnego slotu password komponentu (ścieżka Compose).
aggregate-helm-synth-auth.yamlTa 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.yamlMapuje typ Valkey na Recipe Compose (compose/valkey), a poświadczenie na dotenv-secret.
manifest-helm-synth.yamlMapuje typ Valkey na syntetyzowany Recipe helm (helm/valkey), a poświadczenie na k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlRekordy operatora dla obu realizacji, bez uwierzytelniania.
release-compose-auth.yaml / release-helm-synth-auth.yamlRekordy 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 nie stateful-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 jako compose/valkey i helm/valkey.
  • Opcjonalne uwierzytelnianie przez slot poświadczenia. Komponent deklaruje jeden opcjonalny slot password w swoim featuresSchema. 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_FLAGS obrazu; 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:

Terminal window
aggrega scaffold --example valkey-cache

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

Terminal window
cd valkey-cache

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
# Local development (Docker Compose), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

Wyrenderowane 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ń.