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.

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 memcached chí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ệpVai 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.yamlCù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.yamlCù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.yamlCác bản ghi của Operator cho hai hiện thực.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlCá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 server thông thường thay vì một stateful-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 memcached chí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ên memcached, các Manifests tham chiếu chúng theo phạm vi provider là compose/memcached và 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 password tùy chọn. Image memcached khô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ó:

Terminal window
aggrega scaffold --example memcached-cache

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 memcached-cache

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)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)
aggrega build --release release-helm-synth.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 `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:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega build --release release-negative-helm-synth-auth.yaml --auto-pull

Mỗ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 memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

Việ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ở.