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.

Nhập thư viện Workload — một phần thân Workload dùng chung qua `$import`

Một dịch vụ web phi trạng thái duy nhất có Recipe tổng hợp Workload Kubernetes của nó từ một mục thư viện dùng chung thay vì một phần thân nội tuyến. Đây là chế độ soạn thảo thứ ba của spec.workload trên một Recipe:

  • Chế độ 1 (nội tuyến): một Workload dạng Go template được viết trực tiếp trong Recipe.
  • Chế độ 2 (nhập tệp): $import: ./relative/path.yaml — một tệp cục bộ.
  • Chế độ 3 (nhập thư viện): $import: <Library>#/workloads/<Entry> — một mục WorkloadLibrary được tham chiếu bằng định danh tên trần.

Recipe web-service ở đây dùng Chế độ 3:

spec:
capability: helm
implements: example/compute/web-service
workload:
$import: BaseWorkloads#/workloads/StatelessService

Hãy viết tham chiếu thành một token liền mạch: không có khoảng trắng và không ngắt dòng ở bất kỳ đâu trong đó, từ tên thư viện đến hết phần fragment. Một tham chiếu chứa khoảng trắng sẽ bị từ chối chứ không được cắt bỏ, và quá trình build dừng lại — xem errors/fatal-halts.md “A reference to a library entry carries whitespace (Một tham chiếu đến mục thư viện chứa khoảng trắng)”.

BaseWorkloads là một WorkloadLibrary được xuất bản trong catalog hub (workloadlibrary/base-workloads). Mục StatelessService của nó là một Go template được đánh giá trong ngữ cảnh render của Recipe này, nên .values.image (từ Component/Aggregate) và .infra.* (replicas, port, compute — từ Release) đi vào đó đúng như với một phần thân nội tuyến. Việc tách Workload thành một thư viện không thay đổi gì về những gì được triển khai: đầu ra được render giống hệt từng byte với Workload nội tuyến tương đương.

Phiên bản của thư viện được cung cấp bởi lockfile của từng Release — không có máy chủ registry nào xuất hiện trong tham chiếu. Khi chạy aggrega pull, BaseWorkloads được ghim trong phần workload_libraries của lockfile; khi chạy aggrega build, thư viện đã ghim được phân giải và mục của nó được render.

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 workload-library-import

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 workload-library-import

Build

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

Catalog được phân giải từ registry hub được nêu trong .aggrega-config.yaml (cung cấp BaseWorkloads và provider helm) cùng với catalog/ cục bộ của ví dụ này (Component và Recipe web-service). Các Manifests được đặt dưới dist/app/helm/ — directory: của ranh giới, theo sau là capability của provider.

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

Kiểm chứng khẳng định giống hệt từng byte

Thay workload: { $import: … } của Recipe bằng một khối workload: | chứa nguyên văn phần thân StatelessService, build lại, và so sánh hai cây dist/. Chúng khớp hoàn toàn: tham chiếu thư viện phân giải thành cùng một văn bản template, được đánh giá trong cùng ngữ cảnh render, nên việc nhập chỉ là một cách tách bề mặt soạn thảo, không ảnh hưởng đến các byte được render.