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.

Ghi đè recipe theo từng thể hiện

Ví dụ này minh họa một tính năng của Manifest: tầng ánh xạ name, tầng này ghi đè Recipe cho một thể hiện component duy nhất, trong khi mọi thể hiện khác cùng kiểu vẫn giữ Recipe hàng loạt ở tầng type.

Ví dụ này cho thấy gì

Aggregate khai báo hai thể hiện của một kiểu component (example/compute/greeter):

components:
greeter-default:
type: example/compute/greeter
greeter-special:
type: example/compute/greeter

Catalog cung cấp hai Recipes cùng triển khai example/compute/greeter — greeter-blue (bản dựng mặc định) và greeter-green (một bản dựng thay thế). Manifest ánh xạ kiểu này hàng loạt và ghi đè một thể hiện theo tên:

mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 # every greeter instance...
name:
greeter-special: compose/greeter-green:1.0.0 # ...except this one

Tên được ưu tiên hơn kiểu, nên greeter-special được triển khai qua greeter-green còn greeter-default qua greeter-blue.

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 per-instance-recipe-override

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 per-instance-recipe-override

Build

Terminal window
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Ví dụ này dùng thư viện chuẩn cho provider của nó: provider compose có sẵn trong catalog chuẩn. Các thành phần minh họa riêng của bài học ghi đè — component demo example/compute/greeter và hai recipe của nó (greeter-blue / greeter-green), vốn chỉ tồn tại để làm cho việc ghi đè theo từng thể hiện hiện rõ — nằm trong catalog dùng chung dưới nhà phát hành example/, cùng với các thực thể của thư viện chuẩn. .aggrega-config.yaml khai báo hub.aggrega.ai là registry mặc định, nên các thực thể được phân giải từ hub — lệnh build không cần cờ --catalog.

Tệp dist/app/compose/docker-compose.yaml được kết xuất cho thấy việc ghi đè có hiệu lực — greeter-default chạy image: greeter:blue, greeter-special chạy image: greeter:green, và nhãn nguồn gốc aggrega.ai/recipe-uri của mỗi service ghi tên Recipe riêng biệt mà nó được phân giải tới.

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 Workspace chưa có thư mục `per-instance-recipe-override`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `per-instance-recipe-override` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `per-instance-recipe-override` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `per-instance-recipe-override`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết bản dựng đã ghi những tệp nào; chúng nằm trong `per-instance-recipe-override/dist/`.

Vì sao điều này hữu ích

Hai thể hiện của cùng một kiểu component đôi khi cần các triển khai vật lý khác nhau — ví dụ một cơ sở dữ liệu chính dùng Recipe đám mây được quản lý, trong khi các bản sao của nó dùng Recipe trong cluster. Tầng name biểu đạt điều đó theo từng thể hiện, trong Manifest, mà không cần tách nhánh kiểu component hay nhân bản Aggregate. Một kiểu được nhiều hơn một Recipe triển khai phải được phân định rõ bằng một ánh xạ; nếu không được ánh xạ, quá trình build sẽ dừng và nêu tên các ứng viên thay vì đoán.