Valkey — một Aggregate, hai đích, xác thực tùy chọn
Ví dụ gọn nhẹ này biên dịch một bộ nhớ đệm trong bộ nhớ Valkey duy nhất (giao thức truyền tải Redis) từ một Aggregate do Developer soạn thảo thành hai cách hiện thực:
- Docker Compose cho phát triển cục bộ, và
- Recipe helm được tổng hợp chạy trực tiếp image upstream chính thức
valkey/valkeytrên Kubernetes (không có chart bên ngoài).
Recipe helm được tổng hợp là con đường Kubernetes: 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 kết xuất của nó đúng như 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. Hai Aggregates khác thể hiện cùng bộ nhớ đệm đó với một thông tin xác thực mật khẩu tùy chọn được gắn kèm: aggregate-auth.yaml cho con đường Compose (một thông tin xác thực inject-value mà máy chủ được khởi động cùng), và aggregate-helm-synth-auth.yaml cho con đường helm được tổng hợp (một thông tin xác thực có thể tham chiếu được hiện thực thành một Secret của Kubernetes).
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component cache thuộc kiểu core/datastore/valkey, không có thông tin xác thực — bộ nhớ đệm chạy mà không cần xác thực. |
aggregate-auth.yaml | Cùng bộ nhớ đệm đó với một thông tin xác thực mật khẩu được gắn vào slot password tùy chọn của component (đường đi Compose). |
aggregate-helm-synth-auth.yaml | Cùng bộ nhớ đệm đó với một thông tin xác thực có thể tham chiếu được gắn cho con đường helm được tổng hợp — giá trị được hiện thực hóa thành một Secret Kubernetes mà Deployment tham chiếu. |
manifest-compose.yaml | Ánh xạ kiểu Valkey tới Recipe Compose (compose/valkey) và thông tin xác thực tới dotenv-secret. |
manifest-helm-synth.yaml | Ánh xạ kiểu Valkey tới Recipe helm được tổng hợp (helm/valkey) 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 datastore đóng vai trò bộ nhớ đệm. Ở đây Valkey được dùng làm bộ nhớ đệm trong bộ nhớ và
không lưu trữ gì bền vững, nên component được định kiểu là một
serverđơn thuần thay vì mộtstateful-server. Trên Kubernetes, Recipe helm được tổng hợp kết xuất một Deployment, không phải StatefulSet, và không yêu cầu persistent volume; trên Compose, service không khai báo volume dữ liệu nào. - Tổng hợp Workload (Kubernetes). Recipe helm được tổng hợp khai báo một
Workload — một Deployment cùng một Service ClusterIP chạy image chính thức
valkey/valkey— mà provider helm chuyển thành các manifest Kubernetes mà không cần chart bên ngoài. Tập tài nguyên được kết xuất đúng như những gì Workload khai báo. Vì cả một Recipe Compose và một Recipe helm được tổng hợp đều mang tênvalkey, các Manifests tham chiếu chúng theo phạm vi provider làcompose/valkeyvàhelm/valkey. - Xác thực tùy chọn qua một slot thông tin xác thực. Component khai báo một slot
passwordtùy chọn trongfeaturesSchemacủa nó. Khi không có thông tin xác thực nào được gắn kèm (Aggregate cơ sở), Recipe kết xuất bộ nhớ đệm với xác thực bị tắt — giống hệt từng byte với một Recipe không có slot. Khi một thông tin xác thực được gắn kèm, cả hai đích đều khởi động Valkey với--requirepass, nên server yêu cầu mật khẩu: trên Compose, giá trị đến server qua biếnVALKEY_EXTRA_FLAGScủa image; trên Kubernetes, con đường helm được tổng hợp hiện thực nó thành một Secret mà Deployment tham chiếu.
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 valkey-cacheSau đó 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 valkey-cacheBuild
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ỉ 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 có thư mục `valkey-cache`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `valkey-cache` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `valkey-cache` 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 `valkey-cache`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết mỗi lần build đã ghi những tệp nào; chúng nằm dưới `valkey-cache/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 inject-value (aggregate-auth.yaml): giá trị của nó được truyền trên đường ống môi trường của component dưới biến mà values.key của nó nêu tên, VALKEY_PASSWORD, và Recipe trao nó cho server dưới dạng --requirepass qua biến VALKEY_EXTRA_FLAGS của image, nên nó xuất hiện trong môi trường của service nhưng không có trên dòng lệnh của nó. Script khởi động của image mở rộng biến đó mà không có dấu nháy, nên một mật khẩu chứa dấu cách sẽ làm server dừng khi khởi động, còn một mật khẩu chứa *, ? hoặc [ sẽ được so khớp với các tên tệp trong thư mục dữ liệu của server, vì vậy hãy viết mật khẩu không có cả hai loại đó. Một đính kèm mật khẩu có giá trị đến Recipe dưới một biến mà Recipe không đọc sẽ dừng bản build, nêu tên slot, thay vì kết xuất một bộ nhớ đệm không được bảo vệ.
Con đường helm được tổng hợp dùng một thông tin xác thực có thể tham chiếu
(aggregate-helm-synth-auth.yaml): giá trị được hiện thực thành một Secret của Kubernetes,
Deployment tham chiếu nó qua một env secretKeyRef, và Valkey được
khởi động với --requirepass đọc biến môi trường đó. Vì vậy mật khẩu dạng văn bản thuần
không bao giờ xuất hiện trong manifest của Deployment — chỉ có trong
Secret. Đây là điều thực sự bật xác thực trên image chính thức
valkey/valkey, vốn không tự đọc mật khẩu từ môi trường.
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ế.