Workload
Vai trò kiến trúc của kind Workload — lý do nó tồn tại, cách nó kết hợp với hai kind đầu vào khác của Recipe (sourced và artifacts), và toàn bộ bề mặt schema — được trình bày trong ../../architecture/16-recipe-input-composition.md. Trang này đề cập đến bề mặt soạn thảo Workload: cách một tác giả Recipe viết nội dung Workload, những gì trình biên dịch đánh giá và vào lúc nào, cách các trường của Workload tương tác với featuresSchema của Component, và các template bên trong một Workload có thể đọc những trụ cột nào.
Vị trí soạn thảo
Nội dung Workload được soạn trực tiếp (inline) hoặc từ tệp, bên trong một Recipe hoặc một FeatureRecipe (xem FeatureRecipe). Một Recipe khai báo tối đa một workload:; tương tự, một FeatureRecipe khai báo tối đa một Workload của riêng nó:
# Inline (block scalar)spec: workload: | apiVersion: aggrega.ai/v1beta1 kind: Workload # ...hoặc
# File-loaded via $import: (path relative to the Recipe directory)spec: workload: $import: ./workload/workload.yamlCả hai dạng đều tạo ra cùng một đối tượng Workload sau khi phân tích cú pháp; việc chọn dạng nào chỉ là vấn đề thuận tiện khi soạn thảo. Dạng thứ ba nhập một Workload dùng chung giữa nhiều Recipes từ một mục WorkloadLibrary, theo danh tính tên trần của nó: $import: <Library>#/workloads/<entry>. Theo bộ từ vựng nhập tệp hợp nhất, $import: chấp nhận một nguồn duy nhất — xem ../vocabulary/cross-document-ref.md để biết sự phân biệt rộng hơn giữa $ref: và $import:.
YAML của Workload không được soạn như một thực thể catalog độc lập. Không có thư mục catalog/workload/; ngữ pháp Workload chỉ tồn tại dưới dạng nội dung mà một Recipe hoặc FeatureRecipe sử dụng — được viết inline, trong một tệp bên cạnh nó, hoặc trong một mục WorkloadLibrary. Các khai báo apiVersion và kind bên trong YAML (apiVersion: aggrega.ai/v1beta1, kind: Workload) định danh nội dung nhúng để kiểm tra lược đồ; chúng không khiến Workload có thể được tham chiếu một cách độc lập.
Đánh giá template
Nội dung Workload được xử lý bằng Go template dựa trên toàn bộ ngữ cảnh pillar trước khi phân tích cú pháp. Khi một tác giả Recipe viết một template như sau…
replicas: {{ optional .infra `replicas` 1 }}…trình biên dịch đánh giá template đó trong lượt con Workload của quá trình render, phân giải .infra.replicas dựa trên payload infra của node, và phân tích YAML thu được thành một tài liệu Workload. Các locals của Recipe được phân giải trước khi Workload được đánh giá, nên một template Workload đọc chúng, đã được phân giải sẵn, dưới .locals.
Truy cập pillar bên trong các template Workload:
.values— payload nhận thức do developer viết, được khai báo trong Aggregate..infra— kích thước vật lý do Ops viết, được khai báo trong Release..parameters— đã được nội suy khi phân giải; hiển thị qua.values/.infraở bất cứ chỗ nào Developer hoặc Ops đã tham chiếu.parameters.<name>trong phần họ viết..locals— trạng thái riêng của Recipe, được phân giải trong phần mở đầu locals và công bố khi phân giải nguồn; có sẵn tại mọi vị trí đánh giá template của Workload..context.instance_id— ID instance đã làm phẳng của node; tiền tố của tên các tài nguyên mà một provider đặt tên tài nguyên tổng hợp theo định danh sẽ phát ra..context.rendered_name— tên mà một provider tự suy ra tên cho các tài nguyên tổng hợp đặt cho chúng, chẳng hạn tên release của helm; chỉ có mặt khi provider báo cáo một tên. Xem ../templates/rendered-resource-names.md..context.inject— ống inject sau chặn, đã được viết lại bởi bất kỳinjectMappingnào của FeatureRecipe trong bước inject mapping..context.uses— các cạnh topology đã làm giàu đi ra từ node này, mỗi cạnh mangprovidesđã phân giải,labelsvà các annotation lan truyền của đích, và, dưới.context.uses.<alias>.features.<slot>, các attachment mà kết nối đó mang theo..features— các attachment của chính node, mỗi attachment mangtype,values,infravàprovidesđã phân giải. Một attachment được đặt tên theo một slot mà Component khai báo trongfeaturesSchemasẽ lấp slot đó (xem bên dưới). Một attachment do một kết nối mang theo không nằm trong số này; nó được đọc dưới kết nối của nó, và một Workload phân phối nó bằng cách nêu tên kết nối (xem Phân phối một thông tin xác thực do một kết nối mang theo).
Xem ../vocabulary/data-pillars.md để biết toàn bộ hợp đồng truy cập pillar và ../templates/expansion-matrix.md để biết việc đánh giá Workload nằm ở đâu trong trình tự đánh giá template.
Những điểm cốt yếu về ngữ nghĩa trường
Lược đồ Workload đầy đủ nằm trong ../../architecture/16-recipe-input-composition.md, mục “The Workload Kind.” Các quy ước soạn thảo dưới đây bao quát những quyết định ở cấp trường mà một tác giả Recipe đưa ra.
form
form khai báo hình dạng controller trừu tượng của workload — loại vòng đời runtime của nó, độc lập với mọi nền tảng đích. Đây là một chuỗi duy nhất, là một trong stateless, stateful, daemon, scheduled, task, reference, và mặc định là stateless khi bị bỏ qua:
stateless— các bản sao có thể thay thế cho nhau, mở rộng theo chiều ngang, không có định danh riêng cho từng bản sao (dịch vụ chạy lâu dài thông thường).stateful— các bản sao có định danh ổn định và lưu trữ riêng cho từng bản sao. Một volumepersistentTemplatelà thành phần đi kèm của dạng này.daemon— một instance trên mỗi host đủ điều kiện.scheduled— các lần chạy định kỳ, được kích hoạt theo thời gian.task— một lần chạy duy nhất cho đến khi hoàn tất.reference— không có container riêng: component đại diện cho một endpoint bên ngoài, được cho dưới dạngendpoint(một host hoặc URL, được truyền nguyên văn) và mộtporttùy chọn. Provider helm phát nó ra dưới dạng một Service kiểuExternalName; provider compose không phát ra gì cho nó.
Bản thân form không mang loại tài nguyên gốc của nền tảng nào. Mỗi provider đích tổng hợp Workload sẽ ánh xạ form sang hình dạng gốc của riêng nó:
form | Kubernetes (helm) | Compose |
|---|---|---|
stateless | Deployment | service (không có persistent volume) |
stateful | StatefulSet | service + named volume |
daemon | DaemonSet | dừng build |
scheduled | CronJob | dừng build |
task | Job | dừng build |
Các provider terraform và cloudformation kết xuất các Recipes có nguồn và các Recipes chỉ có artifacts, và không tổng hợp Workload nào: một Recipe khai báo workload: và được gắn với một trong hai provider này sẽ dừng build, nêu ra các loại đầu vào mà provider hỗ trợ.
Khi một provider đích không có ánh xạ rõ ràng cho một form, quá trình build dừng lại một cách rõ ràng thay vì hạ cấp workload thành một hình dạng phản ánh sai ý định — chọn một form mà ranh giới đích không thể biểu diễn là lỗi lúc build, không phải một sự hạ cấp âm thầm. Provider compose dừng với daemon, scheduled và task. Provider helm phát ra một CronJob cho scheduled (xem schedule bên dưới) và chỉ dừng khi schedule của nó vắng mặt hoặc sai định dạng.
apiVersion: aggrega.ai/v1beta1kind: Workloadform: statefulcontainers: db: { image: "postgres:16", ports: { db: 5432 } }volumes: data: persistentTemplate: size: "20Gi"services: headless: type: Headless ports: db: 5432schedule
schedule là lịch cron cho một workload form: scheduled — trường đi kèm cung cấp chu kỳ lặp cho form định kỳ. Đây là một chuỗi duy nhất theo một định dạng chuẩn:
- một biểu thức crontab chuẩn 5 trường — phút, giờ, ngày trong tháng, tháng, ngày trong tuần (ví dụ
0 0 * * *cho hằng ngày lúc nửa đêm,*/15 * * * *cho mỗi mười lăm phút), hoặc - một trong các macro
@hourly,@daily,@weekly,@monthly,@yearly.
schedule là bắt buộc khi form: scheduled và chỉ có ý nghĩa trong trường hợp đó. Một workload form: scheduled không có schedule, một schedule không phải biểu thức 5 trường cũng không phải macro được nhận diện (biểu thức 6 trường có tiền tố giây, một token @ không được nhận diện, hoặc một trường chứa ký tự không hợp lệ), hoặc một schedule được đặt trên bất kỳ form nào khác đều gây dừng lúc build, kèm cách khắc phục. Provider helm chuyển nguyên văn giá trị vào spec.schedule của CronJob được phát ra.
apiVersion: aggrega.ai/v1beta1kind: Workloadform: scheduledschedule: "0 2 * * *" # daily at 02:00containers: report: image: "reporter:1.0" command: ["/report"]suspend
suspend tạm giữ lịch chạy định kỳ của một workload form: scheduled. Đây là giá trị boolean, mặc định là false. Với suspend: true, tài nguyên được lập lịch vẫn được kết xuất với schedule của nó giữ nguyên, nhưng không lần chạy nào bắt đầu từ lịch đó cho đến khi lịch được tiếp tục, và vẫn có thể bắt đầu một lần chạy thủ công từ tài nguyên. Đó là hình dạng dành cho một tác vụ chỉ nên chạy khi có người yêu cầu.
Provider helm phát trường này ra dưới dạng spec.suspend: true của CronJob. Trên Kubernetes, kubectl create job <name> --from=cronjob/<cronjob> bắt đầu một lần chạy từ CronJob đang bị tạm giữ, và lịch được tiếp tục khi spec.suspend trở lại là false. suspend: false được kết xuất giống hệt như khi bỏ qua suspend, nên trường này không thay đổi đầu ra nào cho đến khi được đặt. Provider compose không có hình dạng lập lịch và dừng build với mọi workload form: scheduled, dù có bị tạm giữ hay không.
suspend: true trên bất kỳ form nào khác là một lần dừng lúc build có nêu cách sửa: không form nào khác mang lịch để nó tạm giữ.
apiVersion: aggrega.ai/v1beta1kind: Workloadform: scheduledschedule: "0 2 * * *" # documents when it would run; nothing starts it while suspendedsuspend: truecontainers: report: image: "reporter:1.0" command: ["/report"]replicas
Một số nguyên duy nhất cho số lượng bản sao của workload. Mặc định là 1 khi bị bỏ qua. Dùng một biểu thức template để điều khiển replicas từ cấu hình kích thước do Ops khai báo:
replicas: {{ optional .infra `replicas` 1 }}containers so với initContainers
containers là một map có thứ tự với khóa là tên container. Container 0 (khóa đầu tiên của map) có ý nghĩa đối với thứ tự trong pod spec ở đầu ra Kubernetes và đối với ngữ nghĩa container mặc định. initContainers là một danh sách có thứ tự các mục init container, mỗi mục mang name, image và cùng hình dạng soạn thảo variable/secret/volume-mount như các container chính.
name là tùy chọn trên một mục initContainers. Một mục bỏ qua nó sẽ được đặt tên init-<index>, trong đó index là vị trí của mục trong danh sách, đếm từ 0. Vì tên định danh container trong đầu ra được render và trong mọi chẩn đoán nhắc đến nó, một mục đáng được tham chiếu thì cũng đáng được đặt tên tường minh.
Việc giữ nguyên thứ tự của tác giả là một cam kết nền tảng của mô hình Workload — trình biên dịch phát ra containers, volumes, services, ports của container, variables của container và attachments của container, mỗi loại theo đúng thứ tự tác giả Recipe đã khai báo, ở mọi lần build. Tác giả Recipe có thể dựa vào hình dạng có thứ tự này: khi những gì xảy ra lúc chạy phụ thuộc vào thứ tự (khởi động sidecar, chuỗi $(VAR) trong biến môi trường, volumeMounts tham chiếu các volume đã khai báo trước), thứ tự soạn thảo CHÍNH LÀ thứ tự runtime trong mỗi tập hợp đó. Môi trường của một container kết hợp hai trong số chúng, và giữa hai tập này các provider tổng hợp ghi các mục đọc từ attachment (attachments được chuyển giao as: env) trước rồi đến các variables thông thường sau, mỗi loại theo thứ tự soạn thảo — vì vậy trên đích Kubernetes, một biến có thể tham chiếu, dưới dạng $(NAME), bất kỳ biến đọc từ attachment nào của container đó và bất kỳ biến nào được khai báo trước nó (xem thứ tự môi trường của provider helm). Một container dùng cùng một tên vừa làm mục variables vừa làm mục attachments được chuyển giao as: env sẽ làm dừng build, vì chỉ riêng thứ tự đó sẽ quyết định tiến trình thấy giá trị nào trong hai giá trị (xem A container gives one environment variable two values (Một container gán cho một biến môi trường hai giá trị)).
Việc soạn thảo các trường container tuân theo các quy ước sau:
imagethường là một biểu thức template tham chiếu.values.image(image do Developer chọn) với các ghi đè.infra.*tùy chọn để thêm tiền tố registry theo từng môi trường.variableslà một map chuỗi → chuỗi đơn giản cho biến môi trường. Map này pha trộn hai nguồn dữ liệu khác biệt thông qua biểu thức template Go: giá trị literal từ developer pillar (các mục có biểu thức template đọc.values/.infra/.locals— payload xuất phát từ các pillar của Component) và dữ liệu pipe liên component (các mục có biểu thức template đọc.context.inject.env.<KEY>— payload xuất phát từprovides:của một component khác và được định tuyến qua pipe topology). Hai nguồn chảy vào cùng một mapvariables; tác giả chọn một nguồn cho mỗi mục tùy theo giá trị là cục bộ của component hay được suy ra từ component khác. Các mẫu phổ biến:LOG_LEVEL: "{{ .values.log_level }}"là developer pillar (cục bộ của component);DB_HOST: "{{ .context.inject.env.DB_HOST }}"là pipe liên component (giá trị xuất phát từprovides.hostcủa component đích, được định tuyến qua khai báouses[].inject.env.DB_HOSTcủa bên gọi). Cả hai dạng đều biên dịch thành một danh sách Kubernetesenv:duy nhất trên Deployment được render; ngữ nghĩa hai nguồn chỉ tồn tại lúc soạn thảo.attachmentstham chiếu các slot được khai báo trongfeaturesSchemacủa Component, hoặc, bằng cách nêu tên một kết nối, một slot mà socket của kết nối đó khai báo (xem phần tích hợp bên dưới).portslà một map cổng có tên (web: 8080,admin: 9901); tên cổng khớp với tên cổng trong phạm vi container và được tham chiếu bởiservices.<service>.ports.<portname>. Một cổng mang giao thức truyền tải khác với mặc định của đích thì được soạn theo dạng mở rộng — xem Giao thức truyền tải của cổng bên dưới.volumeMountstham chiếu theo tên các volume được khai báo ở nơi khác trong phầnvolumes:của Workload.resourceskhai báorequestsvàlimitscủa container — các lượngcpuvàmemory, và tùy chọn các khóa extended resource cho GPU và các thiết bị khác (xem Workload dùng GPU và thiết bị bên dưới).healthdùng hình dạng ý định (http: /path,tcp: <port>,exec: [cmd, ...]) — xem phần Health Probes bên dưới.
volumes
Mỗi volume có đúng một kiểu: ephemeral, configmap, secret, persistent hoặc persistentTemplate. Các kiểu loại trừ lẫn nhau trong một khai báo volume; mỗi kiểu có các trường bắt buộc riêng:
volumes: app-config: configmap: source: "{{ .locals.app_cm }}" data: persistent: size: "10Gi" class: "gp3" cache: ephemeral: sizeLimit: "1Gi"persistentTemplate tạo ra một PVC cho mỗi replica khi chuyển đổi theo dạng StatefulSet; khi chuyển đổi sang compose, nó bị hạ cấp thành một named volume dùng chung duy nhất, kèm một cảnh báo được báo cáo cùng bản build. Bản thân tệp được tạo ra không mang ghi chú nào về sự hạ cấp này — nó giống hệt từng byte so với khi không có cảnh báo.
Chuyển đổi theo từng provider. Mỗi provider chuyển đổi năm biến thể volume thành dạng gốc của nó:
| Biến thể | Helm / helm-chart (K8s) | Compose | Ghi chú về mất mát |
|---|---|---|---|
ephemeral | emptyDir: { sizeLimit } | mục tmpfs: ở cấp service nêu đường dẫn mount (trong bộ nhớ) | tmpfs của Compose dựa trên RAM; emptyDir của helm mặc định dựa trên đĩa của node — khác biệt ngữ nghĩa ở phương tiện lưu trữ bên dưới. sizeLimit không đi vào phần nào của đầu ra compose: mục được phát ra chỉ là đường dẫn mount. Một sizeLimit được khai báo sẽ gây ra cảnh báo unsupported-field nêu tên nó, được báo cáo cùng bản build thay vì ghi vào tệp được tạo ra. |
configmap | Tham chiếu volume ConfigMap (dùng một tài nguyên ConfigMap do artifacts: của Recipe hoặc một Feature phát ra) | Tham chiếu configs: ở cấp service nêu tên configmap, được mount tại đường dẫn mount của volume; mục configs: cấp cao nhất tương ứng đến từ artifacts: của Recipe | Cả hai đích đều tham chiếu configmap theo tên và không đích nào đọc nội dung của nó, nên dạng khai báo là đối xứng. Điều compose mất đi là ngữ nghĩa cập nhật-khi-rollout của ConfigMap trong K8s: một config của compose cố định ở nội dung mà bản build đã phát ra. Một tham chiếu không được mục cấp cao nhất nào phân giải sẽ dừng bản build thay vì phát ra một mount bị treo lúc chạy. |
secret | Tham chiếu volume Secret (dùng Secret mà một attachment thông tin xác thực nêu tên — Secret do FeatureRecipe của nó phát ra, hoặc một Secret đã tồn tại) | env_file: cho các secret dạng env, hoặc một tệp secret được bind-mount cho các secret dạng đường dẫn | Compose thiếu ngữ nghĩa Secret hạng nhất của Kubernetes. Một secret dạng đường dẫn cố ý không đi theo lối configs: của biến thể configmap: một mục config nội tuyến sẽ ghi giá trị của secret vào tệp compose được phát ra dưới dạng văn bản thuần, và trình biên dịch không bao giờ phân giải một secret thành văn bản thuần. Nguồn bind là một đường dẫn mà người vận hành làm cho truy cập được trên máy chủ compose, nằm ngoài mọi vòng đời CRD lấy từ vault. |
persistent | Tài nguyên PVC + volume.persistentVolumeClaim | Named volume | Named volume của Compose là một trừu tượng phẳng phía máy chủ; PVC của helm hỗ trợ khai báo storage class, access mode và dung lượng mà compose bỏ qua. |
persistentTemplate | StatefulSet.volumeClaimTemplates (PVC cho mỗi replica; đi kèm form: stateful) | Named volume (bị hạ cấp — một volume dùng chung duy nhất cho các replica, kèm cảnh báo được báo cáo) | Compose không thể biểu diễn template cho mỗi replica. Khi persistentTemplate được chuyển đổi sang compose, một named volume duy nhất được phát ra và độ trung thực bị giảm được báo cáo dưới dạng cảnh báo cùng bản build thay vì ghi vào tệp được tạo ra. Các Workloads dựa vào việc cô lập volume theo từng replica không nên nhắm tới các ranh giới chỉ có compose. |
Dạng controller được chọn bởi form của workload, không phải bởi các volume của nó. Một StatefulSet được phát ra khi form: stateful; một volume persistentTemplate là thành phần đi kèm của form đó — nó khai báo lưu trữ theo từng replica trên một workload vốn đã có danh tính theo từng replica mà StatefulSet cung cấp. Khai báo một volume persistentTemplate trên bất kỳ form nào khác (hoặc trên stateless mặc định) là một lỗi lúc build nêu cách sửa: declare form: stateful. Chiều ngược lại được phép — một workload form: stateful không cần khai báo volume persistentTemplate. Tác giả muốn có ngữ nghĩa StatefulSet thì đặt trực tiếp form: stateful.
Một workload form: stateful trên helm provider cần một Service điều phối headless: hãy khai báo đúng một service với type: Headless trong cùng Workload. Provider nối serviceName của StatefulSet với Service headless đó (nó cung cấp danh tính mạng ổn định cho từng pod mà StatefulSet cần). Bản build dừng lại nếu không có service headless nào được khai báo — StatefulSet không có Service điều phối để nêu tên — hoặc nếu có nhiều hơn một, khiến Service điều phối trở nên mơ hồ. Một workload StatefulSet vẫn có thể khai báo thêm các service không headless (ví dụ một service ClusterIP cho client truy cập) bên cạnh service điều phối headless duy nhất đó.
Lượng tài nguyên
Các giá trị Workload sau là lượng (quantity) — số lượng được viết theo ký pháp mà Kubernetes dùng cho tài nguyên: các giá trị resources.requests và resources.limits của một container (hoặc init container) cho cpu, cho memory và cho mọi khóa extended-resource, cùng ephemeral.sizeLimit, persistent.size và persistentTemplate.size của một volume. Schema của Workload định kiểu mỗi giá trị là chuỗi và không ràng buộc dạng của nó. Provider tổng hợp Workload cho một đích sẽ kiểm tra mọi lượng mà nó phát ra, và nó kiểm tra Workload theo kết quả các template của Recipe đã đánh giá, nên một giá trị đến qua infra, một tham số Release hay bất kỳ đầu vào template nào khác được xét theo chuỗi mà nó được render ra.
Một lượng, không có gì đứng trước hay sau nó, gồm:
- một dấu tùy chọn,
+hoặc-; - một số có ít nhất một chữ số —
2,0.5,.5hoặc1.; - nhiều nhất một trong hai: một số mũ —
ehoặcE, một dấu tùy chọn, rồi các chữ số, như1e3hoặc5E-2— hoặc một hậu tố đơn vị: hậu tố thập phânn,u,m,k,M,G,T,PhoặcE(từ 10⁻⁹ đến 10¹⁸, mỗi bậc gấp một nghìn), hoặc hậu tố nhị phânKi,Mi,Gi,Ti,PihoặcEi(từ 1024 đến 1024⁶).
500m, 0.5, 2, 128Mi, 1.5Gi, 1e3, 5n và 4u là các lượng; lots, 1.5 cores, 1 gigabyte, 10 GB và 1e1.5 thì không — số mũ là một số nguyên. Một E đứng riêng sau số là hậu tố thập phân cho 10¹⁸ (12E); nếu theo sau là chữ số thì nó mở đầu một số mũ (1E3).
Đây là dạng mà trình phân tích quantity của chính Kubernetes chấp nhận, với một khác biệt có chủ ý: một chuỗi có phần số không chứa chữ số nào — m, Ki, +, ., e5 — bị từ chối, trong khi Kubernetes đọc nó là không. Chuỗi đó chính là thứ một template để lại khi giá trị nó nội suy bị rỗng: "{{ .infra.cpu }}m" với cpu rỗng sẽ render thành m. Việc từ chối biến một đầu vào rỗng thành một lần dừng có nêu tên trường, thay vì thành một yêu cầu kích thước bằng không mà không gì báo cáo.
Mỗi đích làm gì với một lượng:
- helm phát ra mọi lượng nguyên văn, sau khi kiểm tra từng lượng theo dạng ở trên. Một giá trị nằm ngoài dạng đó sẽ dừng bản build với lỗi nêu node, đường dẫn của trường trong Workload —
containers.main.resources.requests.cpu,initContainers[0].resources.limits.memory,volumes.data.persistent.size— và giá trị. Xem Helm Provider → chế độ Workload (tổng hợp). - compose chuyển
cpuvàmemorysang đơn vị riêng của nó từ giá trị đã phân tích:cpustrở thành số core thập phân (500m→0.5) vàmemorythành số byte chính xác (1.5Gi→1610612736). Một giá trị không phải lượng sẽ dừng bản build, và một lượng mà compose không thể biểu diễn chính xác cũng vậy — một số lượng âm, một lượng bộ nhớ không phải số byte nguyên (1500m), hoặc một lượng cpu chi tiết hơn chín chữ số thập phân của một core — và lỗi cho biết nó gặp trường hợp nào trong hai. Số lượngnvidia.com/gpuđược đọc theo cùng cách và trở thành số thiết bị, nên một giá trị không phải số nguyên thiết bị cũng gây dừng. compose không phát ra extended resource nào khác và không phát ra kích thước volume nào, nên nó không kiểm tra cả hai: mọi khóa extended-resource khác vàephemeral.sizeLimitbị bỏ kèm một cảnh báo, còn kích thước persistent không định hình gì trong đầu ra của nó. Xem Compose Provider → Tài nguyên container.
Việc kiểm tra chỉ xét dạng. Liệu một cluster có thể lập lịch cho số lượng đó, hay số lượng đó có phù hợp với thiết bị của nó không, nằm ngoài phạm vi kiểm tra.
services
Một map có thứ tự gồm các điểm phơi bày dịch vụ. Mỗi service khai báo kiểu của nó (ClusterIP, Headless, NodePort, LoadBalancer, Loopback) — tức phạm vi mà các cổng của nó vươn tới — và một map cổng có tên. Tên cổng phải khớp với tên cổng container được khai báo ở nơi khác trong Workload:
services: http: type: ClusterIP ports: web: 8080 # must exist in containers.<name>.portsViệc khai báo nhiều service trên một Workload duy nhất là phổ biến để tách riêng lưu lượng nội bộ và bên ngoài (ClusterIP nội bộ cho các bên tiêu thụ trong cluster, LoadBalancer cho lưu lượng bên ngoài, ClusterIP cho việc thu thập số liệu của Prometheus).
Phạm vi vươn tới của các cổng của một service. type nêu rõ điều đó, và mỗi target hiện thực nó theo cách riêng:
type | Phạm vi | helm | compose |
|---|---|---|---|
ClusterIP | các thành phần ngang hàng của workload, trên mạng riêng của target | một Service kiểu ClusterIP | không publish gì; các thành phần ngang hàng truy cập cổng trên mạng compose |
Headless | như trên, nhưng không có địa chỉ cluster | một Service kiểu ClusterIP với clusterIP: None | không publish gì |
NodePort | ra ngoài mạng riêng của target | một Service kiểu NodePort | mỗi cổng được publish trên mọi giao diện của host, dưới dạng <service port>:<container port> |
LoadBalancer | ra ngoài mạng riêng của target | một Service kiểu LoadBalancer | giống như NodePort |
Loopback | chỉ địa chỉ loopback của chính host | dừng bản build, nêu tên service | mỗi cổng được publish trên địa chỉ loopback IPv4, dưới dạng 127.0.0.1:<service port>:<container port> |
Số của một cổng service và cổng container mà nó nêu tên là hai số khác nhau, giống như port và targetPort của một Kubernetes Service: helm ghi số của mục làm port của Service và nhắm tới cổng container theo tên của nó, còn compose publish số của mục trên host vào số của cổng container. Khi hai số bằng nhau, compose ghi số đó ở cả hai bên.
Loopback dành cho một cổng mà thứ gì đó trên cùng máy truy cập tới — một trình duyệt hoặc một agent chạy trên host — và không thứ gì khác nên truy cập tới. Trên compose, liên kết chỉ dùng địa chỉ loopback IPv4: địa chỉ loopback IPv6 ::1 không được liên kết, vì vậy hãy truy cập cổng qua 127.0.0.1 thay vì qua một tên có thể phân giải thành ::1. Giao thức truyền tải đã khai báo được viết trên mục giống như trên mọi cổng được công bố, như trong 127.0.0.1:5514:5514/udp.
Khi hai mục cùng nêu một cổng, phạm vi rộng hơn sẽ thắng: một cổng mà mục NodePort hoặc LoadBalancer publish sẽ được publish trên mọi giao diện ngay cả khi một mục Loopback cũng nêu nó, bất kể mục nào được khai báo trước.
Trên helm, một mục Loopback dừng quá trình build thay vì được kết xuất thành một thứ không đúng với nó. Một Service của Kubernetes không có loại nào liên kết với địa chỉ loopback của host — việc một Service NodePort lắng nghe trên những địa chỉ node nào là thiết lập của toàn bộ cluster, không phải của một Service riêng lẻ — nên một Service ClusterIP sẽ bỏ mất phạm vi truy cập mà mục yêu cầu, còn một Service NodePort sẽ công bố cổng trên mọi địa chỉ node mà cluster cho phép. Lỗi dừng này nêu tên node và service; xem A service type the helm provider cannot render (Một loại service mà nhà cung cấp helm không thể kết xuất).
Quy ước tên được tổng hợp. Khi helm provider tổng hợp các service của một Workload, metadata.name của mỗi Service được suy ra một cách tất định từ tên mà controller riêng của workload mang và khóa khai báo của service. Với Workload của một component, tên đó là release name của node: <release name>-<service-key>. Release name là danh tính của component được viết theo bảng ký tự mà tên Kubernetes chấp nhận — chính là tên mà một chart được render theo, có thể đọc trong các template của một Recipe dưới dạng {{ .context.rendered_name }} — nên nó bằng instance_id ở mọi nơi danh tính không chứa dấu gạch dưới và chữ hoa. Một Workload khai báo services.http trên node api-server tạo ra một Service tên api-server-http; cùng Workload đó trên node billing tạo ra billing-http, và trên node my_api tạo ra my-zuapi-http. Tên tệp đầu ra cũng theo cùng quy ước: <release name>-<service-key>-service.yaml. Một Recipe publish địa chỉ của một Service như vậy sẽ xây dựng nó từ {{ .context.rendered_name }}, không bao giờ từ {{ .context.instance_id }}, vốn không chỉ đến Service nào ở những nơi hai giá trị khác nhau — xem ../templates/rendered-resource-names.md.
Một Workload do FeatureRecipe của một attachment Feature tổng hợp được đặt tên theo danh tính tổng hợp của chính attachment thay vì theo release name: giá trị mà các tài nguyên của nó mang trong nhãn aggrega.ai/component-id, được ghép từ component chủ và khóa được viết dưới features:, đứng sau tiền tố cfr-- ở đầu. Một release name được suy ra ở đó sẽ là của component chủ, và sẽ đặt tên các tài nguyên của attachment theo tài nguyên riêng của component chủ. Vì vậy, một FeatureRecipe có Workload khai báo services.scrape, cho attachment stats trên node front-door, tạo ra Deployment cfr--front-door--stats và Service cfr--front-door--stats-scrape. Đoạn đầu tiên đó không bao giờ bằng instance_id, và không khóa nào trong ngữ cảnh template của FeatureRecipe mang nó: trên các template của một attachment, {{ .context.rendered_name }} và {{ .context.instance_id }} đều chỉ component chủ (front-door) còn {{ .attachment_name }} chỉ là khóa (stats), nên {{ .context.rendered_name }}-scrape chỉ Service scrape riêng của component chủ ở nơi component chủ khai báo nó, và không bao giờ chỉ Service của attachment — xem ../templates/rendered-resource-names.md. Tệp đầu ra nằm sau tiền tố mà mọi tệp do attachment phát ra đều mang — tên của component chủ và tên của attachment, mỗi tên theo sau bởi -- — nên Service đó được ghi vào front-door--stats--cfr--front-door--stats-scrape-service.yaml.
Quy ước này có hai hệ quả thực tế. Thứ nhất, xung đột giữa các node là không thể xảy ra theo cấu trúc — tiền tố tên phân biệt các service trên mọi node trong boundary, vì hai danh tính khác nhau luôn dẫn tới hai release name khác nhau, danh tính của một attachment mang cả component chủ lẫn khóa của nó, và không tên component nào được bắt đầu bằng cfr-- (build dừng lại với tên như vậy — xem Component identity cannot be stamped on what it emits (Không thể đóng danh tính Component lên những gì nó phát ra)), nên hai Workload, mỗi cái khai báo services.http, tạo ra các tài nguyên K8s Service riêng biệt với tên không trùng nhau. Ngoại lệ duy nhất còn lại là một danh tính attachment quá dài so với đích: nó được rút gọn quanh một digest của toàn bộ, và về nguyên tắc hai danh tính đã rút gọn có thể trùng nhau — xem Nhãn nguồn gốc được phát ra trên đầu ra đã kết xuất. Thứ hai, một Workload không thể khai báo một khóa service hai lần — một map services: nêu một khóa hai lần sẽ bị từ chối khi YAML của Workload được phân tích, và build dừng lại, nêu khóa đó cùng dòng của nó.
Rủi ro xung đột còn lại nằm ở giới hạn độ dài tên K8s: tên Kubernetes Service tối đa 63 ký tự, và dạng tổng hợp <release name>-<service-key> có thể vượt giới hạn đó khi cả hai phần đều dài. Trình biên dịch Aggrega không áp đặt giới hạn này; build phát ra Service, và Kubernetes từ chối nó khi được áp dụng. Tác giả có instance ID lồng sâu (ví dụ data-layer.regional.eu-west.primary) cùng với khóa service dài nên giữ tổng độ dài dưới 63 ký tự. Điều tương tự cũng đúng với Workload của một attachment: một danh tính tổng hợp quá dài so với đích sẽ được rút gọn, nhưng khóa service gắn thêm vào nó thì không, nên một Service của attachment mang khóa dài vẫn có thể vượt 63 ký tự và build mà không bị dừng.
Ghi chú riêng cho Provider (compose). Provider compose tự động suy ra depends_on từ các cạnh uses của IR. Các mục đó được phát ra không có điều kiện chờ — chúng mang ngữ nghĩa service_started bất kể đích có khai báo healthcheck hay không — nên một service có mọi phụ thuộc đều đến từ các cạnh uses sẽ phát ra danh sách dạng ngắn (depends_on: [<target>]). Việc đặt điều kiện cho một mục suy ra từ cạnh dựa trên tình trạng sức khỏe của đích chưa được triển khai. Dạng dài được phát ra ở nơi một mục có mang điều kiện, đó là cách biểu đạt việc chờ một init container; xem providers/compose.md.
Giao thức truyền tải của cổng
Một cổng container được khai báo theo một trong hai dạng tương đương. Số trần là dạng ngắn và không khai báo giao thức truyền tải, nên target áp dụng giá trị mặc định của riêng nó — TCP trên mọi target có giá trị mặc định:
containers: main: image: "{{ .values.image }}" ports: web: 8080Dạng mở rộng mang cả số cổng lẫn giao thức truyền tải, và là dạng một cổng cần khi nó mang bất kỳ giao thức nào khác giá trị mặc định đó:
containers: main: image: "{{ .values.image }}" ports: web: 8080 # short form — no transport declared dns: port: 53 protocol: UDP # TCP | UDP | SCTP sigtran: port: 2905 protocol: SCTPHai dạng có thể được trộn tự do trong cùng một map ports, và một cổng không có giao thức truyền tải cần khai báo thì giữ ở dạng ngắn.
Giao thức truyền tải được khai báo một lần, trên cổng container. Một mục services.<service>.ports nêu tên một cổng container và mang theo giao thức truyền tải của cổng đó, nên một service exposure không thể mâu thuẫn với cổng mà container đã mở. Không có khóa protocol trên cổng của service, và việc khai báo khóa này sẽ bị từ chối.
Vì sao trường này tồn tại. Các target triển khai coi một giao thức truyền tải không được chỉ định là giao thức dạng luồng. Một component cần cổng datagram — media thời gian thực, điện thoại, phân giải tên, mạng riêng, máy chủ game — nếu không có trường này thì chỉ khai báo được số cổng, và stack sẽ được triển khai với mọi cổng kiểm tra đều đạt trong khi không client nào kết nối được, vì lưu lượng là datagram còn cổng được mở thì không. Việc khai báo giao thức truyền tải là điều khiến trường hợp đó có thể biểu đạt được.
Trình biên dịch không diễn giải giá trị này. Nó không suy ra giao thức truyền tải từ tên của cổng và không đối chiếu giao thức đã khai báo với giao thức mà tiến trình phía sau cổng thực sự sử dụng: giá trị là dữ liệu do bạn khai báo và engine của target xuất ra. Một cổng tên dns không có khóa protocol là cổng TCP, và một cổng tên web khai báo protocol: UDP là cổng UDP.
Hành vi theo từng target.
| Target | Cổng không khai báo giao thức truyền tải | Giao thức truyền tải đã khai báo |
|---|---|---|
| helm | containerPort và cổng của Service không mang khóa protocol | được xuất nguyên văn dưới dạng protocol: trên cổng container và trên mọi cổng Service nêu tên nó |
| compose | được publish dưới dạng <host>:<container>, không thay đổi | được publish dưới dạng <host>:<container>/tcp hoặc /udp; SCTP không có cách viết trong compose và dừng quá trình build thay vì publish một cổng mang giao thức truyền tải khác |
Một cổng container không được service nào publish thì hoàn toàn không xuất hiện trong file compose — đó là hành vi vốn có của compose đối với cổng container — nên giao thức truyền tải khai báo trên cổng như vậy không có chỗ nào để ghi vào và không gây dừng build.
Health probe — dạng ý định
Mỗi container khai báo các probe của nó dưới khóa health: riêng (containers.<name>.health), ở dạng ý định trừu tượng; Workload không có health cấp cao nhất. Mỗi provider dịch ý định đó sang dạng probe gốc của nó tại thời điểm tổng hợp.
health: ready: http: /healthz # intent: HTTP GET probe timeoutSeconds: 5 live: tcp: 8080 # intent: TCP socket check timeoutSeconds: 5 startup: exec: ["check-ready.sh"] # intent: command exec timeoutSeconds: 30 periodSeconds: 10Ba dạng ý định (http:, tcp:, exec:) loại trừ lẫn nhau trong một khai báo probe. Việc phân giải cổng cho http: khi không có cổng tường minh sẽ lấy tên cổng đứng đầu theo thứ tự bảng chữ cái mà container khai báo dưới containers.<name>.ports — cùng một quy tắc trên cả hai target, nên một probe đọc cùng một cổng bất kể target nào render nó. Một container không khai báo cổng có tên nào thì không thể mang HTTP probe: bản build dừng lại với một lỗi dịch nêu tên probe vi phạm.
Dịch theo từng provider. Mỗi provider dịch ý định probe trừu tượng sang dạng gốc của nó tại thời điểm tổng hợp:
| Ý định | Helm (K8s) | Compose | Ghi chú về mất mát |
|---|---|---|---|
http: /path | httpGet.path: /path, httpGet.port: <alphabetically-first port name> | CMD-SHELL "curl -f http://localhost:<port>/path" | Compose không có dạng HTTP probe gốc; wrapper CMD-SHELL phụ thuộc vào việc curl có mặt trong image của container. |
tcp: <port> | tcpSocket.port: <port> | CMD-SHELL "nc -z localhost <port>" | Compose không có dạng TCP probe gốc; wrapper CMD-SHELL phụ thuộc vào việc nc có mặt trong image của container. |
exec: [cmd, ...] | exec.command: [cmd, ...] | CMD [cmd, ...] | Ánh xạ một-một; cả hai provider đều mang nguyên văn danh sách lệnh. |
Các wrapper CMD-SHELL của Compose mô phỏng gần đúng HTTP và TCP probe thông qua các vị từ có thể đánh giá bằng shell. Điều compose thiếu là dạng probe gốc, không phải các trường thời gian: periodSeconds, timeoutSeconds, failureThreshold và initialDelaySeconds được khai báo sẽ được chuyển sang healthcheck thành interval, timeout, retries và start_period — mục “Probes” trong providers/compose.md trình bày ánh xạ từng trường. Dạng exec: gốc không cần wrapper nào và được dịch một-một trên cả hai target.
Một probe được bọc sẽ được dịch một cách im lặng: không có gì trong docker-compose.yaml được xuất ra đánh dấu nó, và không có chẩn đoán nào báo cáo việc bọc. Điều mà bản build có báo cáo trên đường đi này là một vị trí probe không đi tới đầu ra nào cả — một service compose chỉ mang một healthcheck, nên khi một Workload khai báo nhiều hơn một trong số ready:, live: và startup: thì chỉ vị trí được ưu tiên được dịch (live trước ready trước startup) và một cảnh báo unsupported-field nêu tên vị trí được dịch và các vị trí bị bỏ.
Lưu ý riêng cho Provider (compose). Việc khai báo một khối health: trên một Workload nhắm tới compose không khiến thứ tự depends_on phụ thuộc vào tình trạng sức khỏe: các mục depends_on của provider compose được suy ra từ các cạnh uses: luôn dùng ngữ nghĩa service_started, bất kể Workload đích có khai báo health probe hay không. Việc ràng buộc các mục đó theo tình trạng sức khỏe của đích chưa được triển khai — dạng dài có thể mang một điều kiện như vậy vẫn được phát ra, cho việc chờ init-container, nên điều còn thiếu là lựa chọn ràng buộc một cạnh theo tình trạng sức khỏe chứ không phải cấu trúc để biểu đạt nó. Xem providers/compose.md để biết đầy đủ các quy tắc suy luận.
Các trường truyền thẳng theo dạng K8s — scheduling, serviceAccount, podSecurityContext
Schema của Workload chấp nhận ba trường cấp cao nhất tùy chọn, tồn tại chủ yếu để đưa các nguyên thể gốc của Kubernetes đi qua helm provider trong khi vẫn giữ nguyên cấu trúc của Aggrega. Compose provider chuyển đổi tập con có tương đương trong Compose và bỏ qua phần còn lại kèm theo một cảnh báo. Aggrega xác thực dạng bên ngoài nhưng không kiểm soát nội dung bên trong (xem Phạm vi xác thực bên dưới) — các giá trị gốc K8s bên trong được truyền nguyên văn vào pod spec do helm kết xuất.
scheduling
scheduling gom bốn nguyên thể lập lịch gốc của K8s — nodeSelector, affinity, tolerations, topologySpreadConstraints — vào một khối được phân theo mục đích. Mỗi trường con có dạng giống hệt trường tương ứng trong pod spec của Kubernetes:
apiVersion: aggrega.ai/v1beta1kind: Workloadscheduling: nodeSelector: disktype: ssd region: us-east-1 tolerations: - key: dedicated operator: Equal value: gpu-workloads effect: NoSchedule affinity: podAntiAffinity: preferredDuringSchedulingIgnoredDuringExecution: - weight: 100 podAffinityTerm: labelSelector: matchLabels: { app: "{{ .context.instance_id }}" } topologyKey: kubernetes.io/hostname topologySpreadConstraints: - maxSkew: 1 topologyKey: topology.kubernetes.io/zone whenUnsatisfiable: ScheduleAnywaycontainers: app: { image: "..." }Bản dịch theo Provider. Provider helm truyền nguyên văn từng trường con vào pod spec được kết xuất. Provider compose không dịch trường nào trong bốn trường: nó bỏ toàn bộ khối scheduling, và một cảnh báo nêu tên khối đó.
serviceAccount
serviceAccount là một chuỗi thuần chứa tên của ServiceAccount mà workload chạy dưới quyền:
apiVersion: aggrega.ai/v1beta1kind: WorkloadserviceAccount: "{{ .context.rendered_name }}-runner"containers: app: { image: "..." }Tên được dựng từ {{ .context.rendered_name }}, tên release mà helm provider dùng để đặt tên cho các tài nguyên riêng của workload, nên đó là tên cluster chấp nhận bất kể component được đặt tên là gì. Trường này tham chiếu tới một ServiceAccount đã tồn tại; nó không tạo ServiceAccount mới. Các tài nguyên RBAC đi kèm (chính đối tượng ServiceAccount, cùng Role / RoleBinding / ClusterRole / ClusterRoleBinding) nên được cung cấp qua một trong hai kênh:
- Recipe
artifacts:— khi RBAC gắn liền với Recipe này (Recipe biết nó cần một Role cụ thể cho một công việc cụ thể). - Features với Resource Generation — khi RBAC mang tính xuyên suốt (một FeatureRecipe Workload-Identity gắn các ServiceAccount liên kết IAM vào mọi component có một nhãn nhất định).
Đặt serviceAccount: mà không sắp xếp để ServiceAccount được nêu tên tồn tại sẽ gây ra lỗi K8s lúc chạy khi apply, không phải lỗi lúc build — việc xác thực schema của workload không đối chiếu sự tồn tại của ServiceAccount (không có quyền truy cập trạng thái cluster lúc biên dịch, theo bất biến AOT-purity).
Compose provider bỏ qua serviceAccount: kèm một cảnh báo; Compose không có khái niệm liên kết danh tính tương đương.
podSecurityContext
podSecurityContext chứa các nguyên thể bảo mật cấp pod — UID, GID, fsGroup, supplementalGroups — áp dụng cho mọi container trong pod:
apiVersion: aggrega.ai/v1beta1kind: WorkloadpodSecurityContext: runAsUser: 1000 runAsGroup: 3000 fsGroup: 2000 supplementalGroups: [4000, 5000]containers: app: { image: "..." }Ngữ nghĩa trường. Cả bốn trường đều là số nguyên (UID/GID dạng số, không phải chuỗi); runAsUser và runAsGroup đặt UID/GID hiệu lực cho các tiến trình của container; fsGroup đặt quyền sở hữu nhóm cho các volume được mount vào pod; supplementalGroups thêm các GID bổ sung vào nhóm tiến trình của mỗi container.
Bản dịch theo Provider. Provider helm truyền nguyên văn khối này vào pod spec được kết xuất. Provider compose không có tương đương cho fsGroup hay supplementalGroups và bỏ từng trường kèm một cảnh báo; runAsUser/runAsGroup được dịch sang dạng user: 1000:3000 của Compose trên mọi service mà Workload tạo ra, kể cả sidecar và init container, còn một runAsGroup không có runAsUser đi kèm thì bị bỏ kèm một cảnh báo. Mỗi container và init container cũng mang một securityContext riêng — runAsUser, runAsGroup, runAsNonRoot, readOnlyRootFilesystem, allowPrivilegeEscalation, và capabilities.add / capabilities.drop. Provider helm phát nó ra trên container; provider compose phát readOnlyRootFilesystem thành read_only, capabilities.add / capabilities.drop thành cap_add / cap_drop, và runAsUser / runAsGroup thành user riêng của container, thay thế cho giá trị của pod; nó bỏ runAsNonRoot, allowPrivilegeEscalation và một runAsGroup được viết mà không có runAsUser, mỗi trường kèm một cảnh báo, và cũng cảnh báo khi runAsUser riêng của một container bỏ ra ngoài runAsGroup của pod. providers/compose.md có ánh xạ chi tiết theo từng trường.
Workload dùng GPU và thiết bị
Một workload cần phần cứng chuyên dụng — một GPU, hoặc một thiết bị khác do nhà cung cấp phần cứng cung cấp — thể hiện hai mối quan tâm độc lập: runtime cấp pod mà node có hỗ trợ thiết bị cung cấp (runtimeClassName), và số lượng thiết bị theo từng container mà workload yêu cầu (một khóa extended-resource dưới resources của một container). Một workload GPU điển hình khai báo cả hai cùng nhau, nhưng mỗi cái đứng độc lập và có thể xuất hiện mà không cần cái kia.
Cả hai trường đều mô tả tài nguyên tính toán — pod và container chạy trên thiết bị — nên chúng thuộc về một workload có chạy container. Một workload chỉ mang một endpoint bên ngoài và không khai báo container nào của riêng nó thì không có pod hay container nào để gắn chúng vào: đặt runtimeClassName trên một workload chỉ có endpoint như vậy sẽ dừng quá trình build, nêu tên runtimeClassName và Recipe có Workload đã khai báo nó, và khi không có container thì không có chỗ nào để đặt yêu cầu tài nguyên thiết bị.
runtimeClassName
runtimeClassName là một chuỗi đơn nêu tên RuntimeClass mà pod chạy dưới đó — container runtime mà một node có hỗ trợ thiết bị cung cấp, ví dụ một runtime GPU tên là nvidia. Đây là bộ chọn cấp pod: nó áp dụng cho mọi container trong workload. Trình biên dịch chuyển tên này qua nguyên văn như một con trỏ tất định; cluster phân giải nó thành một RuntimeClass mà quản trị viên đã cấu hình, vào thời điểm lập lịch. Aggrega không kiểm tra xem có RuntimeClass tương ứng tồn tại hay không — nó không có quyền truy cập trạng thái cluster tại thời điểm biên dịch — nên một tên không có RuntimeClass nào được cấu hình sẽ xuất hiện dưới dạng lỗi lập lịch lúc apply, không phải lỗi lúc build.
Các khóa extended-resource
resources.requests và resources.limits của một container mang các số lượng cpu và memory thông thường và, bên cạnh chúng, các khóa extended-resource: các số lượng thiết bị theo phạm vi nhà cung cấp hoặc miền, được đặt khóa bằng một tên đầy đủ dạng <domain>/<name> như nvidia.com/gpu hoặc amd.com/gpu. Phần miền chứa ít nhất một dấu chấm, và chính dấu chấm đó phân biệt một khóa mở rộng (nvidia.com/gpu) với các số lượng cpu và memory trần. Mỗi giá trị là một số lượng dạng chuỗi ("1", "2") mà trình biên dịch chuyển qua nguyên văn, và helm provider kiểm tra dạng của nó trước khi xuất ra (xem Số lượng tài nguyên); device plugin của cluster phân giải và cấp phát thiết bị vào thời điểm lập lịch.
Ví dụ minh họa — một workload suy luận dùng GPU
apiVersion: aggrega.ai/v1beta1kind: WorkloadruntimeClassName: nvidiacontainers: inference: image: "{{ .values.image }}" resources: requests: cpu: "2" memory: "8Gi" nvidia.com/gpu: "1" limits: nvidia.com/gpu: "1"Workload chọn runtime nvidia cho pod của nó và yêu cầu một GPU cho container inference. Số lượng GPU xuất hiện trong cả requests và limits: một thiết bị không thể cấp phát vượt mức, nên request và limit của nó được đặt cùng một giá trị.
Chuyển đổi của provider. Đây là các khái niệm gốc của Kubernetes. Helm provider xuất runtimeClassName trên pod spec được render và từng khóa extended-resource nguyên văn dưới resources.requests / resources.limits của container, nhờ đó chúng đến được cluster qua đầu ra Kubernetes. Compose provider dành riêng một số lượng nvidia.com/gpu thành chừng ấy GPU NVIDIA trên service của container (xem Compose Provider → Tài nguyên container); một máy chủ đơn lẻ không có khái niệm runtime class và không có tương đương cho bất kỳ khóa extended-resource nào khác, nên một workload khai báo runtimeClassName hoặc một khóa khác sẽ được render trên đích compose mà không có nó.
Chạy trên mạng của node
Theo mặc định, một workload chạy trong một network namespace của riêng nó: các container của nó chỉ thấy các interface của chính chúng, và lưu lượng đến được chúng qua cơ chế chuyển đổi địa chỉ của đích. hostNetwork: true yêu cầu cách bố trí còn lại — workload chạy trong network namespace của chính node, nên nó thấy các interface của node và các cổng mà container của nó mở có thể truy cập được trên chính các địa chỉ của node, không có chuyển đổi nào ở giữa.
Đó là điều mà cả một lớp phần mềm cần. Media thời gian thực, điện thoại, mạng riêng ảo và các loại lưu lượng tương tự mang địa chỉ của peer bên trong payload, nên một địa chỉ bị ghi lại trong lúc truyền sẽ đến nơi và mô tả một chỗ mà peer không thể truy cập; chạy trên các địa chỉ của node là điều giữ cho hai bên nhất quán.
apiVersion: aggrega.ai/v1beta1kind: WorkloadhostNetwork: truecontainers: media: image: "{{ .values.image }}" ports: rtp: port: 7881 protocol: UDPNó khai báo gì, và không khai báo gì
hostNetwork chọn một network namespace, và chỉ có vậy.
- Nó không khai báo cổng nào. Các cổng mà một workload mở vẫn được khai báo dưới
containers.<name>.ports, đúng như khi không có nó, và chúng vẫn mang cùng ý nghĩa. Khai báohostNetworkkhông thêm cổng nào cũng không loại bỏ nhu cầu khai báo cổng. - Nó không khai báo số lượng cổng. Một ứng dụng cần nhiều cổng liên tiếp — chẳng hạn một media server định kích thước một dải cổng theo số bộ xử lý của máy — cấu hình dải đó trong phần thân cấu hình của chính nó, từ các giá trị mà người vận hành cung cấp, giống như cách nó cấu hình mọi thứ khác mà nó đọc lúc khởi động. Đó là một thiết lập của ứng dụng chứ không phải của workload, và hợp đồng workload không phải là nơi chứa nó.
- Không có gì được suy diễn. Trình biên dịch không đọc ý nghĩa nào từ giá trị và không suy ra nó từ bất cứ thứ gì khác: không từ tên của một cổng, không từ kiểu hay nhãn của một component, không từ số lượng cổng được khai báo. Một workload chạy trên mạng của node khi, và chỉ khi, nó nói như vậy.
Vì nó mô tả tài nguyên tính toán, hostNetwork thuộc về một workload có chạy container. Một workload
chỉ mang một endpoint bên ngoài thì không khai báo container nào, nên không có network namespace nào để chọn:
khai báo hostNetwork trên một workload chỉ có endpoint sẽ dừng quá trình build, nêu tên hostNetwork và
Recipe có Workload đã khai báo nó.
Chuyển đổi của Provider
Helm provider xuất hostNetwork: true trên pod spec được render, đó là cách Kubernetes
thể hiện cùng lựa chọn này. Khai báo chỉ đến pod spec và không gì khác — các
Service được xuất ra giống hệt nhau dù có hay không có nó.
Compose provider xuất network_mode: host trên chính service của workload. Một hệ quả
xuất phát từ cách compose mô hình hóa mạng: một service ở chế độ đó không được gắn vào mạng
boundary, vì compose coi việc gắn vào một mạng và việc dùng namespace của máy chủ là
hai lựa chọn thay thế nhau chứ không phải cộng thêm. Do đó các peer của nó truy cập nó trên chính các địa chỉ của máy chủ thay vì
qua tên service — đó chính là ý nghĩa của host networking trên mọi đích — và mọi service khác trên
boundary không bị ảnh hưởng.
Có hai dạng kết hợp với nó trên đích đó. Một sidecar container theo service chính vào
mạng của máy chủ mà không cần khai báo gì, vì nó lấy namespace của service chính bằng cách nêu tên
service đó. Một init container thì không: nó trở thành một service mà service chính chờ
đợi, nên nó tự tham gia mạng boundary thay vì dùng một namespace có thể khiến việc chờ đó
thành vòng lặp. Do đó một workload khai báo cả hostNetwork lẫn initContainers sẽ chạy
service của chính nó trên mạng của node trong khi các init service của nó vẫn ở trên mạng boundary — một
cách bố trí hẹp hơn so với namespace chung duy nhất mà dạng pod mang lại, và là điều compose
provider nêu ra trong một cảnh báo unsupported-field thay vì để bị phát hiện lúc chạy.
Một workload không khai báo hostNetwork không mang khóa đó trong đầu ra của nó: khóa này vắng mặt thay vì được xuất ra dưới dạng false.
Tích hợp attachment với featuresSchema của Component
Khối containers.<name>.attachments của Workload tham chiếu đến các slot thông tin xác thực được khai báo trong featuresSchema của Component — hoặc, với một mục nêu tên một kết nối, đến một slot mà socket của kết nối đó khai báo (xem Cung cấp thông tin xác thực mà một kết nối mang theo); khối này không khai báo slot mới. Xem ../entities/component.md để biết bề mặt soạn thảo featuresSchema. from nêu tên slot; đó không phải là tên của Secret được sinh ra.
Một mục containers.<name>.attachments được kết xuất thành một tham chiếu đến tài nguyên Secret — một secretKeyRef của Kubernetes (với as: env) hoặc một volume dựa trên secret (với as: file) — cả hai đều trỏ đến Secret theo tên. Bộ tổng hợp phân giải tên đó và khóa dữ liệu từ các provides mà slot phơi bày: secretKeyRef.name được kết xuất của mục là .features.<slot>.provides.name của slot và khóa dữ liệu là .features.<slot>.provides.key. Tác giả Recipe chỉ viết from: <slot> và as: env; bộ tổng hợp đọc các provides đã được phân giải — nó không suy ra lại tên. Đây cũng chính là phép đọc .features.<slot>.provides.<key> mà một Recipe nguồn dùng cho một existingSecret: một slot thông tin xác thực duy nhất cung cấp cho cả bên tiêu thụ là Recipe nguồn lẫn bên tiêu thụ là Workload được tổng hợp theo cùng một cách (tính đối xứng nguồn/workload).
Bốn quy tắc xác thực chi phối việc tích hợp:
- Mọi giá trị
attachments.<KEY>.fromphải khớp với một tên slot được khai báo trongfeaturesSchemacủa Component — hoặc, với một mục nêu tên một kết nối, trong socket của kết nối đó. Một tên slot không xác định là lỗi tại thời điểm nạp. - Cơ chế cung cấp
as:(envhoặcfile) phải có mặt trong danh sách cho phépinject:của slot do Component khai báo. Một Workload khai báoas: filecho một slot mà mụcfeaturesSchemachỉ địnhinject: [env]là lỗi tại thời điểm nạp. - Các slot được đánh dấu
inject: [](cung cấp kiểu hộp đen) trongfeaturesSchemacủa Component hoàn toàn không được xuất hiện trong các khốiattachments:của Workload. Các slot đó được cung cấp bởi cơ chế nội bộ của Recipe (chẳng hạn tham sốexistingSecretcủa một Helm chart), chứ không phải qua việc phơi bày ở Workload. - Slot được tham chiếu phải có thể tham chiếu được — phần điền của nó phải công bố một bộ định vị
provides(name,key) cho một tài nguyên Secret, là tài nguyên mà quá trình hiện thực hóa của nó phát ra hoặc đã tồn tại sẵn. Một slot được điền bởi một thông tin xác thực cung cấp qua inject (ghi một giá trị vào đường ống inject và không công bố bộ định vị nào) thì không có gì để trỏ tới; tham chiếu đến nó từ một mụcattachments:của Workload là lỗi tại thời điểm nạp. Một thông tin xác thực cung cấp qua inject đến được container thông qua đường ống inject của slot (một mụcvariablesđọc.context.inject.env.<KEY>), chứ không qua một mụcattachments:.
Ghi chú về provider. Helm kết xuất tham chiếu secretKeyRef/volume secret mô tả ở trên. Provider compose không có primitive gốc để lấy env từ secret; một mục attachment as: env trên một Workload nhắm đến compose được kết xuất thành một mục môi trường với giá trị rỗng kèm một cảnh báo nêu tên mục đó (xem trang provider compose), trong khi quy tắc về khả năng tham chiếu (không phụ thuộc vào năng lực) vẫn được áp dụng.
Ví dụ:
# In the Component catalog entityspec: featuresSchema: db_password: required: true inject: [env, file] # transparent: Workload may dictate delivery root_password: required: true inject: [] # blackbox: Recipe handles internally
# In the Recipe's Workloadworkload: | containers: main: attachments: DB_PASSWORD: # OK — db_password slot allows env inject from: db_password as: env # ROOT_PASSWORD: ... # rejected at load time: blackbox slotCung cấp thông tin xác thực mà một kết nối mang theo
Socket của một Component có thể khai báo, trong usesSchema.<socket>.featuresSchema, các slot mà mỗi kết nối nối qua nó sẽ điền — nhờ đó một component kết nối tới nhiều đích giữ một thông tin xác thực cho mỗi kết nối thay vì một cho tất cả. Một attachment như vậy không nằm trong .features của chính component; nó nằm dưới kết nối của nó, tại .context.uses.<alias>.features.<slot>. Một mục Workload cung cấp nó bằng cách nêu tên kết nối bên cạnh slot:
- trên một mục
attachmentscủa container,connection: <alias>bên cạnhfrom: <slot>; - trên một mục
envFromcủa container,connection: <alias>bên cạnhsecret: <slot>—connectionchỉ được chấp nhận bên cạnhsecret.
Cả hai dạng đều được chấp nhận trên mọi container và mọi init container. <alias> là tên mà kết nối được viết dưới đó trong khối uses của component, trên Aggregate hoặc trên Release — khóa mà một Recipe dùng để đọc kết nối dưới .context.uses — còn <slot> là một slot mà socket mà kết nối đó được nối qua khai báo.
Trước khi bất kỳ quy tắc nào ở trên đọc Workload, mỗi mục nêu tên một kết nối được viết lại thành tên mà attachment do kết nối đó mang trong slot ấy nhận trên component: alias, một dấu chấm, và slot (gpt.credential). Mọi quy tắc sau đó chạy trên mục đã viết lại đúng như khi chạy trên một mục nêu tên một slot của chính Component: danh sách cho phép inject: của slot socket chi phối as:, một slot socket khai báo inject: [] không thể được tham chiếu, attachment điền vào nó phải có thể tham chiếu được, và provider phân giải tên và khóa dữ liệu của Secret từ provides đã phân giải của attachment đó — nhờ vậy mục của mỗi kết nối tham chiếu đến thông tin xác thực của riêng kết nối đó. Một slot socket khai báo sensitive: true được đọc cho mục đúng như khai báo của một slot Component. Mục đã viết lại là thứ provider nhận được; khóa connection không đến được provider.
Ba loại mục bị từ chối, mỗi lần từ chối đều nêu tên thứ mà mục đó đã nêu:
- một mục nêu tên một kết nối mà component không sử dụng — thông báo từ chối nêu tên kết nối, slot, và các kết nối mà component có sử dụng;
- một mục nêu tên một slot mà socket của kết nối không khai báo — thông báo từ chối nêu tên slot, kết nối, socket, và các slot mà socket đó khai báo;
- một mục tự viết tên ghép (
from: gpt.credential). Slot của một kết nối được nêu tên bằng cách nêu tên kết nối, nên tên ghép không bao giờ là cách thứ hai để truy cập nó.
Một kết nối không mang attachment nào trong slot khiến mục không có gì để tham chiếu, và quy tắc về khả năng tham chiếu sẽ từ chối nó. Một Workload do một FeatureRecipe kết xuất bị giới hạn trong các slot mà Feature nó hiện thực khai báo, vốn không chạm tới kết nối nào của component chủ, nên một mục ở đó nêu tên một kết nối sẽ bị từ chối với lý do nêu tên một kết nối mà component không sử dụng.
Ví dụ:
# In the Component catalog entityspec: usesSchema: models: featuresSchema: credential: sensitive: true inject: [env]
# In the Recipe's Workload — the component draws connections `gpt` and `nim`# through the `models` socket, each carrying its own `credential`workload: | containers: main: attachments: MODEL_KEY_GPT: from: credential connection: gpt as: env MODEL_KEY_NIM: from: credential connection: nim as: envTrên helm, MODEL_KEY_GPT được kết xuất thành một secretKeyRef nêu tên Secret mà thông tin xác thực của kết nối gpt đã công bố, và MODEL_KEY_NIM là Secret mà thông tin xác thực của kết nối nim đã công bố. Trên compose, một mục as: env nêu tên một kết nối được phát ra với giá trị rỗng và cùng thông báo hỗ trợ một phần như một mục nêu tên một slot của chính Component.
Bề mặt kiểm tra hợp lệ
Mọi Workload đều được kiểm tra hợp lệ tại thời điểm nạp Recipe, trước khi bất kỳ quá trình kết xuất nào chạy. Việc kiểm tra hợp lệ gồm hai giai đoạn:
- Kiểm tra hợp lệ theo schema. Giá trị Workload được hợp nhất với schema Workload
aggrega.ai/v1beta1được nhúng sẵn. Lỗi mang theo đường dẫn trường và ràng buộc bị vi phạm (ví dụ:.containers.main.health.ready: multiple oneOf branches matched (branches [0, 1] of 3): expected exactly one). Việc kiểm tra hợp lệ theo schema áp đặt mọi kiểu, enum, phạm vi và phép tuyển được khai báo trong schema — bao gồmformcủa controller thuộc tập đóng (một trongstateless,stateful,daemon,scheduled,task,reference),typecủa service thuộc tập đóng (một trongClusterIP,Headless,NodePort,LoadBalancer,Loopback), phạm vi cổng số nguyên (1..65535), phép tuyển dạng probe (đúng một tronghttp,tcp,exec), và phép tuyển biến thể volume (đúng một trongephemeral,configmap,secret,persistent,persistentTemplate). - Kiểm tra hợp lệ tham chiếu chéo. Các tham chiếu attachment của Workload được đối chiếu với
featuresSchemacủa Component — và, với một mục nêu tên một kết nối, với các slot mà socket của kết nối đó khai báo — (tư cách thành viên của slot, danh sách cho phép cách phân phốias:, loại trừ blackbox) và với các provides đã được phân giải của từng slot được tham chiếu (khả năng tham chiếu — phần điền phải công bốname/key). Đây là các kiểm tra xuyên thực thể mà việc kiểm tra hợp lệ chỉ dựa trên schema không thể thực hiện.
Cả hai giai đoạn đều tạo ra cùng một dạng thông báo có tiền tố CATALOG_ERROR; các lỗi dừng quá trình build trước khi bất kỳ đầu ra kết xuất nào được tạo ra. Tác giả Recipe nhận được phản hồi chính xác, chỉ rõ trường bị lỗi và ràng buộc đã từ chối nó.
Các trường truyền thẳng có dạng K8s (scheduling.affinity, scheduling.tolerations, scheduling.topologySpreadConstraints, các danh sách items bên trong volume ConfigMap và Secret, các hook httpGet của lifecycle) chỉ được kiểm tra hợp lệ về mặt cấu trúc — schema của Aggrega ràng buộc sự hiện diện và dạng bên ngoài của chúng, nhưng dạng bên trong của các giá trị do K8s API định nghĩa này thuộc trách nhiệm của provider (provider helm chuyển nguyên văn chúng vào pod spec của K8s; provider compose từ chối hoặc hạ cấp chúng khi thích hợp). Một Workload dùng giá trị affinity sai dạng vẫn vượt qua kiểm tra hợp lệ của Aggrega và thay vào đó, lỗi lộ ra trong quá trình tổng hợp của provider.
Theo cùng cách đó, các lượng tài nguyên là chuỗi đối với schema: không giai đoạn nào kiểm tra dạng của chúng. Provider tổng hợp thực hiện việc này trên Workload đã được đánh giá, và dừng lại khi gặp giá trị nằm ngoài dạng lượng — xem Lượng tài nguyên.
Tài nguyên phụ trợ nằm bên ngoài Workload
Workload chỉ mô tả hình dạng của workload — container, volume, service, số bản sao, lập lịch, ngữ cảnh bảo mật, tài khoản dịch vụ. Nó không có trường additionalResources và không có khai báo ConfigMap / Secret / CRD nội tuyến.
Tác giả Recipe phát ra các tài nguyên phụ trợ qua hai kênh bên ngoài Workload:
artifacts:cấp Recipe — dành cho các tài nguyên gắn liền với Recipe này (một ConfigMap cụ thể mà Workload của Recipe tham chiếu, một lần đăng ký CRD riêng lẻ mà Recipe cần). Trường này là một map gồm các mục có tên; mỗi mục được viết nội tuyến hoặc được tải qua$import:theo từng mục. Xem phần Artifacts Mechanism trong ../../architecture/16-recipe-input-composition.md để biết ba chế độ viết.- Features có Resource Generation — dành cho các mối quan tâm xuyên suốt được gắn qua bộ chọn của Release (một Feature ServiceMonitor gắn vào mọi component có phơi bày metrics, một Feature NetworkPolicy gắn vào mọi workload production). Xem ../entities/featurerecipe.md để biết bề mặt viết FeatureRecipe.
Workload tập trung vào hình dạng của workload; các manifest phụ trợ xuyên suốt và gắn liền với Recipe có nơi viết riêng của chúng.
Các mẫu Workload thường gặp
Schema của Workload rất rộng — nó bao quát các máy chủ HTTP một container, các mẫu sidecar nhiều container, chuỗi init-container, batch job và các dịch vụ có trạng thái với volume bền vững. Ba mẫu lặp lại đủ thường xuyên đến mức việc viết boilerplate từ đầu cho mỗi Recipe là lãng phí. Các khối dưới đây là template sao chép-dán mà tác giả Recipe có thể điều chỉnh cho từng component cụ thể.
Một mẫu được nhiều Recipes dùng chung có thể được xuất bản một lần dưới dạng một mục WorkloadLibrary và được nhập bằng $import: <Library>#/workloads/<entry>; các template ở đây là điểm xuất phát để điều chỉnh, hoặc để xuất bản theo cách đó.
Mẫu 1 — Máy chủ có xuất metrics
Một ứng dụng web điển hình phục vụ lưu lượng ứng dụng trên một cổng và xuất metrics được Prometheus thu thập trên một cổng riêng. Hai service trong Workload — một cho ứng dụng, một cho metrics — giúp chính sách service mesh và cấu hình load balancer tách biệt rõ ràng.
apiVersion: aggrega.ai/v1beta1kind: Workloadreplicas: {{ optional .infra `replicas` 2 }}containers: app: image: "{{ .values.image }}" ports: web: {{ optional .values `port` 8080 }} metrics: {{ optional .values `metrics_port` 9090 }} variables: LOG_LEVEL: "{{ optional .values `log_level` "info" }}" health: ready: http: /healthz timeoutSeconds: 5 live: http: /healthz timeoutSeconds: 5services: http: type: ClusterIP ports: web: {{ optional .values `port` 8080 }} metrics: type: ClusterIP ports: metrics: {{ optional .values `metrics_port` 9090 }}Service metrics thường được gắn annotation để Prometheus phát hiện thông qua một Feature được gắn tại bề mặt Release (ví dụ: feature.aggrega.ai/prometheus-scrape: "true"); bản thân Workload không chứa các annotation thu thập dành riêng cho provider.
Mẫu 2 — Batch job
Một workload chạy đến khi hoàn tất thay vì phục vụ lưu lượng vô thời hạn. Mẫu này đặt form: task, bỏ hoàn toàn services: — batch job không xuất cổng — và dựa vào hình dạng task của provider đích (một Kubernetes Job trên provider helm; provider compose không có hình dạng task và dừng build với form: task). Provider helm cố định restartPolicy của pod hợp lệ cho Job (Never trừ khi container khai báo OnFailure), vì pod của Job không thể dùng giá trị mặc định Always.
apiVersion: aggrega.ai/v1beta1kind: Workloadform: taskcontainers: worker: image: "{{ .values.image }}" command: ["{{ .values.entrypoint }}"] args: - "--config" - "/etc/config/job.yaml" variables: JOB_ID: "{{ .context.instance_id }}-{{ .metadata.release_name }}" volumeMounts: - name: config path: /etc/configvolumes: config: configmap: source: "{{ .context.instance_id }}-config"Volume cấu hình tham chiếu một ConfigMap mà Recipe dự kiến sẽ phát ra cùng với Workload thông qua artifacts: (xem “Tài nguyên phụ trợ thuộc về bên ngoài Workload” ở trên) — bản thân Workload chỉ khai báo phía sử dụng. Identity đặt tên cho nó trên một provider đặt tên workload theo identity, như compose; dưới helm, vốn đặt tên tài nguyên của workload theo tên release, hãy tạo tên của ConfigMap — ở đây và trong artifact — từ {{ .context.rendered_name }} thay vào đó, để đó là một tên mà cluster chấp nhận bất kể component được gọi là gì.
Mẫu 3 — Cặp sidecar
Một pod hai container trong đó container chính xử lý logic ứng dụng và sidecar xử lý một mối quan tâm xuyên suốt (kết thúc TLS, chuyển log, proxy service mesh, AI guardrail). Thứ tự khai báo trong containers: có ý nghĩa quan trọng — provider helm phát ra các container theo thứ tự khai báo; khóa đầu tiên (ở đây là main) là container mặc định cho kubectl logs và các công cụ tương tự.
apiVersion: aggrega.ai/v1beta1kind: Workloadreplicas: {{ optional .infra `replicas` 2 }}containers: main: image: "{{ .values.app_image }}" ports: app: {{ optional .values `app_port` 8080 }} variables: UPSTREAM_URL: "http://localhost:{{ optional .values `app_port` 8080 }}" sidecar: image: "{{ .values.sidecar_image }}" ports: proxy: {{ optional .values `proxy_port` 9000 }} variables: PROXY_TARGET: "http://localhost:{{ optional .values `app_port` 8080 }}"services: external: type: ClusterIP ports: proxy: {{ optional .values `proxy_port` 9000 }}Service xuất cổng của sidecar (không phải của container chính), định tuyến lưu lượng bên ngoài qua sidecar đến container chính thông qua localhost. Hai container dùng chung network namespace của pod, nên localhost:<port> đến trực tiếp container còn lại. Với các sidecar cần chèn thông tin xác thực (mẫu AI-guardrail chuẩn), thông tin xác thực thường nằm trong khối attachments: của sidecar thay vì của container chính — giữ thông tin xác thực trong phạm vi tiến trình của sidecar.
Chọn mẫu
Ba mẫu tương ứng với các mối quan tâm riêng biệt về hình dạng triển khai:
- Máy chủ có metrics — các dịch vụ chạy lâu dài mà cluster duy trì hoạt động; nhiều Service xuất ra để tách biệt lưu lượng.
- Batch job — thực thi có giới hạn; không xuất Service; dựa vào ConfigMap do Recipe phát ra hoặc trạng thái bên ngoài làm đầu vào.
- Cặp sidecar — pod nhiều container dùng chung network namespace; Service của sidecar xuất mối quan tâm xuyên suốt.
Một mẫu thứ tư — máy chủ có trạng thái với volume bền vững — đặt form: stateful và khai báo lưu trữ cho từng replica qua volumes.<name>.persistentTemplate; provider helm phát ra một StatefulSet cho dạng stateful (xem providers/helm.md). Mẫu này có hình dạng giống hệt “máy chủ có metrics” với form: stateful, thêm một volume persistentTemplate, và đúng một service type: Headless để quản lý StatefulSet (quá trình build dừng lại nếu thiếu nó); tác giả cần mẫu này hãy điều chỉnh Mẫu 1 với cả ba khai báo.
Tham chiếu chéo
- ../../architecture/16-recipe-input-composition.md — vai trò kiến trúc của kind Workload và toàn bộ bề mặt schema.
- ../entities/recipe.md — cách
workload:kết hợp với hai kind đầu vào Recipe còn lại. - ../entities/component.md — cách viết
featuresSchemamà các khốiattachments:của Workload tham chiếu đến. - ../entities/featurerecipe.md — các tài nguyên phụ trợ cấp Feature nằm cạnh các Workloads.
- ../vocabulary/data-pillars.md — hợp đồng truy cập pillar cho việc đánh giá template.
- ../templates/expansion-matrix.md — vị trí của việc đánh giá Workload trong ma trận đánh giá template.