RabbitMQ — jedna encja Aggregate, dwa cele, opcjonalne uwierzytelnianie
Ten przykład kompiluje pojedynczy broker komunikatów RabbitMQ (AMQP) z jednej encji Aggregate utworzonej przez programistę do dwóch celów:
- Docker Compose do lokalnego programowania oraz
- Kubernetes, za pośrednictwem syntetyzowanej encji Recipe dla helm, która bezpośrednio uruchamia oficjalny
obraz
rabbitmq(StatefulSet z trwałym woluminem, bez zewnętrznego chartu).
Ten sam plik aggregate.yaml steruje oboma. Dla każdego celu zmienia się tylko warstwa Recipe wybrana przez
encję Manifest. Druga encja Aggregate, aggregate-helm-synth-auth.yaml,
pokazuje ten sam broker na Kubernetes z dołączonym poświadczeniem hasła
umożliwiającym odwołania.
Pliki
| Plik | Rola |
|---|---|
aggregate.yaml | Intencja programisty: jeden komponent broker typu core/messaging/rabbitmq, bez poświadczenia — encja Recipe dostarcza deterministyczne hasło deweloperskie wpisane bezpośrednio. |
aggregate-auth.yaml | Ten sam broker z poświadczeniem hasła typu inject-value dołączonym do opcjonalnego slotu password komponentu (używany przez cel Compose). |
aggregate-helm-synth-auth.yaml | Ten sam broker z dołączonym poświadczeniem hasła umożliwiającym odwołania, zmaterializowanym jako Secret Kubernetes, do którego odwołuje się StatefulSet (używany przez cel Kubernetes). |
manifest-compose.yaml | Mapuje typ RabbitMQ na encję Recipe dla Compose (compose/rabbitmq), a poświadczenie na dotenv-secret. |
manifest-helm-synth.yaml | Mapuje typ RabbitMQ na syntetyzowaną encję Recipe dla helm (helm/rabbitmq), a poświadczenie na k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Rekordy operatora dla obu celów, hasło deweloperskie wpisane bezpośrednio. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Rekordy operatora dostarczające hasło przez slot poświadczenia. |
Odwołania do encji Recipe w encjach Manifests są ograniczone do dostawcy (compose/rabbitmq,
helm/rabbitmq), ponieważ encja Recipe o tej samej nazwie istnieje dla każdego dostawcy.
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ć.
- Trwały broker. RabbitMQ utrwala kolejki i komunikaty, więc komponent
ma typ
stateful-server. Na Kubernetes syntetyzowana encja Recipe renderuje StatefulSet z trwałym woluminem dla każdej repliki, zamontowanym w katalogu danych RabbitMQ, oraz Headless Service zapewniający stabilną tożsamość sieciową; usługa Compose udostępnia broker na potrzeby lokalnego programowania. - Synteza bez chartu (Kubernetes). Cel Kubernetes bezpośrednio uruchamia oficjalny
obraz
rabbitmq. Kompilator syntetyzuje StatefulSet, ClusterIP Service i Headless Service na podstawie wymiarowaniainfrakomponentu — bez zewnętrznego chartu do pozyskania czy śledzenia. Tag obrazu jest przypięty przezinfra.engine_version, więc wynik renderowania nie zawiera ruchomego tagu. - Oba porty brokera. Obraz ma włączony moduł zarządzania, więc broker udostępnia port AMQP (5672) i panel zarządzania (15672) w kontenerze oraz w ClusterIP Service.
- Deterministyczne poświadczenia. RabbitMQ zawsze uwierzytelnia. Gdy nie
dołączono poświadczenia, każda encja Recipe dostarcza stałe hasło deweloperskie wpisane bezpośrednio,
dzięki czemu wynik renderowania jest identyczny bajt po bajcie między uruchomieniami. Gdy poświadczenie jest
dołączone, wstrzyknięta wartość ustawia hasło brokera: w Compose staje się
zmienną środowiskową usługi
RABBITMQ_DEFAULT_PASS; na Kubernetes jest materializowana jako Secret, do którego odwołuje się envsecretKeyRef, więc tekst jawny nigdy nie trafia do wyrenderowanego manifestu.
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 rabbitmq-brokerNastępnie wypisuje polecenia do uruchomienia w dalszej kolejności. Pierwsze przechodzi do nowego folderu:
cd rabbitmq-brokerKompilacja
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), inline development passwordaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline passwordaggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attachedaggrega 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 `rabbitmq-broker`, wywołaj raz narzędzie `scaffold` z `example` ustawionym na `rabbitmq-broker` i bez `dir`: zapisuje ono przykład w nowym folderze `rabbitmq-broker`. 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 `rabbitmq-broker`, `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 `rabbitmq-broker/dist/`.Uwaga o dostarczaniu poświadczeń
W Compose poświadczenie jest sekretem typu inject-value: jego wartość jest dostarczana
kanałem środowiskowym komponentu i staje się zmienną środowiskową usługi RABBITMQ_DEFAULT_PASS.
Na Kubernetes poświadczenie umożliwia odwołania: jest
materializowane jako Secret Kubernetes, a StatefulSet odwołuje się do niego przez
env secretKeyRef, więc hasło w postaci jawnej nigdy nie pojawia się w manifeście
obciążenia. Wartość origin w encjach Aggregates z uwierzytelnianiem jest deweloperskim
symbolem zastępczym; w każdym rzeczywistym wdrożeniu należy dostarczyć prawdziwą wartość przez własne źródło poświadczeń.
Hasło deweloperskie wpisane bezpośrednio, używane, gdy nie dołączono poświadczenia,
również służy wyłącznie do użytku lokalnego.