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ụcWorkloadLibraryđượ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/StatelessServiceHã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ó:
aggrega scaffold --example workload-library-importSau đó 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 workload-library-importBuild
aggrega pull --release release.yaml # pins BaseWorkloads in release.lockaggrega build --release release.yamlCatalog đượ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.