Memcached — jedna encja Aggregate, dwa cele i odrzucone hasło
Ten zwięzły przykład kompiluje pojedynczą pamięć podręczną Memcached działającą w pamięci operacyjnej z jednej encji Aggregate utworzonej przez programistę do dwóch realizacji:
- Docker Compose do lokalnego programowania oraz
- syntetyzowana encja helm Recipe uruchamiająca oficjalny obraz
memcachedbezpośrednio w Kubernetes (bez zewnętrznego chartu).
Syntetyzowana encja helm Recipe to preferowana ścieżka dla Kubernetes: zależy wyłącznie od tagu oficjalnego obrazu zamiast od chartu zewnętrznego dostawcy, a wyrenderowany zestaw zasobów jest dokładnie tym, co deklaruje workload.
Ten sam aggregate.yaml steruje oboma. Dla każdej realizacji zmienia się tylko warstwa Recipe wybrana przez encję Manifest. Dwie kolejne encje Aggregate dołączają hasło do pamięci podręcznej, a ich encje Releases to przykłady negatywne: kompilacja zostaje zatrzymana, ponieważ żadna realizacja nie potrafi wymusić hasła Memcached.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: jeden komponent cache typu core/datastore/memcached, bez poświadczenia — pamięć podręczna działa bez uwierzytelniania. |
aggregate-auth.yaml | Ta sama pamięć podręczna z poświadczeniem hasła typu inject-value dołączonym do opcjonalnego slotu password komponentu (ścieżka Compose). Jej kompilacja zostaje zatrzymana. |
aggregate-helm-synth-auth.yaml | Ta sama pamięć podręczna z referencyjnym poświadczeniem hasła dołączonym dla ścieżki syntetyzowanego helm. Jej kompilacja zostaje zatrzymana. |
manifest-compose.yaml | Mapuje typ Memcached na encję Recipe dla Compose (compose/memcached), a poświadczenie na dotenv-secret. |
manifest-helm-synth.yaml | Mapuje typ Memcached na syntetyzowaną encję helm Recipe (helm/memcached), a poświadczenie na k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Rekordy operatora dla dwóch realizacji. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Rekordy operatora nad dwiema encjami Aggregate z hasłem. Oczekuje się, że każda kompilacja zakończy się niepowodzeniem. |
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ć.
- Bezstanowy magazyn danych. Memcached przechowuje wpisy w pamięci i niczego
nie zapisuje trwale, dlatego komponent ma typ zwykłego
server, a niestateful-server. W Kubernetes 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 Service typu ClusterIP uruchamiające oficjalny obraz
memcached— którą dostawca helm tłumaczy na manifesty Kubernetes bez zewnętrznego chartu. Wyrenderowany zestaw zasobów jest dokładnie tym, co deklaruje encja Workload. Ponieważ zarówno encja Recipe dla Compose, jak i syntetyzowana encja helm Recipe noszą nazwęmemcached, encje Manifests odwołują się do nich z zakresem dostawcy jakocompose/memcachedihelm/memcached. - Ochrona, której realizacja nie może zapewnić, jest odrzucana, a nie pomijana. Komponent deklaruje opcjonalny slot
password. Obrazmemcachednie wymusza żadnego hasła: jego dwa tryby uwierzytelniania to SASL, używany wyłącznie w protokole binarnym, oraz plik uwierzytelniania ASCII, a klienci Memcached z katalogu nie używają żadnego z nich. Encja Recipe, która przyjęłaby załącznik, wyrenderowałaby pamięć podręczną odpowiadającą każdemu klientowi, podczas gdy encja Aggregate twierdzi, że jest ona chroniona, więc każda encja Recipe zamiast tego zatrzymuje kompilację, wskazując slot.
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 memcached-cacheNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd memcached-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)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)aggrega build --release release-helm-synth.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 `memcached-cache`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `memcached-cache` i bez `dir`: zapisuje ono przykład w nowym folderze `memcached-cache`. Następnie wywołaj narzędzie `build` raz dla każdego pliku Release, w tej kolejności — `release-compose.yaml` i `release-helm-synth.yaml` — za każdym razem z `workspace_root` ustawionym na `memcached-cache`, `release` ustawionym na ten plik, `auto_pull` ustawionym na true i `write` ustawionym na true. Podaj, które pliki zapisała każda kompilacja; znajdują się w `memcached-cache/dist/`.Próba kontrolna: hasło, którego pamięć podręczna nie może wymusić
Dwie negatywne encje Release budują encje Aggregate z hasłem i oczekuje się, że każda kompilacja zakończy się niepowodzeniem:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullKażda zatrzymuje się w encji Recipe Memcached, zanim cokolwiek zostanie zapisane, a zatrzymanie kończy się własnym komunikatem encji Recipe:
a password is attached to the password slot of "cache", but the memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkOdmowa opiera się na samym załączniku, a nie na sposobie dostarczenia poświadczenia, więc każda encja Feature, która może wypełnić slot, zatrzymuje się w ten sam sposób. Realizacje zarządzane zachowują się tak samo: Amazon ElastiCache nie oferuje uwierzytelniania Memcached, a jej encje Recipes również zatrzymują się na załączniku. Pamięć podręczną Memcached chroni zatem to, kto może do niej dotrzeć — sieć, w której jest umieszczona — a formą do zbudowania jest bazowy aggregate.yaml.