NATS — một Aggregate, hai đích, xác thực tùy chọn
Ví dụ này biên dịch một máy chủ nhắn tin NATS duy nhất (pub-sub, request-reply, hàng đợi) từ một Aggregate do Developer soạn thành hai cách hiện thực:
- Docker Compose cho phát triển cục bộ, và
- helm Recipe được tổng hợp chạy image
natschính thức của upstream trực tiếp trên Kubernetes (không có chart bên ngoài).
Recipe helm được tổng hợp là con đường Kubernetes được ưu tiên: nó chỉ phụ thuộc vào một tag image chính thức thay vì một chart của bên thứ ba, và tập tài nguyên được render của nó đúng bằng những gì workload khai báo.
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 cách hiện thực. Một Aggregate thứ hai, aggregate-auth.yaml,
cho thấy cùng máy chủ đó với một thông tin xác thực mật khẩu kiểu inject-value được gắn vào cho
con đường Compose; aggregate-helm-synth-auth.yaml gắn một thông tin xác thực có thể tham chiếu
được cho con đường helm được tổng hợp.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component bus có kiểu core/messaging/nats, không có thông tin xác thực — máy chủ chạy không có xác thực. |
aggregate-auth.yaml | Cùng máy chủ đó 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 (con đường Compose). |
aggregate-helm-synth-auth.yaml | Cùng máy chủ đó với một thông tin xác thực có thể tham chiếu được gắn vào cho con đường helm được tổng hợp — giá trị được hiện thực hóa thành một Kubernetes Secret mà Deployment tham chiếu tới. |
manifest-compose.yaml | Ánh xạ kiểu NATS tới Compose Recipe (compose/nats) và thông tin xác thực tới dotenv-secret. |
manifest-helm-synth.yaml | Ánh xạ kiểu NATS tới helm Recipe được tổng hợp (helm/nats) và thông tin xác thực tới k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Các bản ghi của Operator cho hai hiện thực, không có xác thực. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Các bản ghi của Operator bật xác thực. |
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 máy chủ nhắn tin phi trạng thái. Ở dạng tinh gọn này, NATS định tuyến các subject trong
bộ nhớ với lưu trữ tệp JetStream bị tắt, nên component được định kiểu là
server. Trên Kubernetes, Recipe được tổng hợp render một Deployment một bản sao không có volume lưu trữ bền vững; service Compose mở máy chủ cho phát triển cục bộ. - Tổng hợp Workload (Kubernetes). helm Recipe được tổng hợp khai báo một
Workload — một Deployment cùng một ClusterIP Service chạy image
natschính thức — mà helm provider dịch thành các manifest Kubernetes mà không cần chart bên ngoài. Tập tài nguyên được render đúng như những gì Workload khai báo. Vì cả một Compose Recipe và một helm Recipe được tổng hợp đều mang tênnats, các Manifests tham chiếu chúng theo phạm vi provider làcompose/natsvàhelm/nats. - Xác thực tùy chọn, tất định trong cả hai trường hợp. Xác thực NATS tắt theo mặc định. Khi không gắn thông tin xác thực, không cách hiện thực nào bật xác thực và kết quả render giống hệt từng byte qua các lần chạy. Khi gắn một thông tin xác thực, giá trị được tiêm vào bật xác thực user/password trên cả hai cách hiện thực.
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ó:
aggrega scaffold --example nats-messagingSau đó 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:
cd nats-messagingBuild
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:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullCá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ỉ sử 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 không gian làm việc chưa chứa thư mục `nats-messaging`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `nats-messaging` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `nats-messaging` 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` được đặt thành `nats-messaging`, `release` được đặt thành tệp đó, `auto_pull` được đặt thành true và `write` được đặt thành true. Hãy cho tôi biết mỗi bản build đã ghi những tệp nào; chúng nằm trong `nats-messaging/dist/`.Ghi chú về việc cung cấp thông tin xác thực
Trên con đường Compose, thông tin xác thực là một secret kiểu inject-value
(aggregate-auth.yaml): giá trị của nó được truyền qua đường môi trường của component
và máy chủ được khởi động với các cờ xác thực user/password.
Con đường helm được tổng hợp dùng một thông tin xác thực có thể tham chiếu được
(aggregate-helm-synth-auth.yaml): giá trị được hiện thực hóa thành một Kubernetes
Secret, Deployment tham chiếu tới nó qua một env secretKeyRef, và
máy chủ được khởi động với các cờ --user/--pass đọc biến môi trường
đó. Do đó mật khẩu dạng văn bản thuần không bao giờ xuất hiện trong manifest
Deployment — chỉ trong Secret.
Giá trị origin trong các Aggregates có 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ực tế.