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.

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 nats chí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ệpVai 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.yamlCù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.yamlCù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.yamlCá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.yamlCá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 nats chí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ên nats, các Manifests tham chiếu chúng theo phạm vi provider là compose/nats và 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ó:

Terminal window
aggrega scaffold --example nats-messaging

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 nats-messaging

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), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
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ỉ 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ế.