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

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 memcached bezpoś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

PlikRola
aggregate.yamlIntencja programisty: jeden komponent cache typu core/datastore/memcached, bez poświadczenia — pamięć podręczna działa bez uwierzytelniania.
aggregate-auth.yamlTa 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.yamlTa sama pamięć podręczna z referencyjnym poświadczeniem hasła dołączonym dla ścieżki syntetyzowanego helm. Jej kompilacja zostaje zatrzymana.
manifest-compose.yamlMapuje typ Memcached na encję Recipe dla Compose (compose/memcached), a poświadczenie na dotenv-secret.
manifest-helm-synth.yamlMapuje typ Memcached na syntetyzowaną encję helm Recipe (helm/memcached), a poświadczenie na k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlRekordy operatora dla dwóch realizacji.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlRekordy 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 nie stateful-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 jako compose/memcached i helm/memcached.
  • Ochrona, której realizacja nie może zapewnić, jest odrzucana, a nie pomijana. Komponent deklaruje opcjonalny slot password. Obraz memcached nie 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:

Terminal window
aggrega scaffold --example memcached-cache

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

Terminal window
cd memcached-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)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)
aggrega build --release release-helm-synth.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 `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:

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

Każ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 memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

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