Memcached — một Aggregate, hai đích, và một mật khẩu bị từ chối
Ví dụ tinh gọn này biên dịch một bộ nhớ đệm trong bộ nhớ Memcached duy nhất từ một Aggregate do Developer soạn thành hai 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
memcachedchính thức của upstream 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ỉ có lớp Recipe mà Manifest chọn là thay đổi theo từng hiện thực. Hai Aggregate khác gắn một mật khẩu vào bộ nhớ đệm, và các Releases của chúng là ví dụ phản diện: bản build dừng lại, vì không hiện thực nào có thể thực thi mật khẩu Memcached.
Các tệp
| Tệp | Vai trò |
|---|---|
aggregate.yaml | Ý định của Developer: một component cache có kiểu core/datastore/memcached, không có thông tin xác thực — bộ nhớ đệm chạy mà không có 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 inject-value được gắn vào slot password tùy chọn của component (con đường Compose). Bản build của nó dừng lại. |
aggregate-helm-synth-auth.yaml | Cùng bộ nhớ đệm đó với một thông tin xác thực mật khẩu có thể tham chiếu được gắn cho con đường helm tổng hợp. Bản build của nó dừng lại. |
manifest-compose.yaml | Ánh xạ kiểu Memcached tới Recipe Compose (compose/memcached) và thông tin xác thực tới dotenv-secret. |
manifest-helm-synth.yaml | Ánh xạ kiểu Memcached tới Recipe helm được tổng hợp (helm/memcached) 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. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Các bản ghi của operator trên hai Aggregate có mật khẩu. Mỗi bản build được dự kiến sẽ thất bại. |
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 kho dữ liệu phi trạng thái. Memcached giữ các mục trong bộ nhớ và không lưu
gì bền vững, nên component được định kiểu là một
serverthông thường thay vì mộtstateful-server. Trên Kubernetes, Recipe render một Deployment, không phải StatefulSet, và không yêu cầu volume bền vững; trên Compose, service không khai báo volume dữ liệu. - 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
memcachedchính thức — mà provider helm chuyển thành các manifest Kubernetes không cần chart bên ngoài. Tập tài nguyên được render đúng bằng những gì Workload khai báo. Vì cả một Recipe Compose lẫn một Recipe helm được tổng hợp đều mang tênmemcached, các Manifests tham chiếu chúng theo phạm vi provider làcompose/memcachedvàhelm/memcached. - Một sự bảo vệ mà hiện thực không thể cung cấp sẽ bị từ chối, chứ không bị bỏ qua. Component khai báo một slot
passwordtùy chọn. Imagememcachedkhông thực thi mật khẩu nào: hai chế độ xác thực của nó là SASL, chỉ dùng qua giao thức nhị phân, và một tệp xác thực ASCII, còn các client Memcached của catalog không dùng chế độ nào. Một Recipe chấp nhận phần gắn sẽ render một bộ nhớ đệm trả lời mọi client trong khi Aggregate nói rằng nó được bảo vệ, nên thay vào đó mỗi Recipe dừng bản build và nêu tên slot.
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 memcached-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 memcached-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)aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)aggrega build --release release-helm-synth.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 `memcached-cache`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `memcached-cache` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `memcached-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` và `release-helm-synth.yaml` — mỗi lần với `workspace_root` được đặt thành `memcached-cache`, `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 `memcached-cache/dist/`.Đối chứng: một mật khẩu mà bộ nhớ đệm không thể thực thi
Hai Release phản diện build các Aggregate có mật khẩu, và mỗi bản build được dự kiến sẽ thất bại:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullMỗi bản dừng trong Recipe Memcached, trước khi bất cứ thứ gì được ghi ra, và việc dừng kết thúc bằng thông điệp riêng của Recipe:
a password is attached to the password slot of "cache", but the memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkViệc từ chối dựa trên chính phần gắn, không dựa trên cách thông tin xác thực được cung cấp, nên mọi Feature có thể lấp slot đều dừng theo cùng một cách. Các hiện thực được quản lý cũng vậy: Amazon ElastiCache không cung cấp xác thực Memcached, và các Recipes của nó cũng dừng ở phần gắn. Do đó một bộ nhớ đệm Memcached được bảo vệ bởi việc ai có thể tiếp cận nó — mạng mà nó được đặt vào — và dạng cần build là aggregate.yaml cơ sở.