Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

RabbitMQ — một Aggregate, hai đích, xác thực tùy chọn

Ví dụ này biên dịch một message broker RabbitMQ (AMQP) duy nhất từ một Aggregate do Developer soạn ra hai target:

  • Docker Compose cho phát triển cục bộ, và
  • Kubernetes, thông qua helm Recipe được tổng hợp, chạy trực tiếp image rabbitmq chính thức từ upstream (một StatefulSet với một persistent volume, không có chart bên ngoài).

Cùng một aggregate.yaml điều khiển cả hai. Chỉ lớp Recipe được Manifest chọn thay đổi theo từng đích. Một Aggregate thứ hai, aggregate-helm-synth-auth.yaml, cho thấy cùng broker đó trên Kubernetes với một thông tin xác thực mật khẩu có thể tham chiếu được gắn vào.

Các tệp

TệpVai trò
aggregate.yamlÝ định của Developer: một component broker có kiểu core/messaging/rabbitmq, không có thông tin xác thực — Recipe cung cấp một mật khẩu phát triển inline mang tính tất định.
aggregate-auth.yamlCùng broker đó với một thông tin xác thực mật khẩu kiểu inject-value được gắn vào slot password tùy chọn của component (được đích Compose sử dụng).
aggregate-helm-synth-auth.yamlCùng broker đó với một thông tin xác thực mật khẩu có thể tham chiếu được gắn vào, được hiện thực thành một Kubernetes Secret và được StatefulSet tham chiếu (được đích Kubernetes sử dụng).
manifest-compose.yamlÁnh xạ kiểu RabbitMQ tới Compose Recipe (compose/rabbitmq) và thông tin xác thực tới dotenv-secret.
manifest-helm-synth.yamlÁnh xạ kiểu RabbitMQ tới helm Recipe được tổng hợp (helm/rabbitmq) và thông tin xác thực tới k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlCác bản ghi của Operator cho hai đích, mật khẩu phát triển inline.
release-compose-auth.yaml / release-helm-synth-auth.yamlCác bản ghi của Operator cung cấp mật khẩu qua slot thông tin xác thực.

Các tham chiếu Recipe trong các Manifests có phạm vi theo provider (compose/rabbitmq, helm/rabbitmq) vì mỗi provider đều có một Recipe cùng tên.

Ví dụ này minh họa điều gì

  • Một bề mặt soạn thảo, nhiều đích. Một Aggregate duy nhất là nguồn chân lý cho việc stack là gì. Mỗi Manifest cho biết cách hiện thực nó.
  • Một broker bền vững. RabbitMQ lưu trữ bền vững các hàng đợi và thông điệp, nên component được gán kiểu stateful-server. Trên Kubernetes, Recipe được tổng hợp render một StatefulSet với một persistent volume cho mỗi replica, được mount tại thư mục dữ liệu của RabbitMQ, và một Headless Service để có định danh mạng ổn định; service Compose mở broker ra cho phát triển cục bộ.
  • Tổng hợp không cần chart (Kubernetes). Đích Kubernetes chạy trực tiếp image rabbitmq chính thức. Trình biên dịch tổng hợp StatefulSet, ClusterIP Service và Headless Service từ cấu hình kích thước infra của component — không có chart bên ngoài nào phải lấy về hay theo dõi. Tag của image được cố định qua infra.engine_version, nên bản render không mang tag trôi nổi nào.
  • Cả hai cổng của broker. Image có bật management, nên broker mở cổng AMQP (5672) và dashboard quản lý (15672) trên container và trên ClusterIP Service.
  • Thông tin xác thực tất định. RabbitMQ luôn xác thực. Khi không có thông tin xác thực nào được gắn vào, mỗi Recipe cung cấp một mật khẩu phát triển inline cố định để bản render giống hệt nhau từng byte qua các lần chạy. Khi có thông tin xác thực được gắn vào, giá trị được inject sẽ đặt mật khẩu cho broker: trên Compose nó trở thành biến môi trường service RABBITMQ_DEFAULT_PASS; trên Kubernetes nó được hiện thực thành một Secret và được tham chiếu bởi một env secretKeyRef, nên bản rõ không bao giờ xuất hiện trong manifest được render.

Tạo ví dụ

Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example rabbitmq-broker

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd rabbitmq-broker

Build

Workspace này không có .aggrega-config.yaml, nên các thực thể thư viện chuẩn được phân giải từ registry hub, hub.aggrega.ai, và không cần cờ catalog; --auto-pull ghi trong lúc build lockfile mà một bản clone mới còn thiếu:

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

Các artifact được render nằm trong dist/.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục Workspace chưa có thư mục `rabbitmq-broker`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `rabbitmq-broker` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `rabbitmq-broker` mới. Sau đó gọi công cụ `build` một lần cho mỗi Release, theo thứ tự này — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` và `release-helm-synth-auth.yaml` — mỗi lần với `workspace_root` đặt thành `rabbitmq-broker`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết mỗi bản dựng đã ghi những tệp nào; chúng nằm trong `rabbitmq-broker/dist/`.

Ghi chú về việc cung cấp thông tin xác thực

Trên Compose, thông tin xác thực là một secret kiểu inject-value: giá trị của nó được truyền qua kênh môi trường của component và trở thành biến môi trường service RABBITMQ_DEFAULT_PASS. Trên Kubernetes, thông tin xác thực có thể tham chiếu được: nó được hiện thực thành một Kubernetes Secret, và StatefulSet tham chiếu nó qua một env secretKeyRef, nên mật khẩu dạng bản rõ không bao giờ xuất hiện trong manifest của workload. Giá trị origin trong các Aggregates xác thực là một giá trị giữ chỗ cho phát triển; hãy cung cấp một giá trị thật qua nguồn thông tin xác thực của bạn cho mọi triển khai thật. Mật khẩu phát triển inline được dùng khi không có thông tin xác thực nào được gắn vào cũng chỉ dành cho sử dụng cục bộ.