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

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

PlikRola
aggregate.yamlIntencja programisty: jeden komponent broker typu core/messaging/rabbitmq, bez poświadczenia — encja Recipe dostarcza deterministyczne hasło deweloperskie wpisane bezpośrednio.
aggregate-auth.yamlTen 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.yamlTen 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.yamlMapuje typ RabbitMQ na encję Recipe dla Compose (compose/rabbitmq), a poświadczenie na dotenv-secret.
manifest-helm-synth.yamlMapuje typ RabbitMQ na syntetyzowaną encję Recipe dla helm (helm/rabbitmq), a poświadczenie na k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlRekordy operatora dla obu celów, hasło deweloperskie wpisane bezpośrednio.
release-compose-auth.yaml / release-helm-synth-auth.yamlRekordy 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 wymiarowania infra komponentu — bez zewnętrznego chartu do pozyskania czy śledzenia. Tag obrazu jest przypięty przez infra.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ę env secretKeyRef, 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:

Terminal window
aggrega scaffold --example rabbitmq-broker

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

Terminal window
cd rabbitmq-broker

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), inline development password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official rabbitmq image), inline password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same targets with a password credential attached
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 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.