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.

Lược đồ Aggrega Workload

Tài liệu tham khảo được sinh tự động. Không chỉnh sửa thủ công — hãy sinh lại từ JSON Schema đã xuất bản.

Id lược đồ: https://aggrega.ai/schemas/workload-v1beta1.schema.json

Đặc tả workload trừu tượng do nền tảng sở hữu. Một Recipe dùng chế độ synthesized khai báo đúng một Workload thông qua từ khóa workload: (block scalar nội tuyến hoặc workload: { $import: } theo bộ từ vựng nhập tệp thống nhất). Provider đích chuyển Workload thành các manifest gốc của provider (K8s Deployment/StatefulSet/Services/PVCs cho helm; các service + volume + network của compose cho compose; v.v.). Một Workload không mang metadata riêng — không có tên, không có nhãn, không có chú thích. Định danh và nhãn đến từ instance của component khai báo nó: provider đích suy ra tên của mỗi tài nguyên được render từ instance đó và gắn vào tài nguyên các khóa nguồn gốc aggrega.ai/* của node đó. Kind Workload KHÔNG phải là một entity của catalog — tệp được công bố này là JSON Schema chuẩn của Workload, và trình biên dịch xác thực một Workload dựa trên nó.

Xem tài liệu tham khảo về soạn thảo Workload để có hướng dẫn bằng văn xuôi về cách soạn các entity Workload; trang này ghi lại lược đồ cấu trúc mà tài liệu tham khảo đó mô tả.

Kiểu cấp cao nhất: object

Thuộc tính

Thuộc tínhLoạiBắt buộcMô tả
apiVersionconst “aggrega.ai/v1beta1”cóHằng số: "aggrega.ai/v1beta1"
kindconst “Workload”cóHằng số: "Workload"
formstring (enum)khôngÝ định trừu tượng về hình dạng controller cho workload. Chọn loại vòng đời runtime mà workload có, độc lập với mọi nền tảng đích: stateless (các bản sao chạy lâu dài, có thể thay thế cho nhau), stateful (các bản sao có danh tính ổn định và lưu trữ riêng cho từng bản sao), daemon (một instance trên mỗi host đủ điều kiện), scheduled (các lần chạy định kỳ, kích hoạt theo thời gian), task (một lần chạy duy nhất đến khi hoàn tất), reference (một endpoint bên ngoài không có tài nguyên tính toán — không có controller; helm phát ra một ExternalName Service, compose chuyển endpoint qua hợp đồng injection). Giá trị rỗng được coi là stateless. Mỗi provider đích ánh xạ form sang hình dạng gốc của riêng nó; bản thân form không mang loại tài nguyên gốc nào của nền tảng. Một volume persistentTemplate đi kèm với stateful và chỉ hợp lệ trên một workload stateful. Một workload reference khai báo endpoint (và tùy chọn port) và không có containers, đồng thời không mang trường credential riêng, vì tên biến môi trường thuộc về bên tiêu thụ chứ không thuộc về endpoint. Một bên tiêu thụ cần credential cho endpoint sẽ khai báo slot trong featuresSchema của chính Component của nó và điền slot đó từ khối attachments của container, nơi danh sách inject của slot đó cho phép cách phân phối. Giá trị cho phép: "stateless", "stateful", "daemon", "scheduled", "task", "reference" Mặc định: "stateless"
endpointstringkhôngEndpoint bên ngoài cho form: reference — một host hoặc URL. Trình biên dịch chuyển tiếp nó dưới dạng một chuỗi con trỏ xác định; nó không bao giờ được phân giải tại thời điểm biên dịch (AOT). Bắt buộc khi form là reference và chỉ có ý nghĩa khi đó. helm phát ra nó làm externalName của một ExternalName Service (phần host); compose chuyển nó đến các bên tiêu thụ qua provides của recipe.
portintegerkhôngPort tùy chọn cho endpoint reference (form: reference). helm phát ra nó làm một port trên ExternalName Service. Tối thiểu: 1. Tối đa: 65535.
schedulestringkhôngLịch cron cho form: scheduled — một biểu thức crontab chuẩn gồm 5 trường (ví dụ ‘0 0 * * *’) hoặc một trong các macro @hourly, @daily, @weekly, @monthly, @yearly. Bắt buộc khi form là scheduled và chỉ có ý nghĩa khi đó; provider đích chuyển nguyên văn nó vào trường schedule của tài nguyên được lập lịch.
suspendbooleankhôngTạm dừng lịch định kỳ của một workload form: scheduled. Khi là true, tài nguyên theo lịch được render với lịch 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 nó được tiếp tục; vẫn có thể tạo một lần chạy từ tài nguyên bằng tay — trên Kubernetes, kubectl create job —from=cronjob/. suspend: false render giống hệt như khi không có suspend. Chỉ có ý nghĩa với form: scheduled. helm phát ra nó dưới dạng spec.suspend của CronJob. compose không có hình dạng theo lịch và dừng trên một workload form: scheduled dù nó có bị tạm dừng hay không. Mặc định: false
replicasintegerkhôngSố lượng bản sao. Mặc định 1. Trên đích compose, giá trị này không đi vào bất kỳ phần nào của đầu ra, và một cảnh báo sẽ báo về nó mỗi khi nó được khai báo — kể cả một giá trị 1 tường minh. Tối thiểu: 0. Mặc định: 1
initContainerscontainer[]khôngDanh sách có thứ tự các container chạy đến khi hoàn tất trước khi các container chính khởi động.
containersmap của containerkhôngMap có thứ tự từ tên container → đặc tả container. Cần ít nhất một mục. Thứ tự do tác giả viết được giữ nguyên. Ít nhất 1 mục.
volumesmap của volumekhôngMap có thứ tự từ tên volume → đặc tả volume. Mỗi đặc tả volume khai báo đúng một trong: ephemeral, configmap, secret, persistent, persistentTemplate.
servicesmap của servicekhôngMap có thứ tự từ tên service → đặc tả service. Trên helm, mỗi mục trở thành một K8s Service riêng, và một mục có type là Loopback sẽ dừng bản dựng. Trên compose không có primitive service riêng, nên các mục không ánh xạ một-một: một mục có type là NodePort hoặc LoadBalancer công bố các port của nó trên mọi giao diện host của chính compose service của workload, một mục có type là Loopback chỉ công bố các port của nó ở đó trên địa chỉ loopback của host, một mục có type là ClusterIP hoặc Headless không công bố gì, và mọi port được công bố đều được gom vào danh sách port của service đó với port host trùng với port container. Trên helm, mỗi Service được đặt tên là <name>-<key>: tên mà Deployment (hoặc controller khác) của chính workload mang, tiếp theo là một dấu gạch nối và khóa của mục, nên một Workload khai báo services.http có Deployment tên là api-server sẽ render một Service tên là api-server-http. Trên compose, một khóa không đặt tên cho thứ gì trong đầu ra.
schedulingobjectkhôngCác ràng buộc lập lịch gốc của K8s. Được chuyển đổi trực tiếp cho helm. Trên đích compose, các ràng buộc này không đi vào bất kỳ phần nào của đầu ra, và một cảnh báo sẽ báo về khối này khi nó được khai báo.
podSecurityContextobjectkhông
serviceAccountstringkhôngTên của ServiceAccount mà workload này chạy dưới đó. RBAC thực tế (các tài nguyên ServiceAccount/Role/RoleBinding) nên được phát ra qua Features hoặc artifacts, không qua trường này.
imagePullSecretsstring[]khôngTên các Secret image-pull để kéo image từ registry riêng. helm phát ra pod.imagePullSecrets. compose không có tương đương trong tệp — xác thực registry được cấu hình bên ngoài qua docker login — và bỏ qua nó.
priorityClassNamestringkhôngTên của PriorityClass quy định độ ưu tiên lập lịch của workload này. helm phát ra pod.priorityClassName. compose không có tương đương về độ ưu tiên lập lịch trên một host và bỏ qua nó.
runtimeClassNamestringkhôngTên của RuntimeClass chọn container runtime mà workload này chạy dưới đó (ví dụ một runtime hỗ trợ GPU như ‘nvidia’). Trình biên dịch chuyển nguyên văn tên này; cluster phân giải nó thành một RuntimeClass đã cấu hình tại thời điểm lập lịch. helm phát ra pod.runtimeClassName. compose không có tương đương runtime-class và bỏ qua nó. Chỉ dành cho tính toán: không được phép trên một workload reference.
terminationGracePeriodSecondsintegerkhôngSố giây giữa SIGTERM và SIGKILL khi tắt. helm phát ra pod.terminationGracePeriodSeconds; compose phát ra stop_grace_period. Tối thiểu: 0.
dnsPolicystring (enum)khôngChính sách DNS của pod. helm phát ra pod.dnsPolicy. compose không có tương đương DNS-policy và bỏ qua nó (thay vào đó compose ánh xạ trực tiếp nameservers/searches của dnsConfig). Giá trị cho phép: "Default", "ClusterFirst", "ClusterFirstWithHostNet", "None"
dnsConfigobjectkhôngCấu hình DNS tùy chỉnh của pod. helm phát ra pod.dnsConfig. compose ánh xạ nameservers sang dns và searches sang dns_search; options không có tương đương trong compose và bị bỏ qua ở đó.
hostAliasesobject[]khôngCác ánh xạ tĩnh từ hostname sang IP được chèn vào tệp hosts của pod. helm phát ra pod.hostAliases; compose phát ra extra_hosts (một mục hostname:ip cho mỗi hostname).
hostNetworkbooleankhôngChạy workload trong network namespace của chính node host thay vì một namespace cô lập. Khi đó các port mà workload mở có thể truy cập được trên các địa chỉ của chính node, và workload thấy các giao diện mạng của node. Thiết lập này chỉ chọn một network namespace và không gì khác: nó không khai báo port nào, và mọi port mà workload mở vẫn được khai báo dưới containers..ports. helm phát ra pod.hostNetwork. compose phát ra network_mode: host trên service của chính workload; một compose service ở chế độ đó không được gắn vào mạng biên, nên các peer của nó truy cập nó qua địa chỉ của node thay vì qua tên service, và service của mỗi init container tự tham gia mạng biên.

Không cho phép thuộc tính bổ sung.

workload.scheduling

Các ràng buộc lập lịch gốc của K8s. Được chuyển đổi trực tiếp cho helm. Trên đích compose, các ràng buộc này không đi vào bất kỳ phần nào của đầu ra, và một cảnh báo sẽ báo về khối này khi nó được khai báo.

Thuộc tínhLoạiBắt buộcMô tả
nodeSelectormap của stringkhông
affinityobjectkhông
tolerationsobject[]không
topologySpreadConstraintsobject[]không

Không cho phép thuộc tính bổ sung.

workload.podSecurityContext

Thuộc tínhLoạiBắt buộcMô tả
runAsUserintegerkhông
runAsGroupintegerkhông
fsGroupintegerkhông
supplementalGroupsinteger[]không

Không cho phép thuộc tính bổ sung.

workload.dnsConfig

Cấu hình DNS tùy chỉnh của pod. helm phát ra pod.dnsConfig. compose ánh xạ nameservers sang dns và searches sang dns_search; options không có tương đương trong compose và bị bỏ qua ở đó.

Thuộc tínhLoạiBắt buộcMô tả
nameserversstring[]không
searchesstring[]không
optionsobject[]không

Không cho phép thuộc tính bổ sung.

workload.hostAliases[]

Thuộc tínhLoạiBắt buộcMô tả
ipstringcó
hostnamesstring[]có

Không cho phép thuộc tính bổ sung.

Định nghĩa

container

Thuộc tínhLoạiBắt buộcMô tả
namestringkhôngTên container tùy chọn. Với một mục initContainers theo vị trí, trường này đặt tên container được sinh ra; khi bỏ qua, tên sẽ là init- được tạo tự động (vị trí của mục trong danh sách). Với một mục của map containers, khóa của map là tên container và trường này bị bỏ qua.
imagestringcóTham chiếu image của container (ví dụ: ‘nginx:1.27-alpine’, ‘ghcr.io/example/app:v1.2.3’).
imagePullPolicystring (enum)khôngChính sách pull image. helm sinh ra nó dưới dạng container.imagePullPolicy. compose ánh xạ nó sang pull_policy của service (Always thành always, Never thành never, IfNotPresent thành if_not_present). Giá trị cho phép: "Always", "Never", "IfNotPresent"
commandstring[]khôngGhi đè entrypoint của image. K8s: .command. Compose: entrypoint.
argsstring[]khôngCác đối số truyền cho command (hoặc cho entrypoint của image nếu không có command). K8s: .args. Compose: command.
variablesmap của stringkhôngCác biến môi trường dưới dạng cặp khóa-giá trị kiểu string. K8s: spec.template.spec.containers[].env[]. Compose: services..environment.
attachmentsmap của containerAttachmentkhôngMap có thứ tự từ tên env hoặc tên file → { from, as, key?, path?, connection? }. Mỗi mục tham chiếu một slot được khai báo trong featuresSchema của Component — hoặc, khi mục nêu tên một connection, một slot mà socket của connection đó khai báo — và chuyển giao những gì attachment lấp slot đó đã công bố. Trường ‘as’ chọn cơ chế chuyển giao, cơ chế này phải nằm trong danh sách cho phép của mảng inject: của slot. Các slot blackbox (inject: []) KHÔNG ĐƯỢC xuất hiện ở đây.
envFromobject[]khôngTập biến môi trường được nhập hàng loạt từ một nguồn ConfigMap hoặc Secret. helm sinh ra container.envFrom (configMapRef/secretRef). compose không có primitive env-from-object — một tham chiếu nguồn không phải là file trên host, nên diễn giải lại thành env_file sẽ âm thầm thay đổi ý nghĩa; một workload khai báo envFrom sẽ dừng hẳn với thông báo rõ ràng trên target compose.
portsmap của integer hoặc objectkhôngCác cổng container có tên. Một cổng được viết hoặc dưới dạng số cổng trần (web: 8080) hoặc dưới dạng object mang số cổng cùng giao thức truyền tải mà cổng đó mang (dns: { port: 53, protocol: UDP }); khi không khai báo giao thức, hai dạng có cùng ý nghĩa. Các giá trị giao thức cho phép là TCP, UDP và SCTP, và khi bỏ qua khóa này thì giá trị mặc định của chính target vẫn được áp dụng. Tên cổng được tham chiếu bởi services.*.ports và bởi việc phân giải cổng của một probe http, và một cổng service lấy giao thức truyền tải từ cổng container mà tên của nó phân giải tới, nên giao thức truyền tải chỉ được khai báo một lần. K8s: containerPort, chỉ mang protocol khi có khai báo. Compose: một cổng container chỉ xuất hiện trong đầu ra khi một service spec công bố nó; bản thân cổng container không có trường compose riêng, và một cổng được công bố mang giao thức truyền tải đã khai báo dưới dạng hậu tố /protocol trên mục được công bố — một giao thức truyền tải mà compose không biểu diễn được sẽ dừng bản build thay vì công bố một cổng mang giao thức khác.
resourcesobjectkhông
healthobjectkhôngCác probe sức khỏe của container — ready, live và startup — mỗi probe được khai báo dưới dạng http, tcp hoặc exec. Được chuyển thành httpGet/tcpSocket/exec của K8s cho helm. Với compose, một service chỉ mang một healthcheck duy nhất: http và tcp trở thành các test CMD-SHELL, exec trở thành một test CMD, và khi khai báo nhiều hơn một probe thì chỉ một probe được giữ lại — một cảnh báo nêu tên probe được chuyển đổi và các probe bị loại bỏ.
volumeMountsobject[]không
restartPolicystring (enum)khôngGiá trị cho phép: "Always", "OnFailure", "Never"
lifecycleobjectkhôngCác lifecycle hook của container. Được chuyển thành container.lifecycle (postStart/preStop) của K8s cho helm. compose không có primitive lifecycle-hook; một workload khai báo lifecycle sẽ dừng hẳn với thông báo rõ ràng trên target compose thay vì âm thầm loại bỏ hook.
securityContextobjectkhông

Không cho phép thuộc tính bổ sung.

container.envFrom[]

Thuộc tínhLoạiBắt buộcMô tả
configMapstringkhôngTên của một nguồn ConfigMap được sinh ra bởi đầu vào artifacts của Recipe này hoặc bởi một Feature được gắn kèm.
secretstringkhôngTên của một slot featuresSchema — của chính Component, hoặc, khi connection được đặt, một slot mà socket của connection đó khai báo; tên của Secret được nhập được phân giải từ provides của slot.
connectionstringkhôngBí danh của một connection mà component sử dụng — tên mà nó được viết dưới đó trong khối uses của component, trên Aggregate hoặc Release. Khi được đặt, secret nêu tên một slot mà socket mà connection đó được nối qua khai báo, và Secret được nhập là Secret mà attachment do connection đó mang trong slot đó đã công bố, nên một component kết nối tới nhiều target sẽ nhập Secret riêng của từng target. Chỉ có ý nghĩa khi đi cùng secret. Một connection mà component không sử dụng, hoặc một slot mà socket của nó không khai báo, sẽ bị từ chối kèm tên của cả hai.
prefixstringkhôngTiền tố tùy chọn được thêm vào trước tên của mọi biến môi trường được nhập.

Không cho phép thuộc tính bổ sung.

container.resources

Thuộc tínhLoạiBắt buộcMô tả
requestsresourceListkhông
limitsresourceListkhông

Không cho phép thuộc tính bổ sung.

container.health

Các probe sức khỏe của container — ready, live và startup — mỗi probe được khai báo dưới dạng http, tcp hoặc exec. Được chuyển thành httpGet/tcpSocket/exec của K8s cho helm. Với compose, một service chỉ mang một healthcheck duy nhất: http và tcp trở thành các test CMD-SHELL, exec trở thành một test CMD, và khi khai báo nhiều hơn một probe thì chỉ một probe được giữ lại — một cảnh báo nêu tên probe được chuyển đổi và các probe bị loại bỏ.

Thuộc tínhLoạiBắt buộcMô tả
readyprobekhông
liveprobekhông
startupprobekhông

Không cho phép thuộc tính bổ sung.

container.volumeMounts[]

Thuộc tínhLoạiBắt buộcMô tả
namestringcóPhải khớp với một khóa trong map volumes: ở cấp cao nhất.
pathstringcóĐiểm mount bên trong container.
subPathstringkhôngMount một file hoặc thư mục con duy nhất từ volume tại path, mà không che khuất các file khác trong thư mục đích.
readonlybooleankhôngMặc định: false

Không cho phép thuộc tính bổ sung.

container.lifecycle

Các lifecycle hook của container. Được chuyển thành container.lifecycle (postStart/preStop) của K8s cho helm. compose không có primitive lifecycle-hook; một workload khai báo lifecycle sẽ dừng hẳn với thông báo rõ ràng trên target compose thay vì âm thầm loại bỏ hook.

Thuộc tínhLoạiBắt buộcMô tả
postStartlifecycleHookkhông
preStoplifecycleHookkhông

Không cho phép thuộc tính bổ sung.

container.securityContext

Thuộc tínhLoạiBắt buộcMô tả
runAsUserintegerkhông
runAsGroupintegerkhông
runAsNonRootbooleankhông
readOnlyRootFilesystembooleankhông
allowPrivilegeEscalationbooleankhông
capabilitiesobjectkhông

Không cho phép thuộc tính bổ sung.

container.securityContext.capabilities
Thuộc tínhLoạiBắt buộcMô tả
addstring[]không
dropstring[]không

Không cho phép thuộc tính bổ sung.

containerAttachment

Thuộc tínhLoạiBắt buộcMô tả
fromstringcóTên của một slot được khai báo trong featuresSchema của Component — hoặc, khi connection được đặt, của một slot mà socket mà connection đó được nối qua khai báo.
connectionstringkhôngBí danh của một connection mà component sử dụng — tên mà nó được viết dưới đó trong khối uses của component, trên Aggregate hoặc Release. Khi được đặt, from nêu tên một slot mà socket mà connection đó được nối qua khai báo (usesSchema..featuresSchema), và mục này chuyển giao những gì attachment do connection đó mang trong slot đó đã công bố, nên một component kết nối tới nhiều target sẽ xuất trình cho mỗi target thông tin xác thực riêng của nó. Danh sách cho phép inject: của slot chi phối as, đúng như đối với một slot mà Component khai báo. Một connection mà component không sử dụng, hoặc một slot mà socket của nó không khai báo, sẽ bị từ chối kèm tên của cả hai.
asstring (enum)cóCơ chế chuyển giao. Phải nằm trong danh sách cho phép của mảng inject: của slot. Giá trị cho phép: "env", "file"
keystringkhôngVới as: env, khóa dữ liệu cụ thể trong secret của slot được tham chiếu mà mục này đọc. Hãy đặt nó khi secret của slot mang nhiều khóa dữ liệu, để mục này chọn một trong số đó theo tên; hai mục có thể tham chiếu cùng một slot với các khóa khác nhau để đọc nhiều khóa từ một secret. Khi bỏ qua, mục này đọc khóa duy nhất được công bố của slot. Bị bỏ qua với as: file, vốn mount toàn bộ secret.
pathstringkhôngĐường dẫn file bên trong container (bắt buộc khi as: file).

Không cho phép thuộc tính bổ sung.

resourceList

Thuộc tínhLoạiBắt buộcMô tả
cpustringkhôngLượng CPU (ví dụ: ‘100m’, ‘0.5’, ‘2’). helm xuất nguyên văn dưới resources.{requests,limits}.cpu. compose ánh xạ nó sang deploy.resources.{reservations,limits}.cpus dưới dạng số lõi thập phân — một lượng millicpu được chuyển đổi (500m thành 0.5); một lượng lõi thuần được giữ nguyên. Một lượng mà compose không thể chuyển đổi sẽ dừng rõ ràng thay vì xuất một giá trị sai.
memorystringkhôngLượng bộ nhớ (ví dụ: ‘128Mi’, ‘1Gi’). helm xuất nguyên văn dưới resources.{requests,limits}.memory. compose ánh xạ nó sang deploy.resources.{reservations,limits}.memory dưới dạng số byte chính xác. Một lượng tương ứng với số byte nguyên được chuyển đổi chính xác (1.5Gi thành 1610612736); một lượng không như vậy, hoặc không phải là một lượng, sẽ dừng rõ ràng thay vì làm tròn.

Khóa bổ sung: Một lượng tài nguyên mở rộng (theo phạm vi nhà cung cấp/miền), được đặt khóa bằng một tên đầy đủ dạng ’/’ (ví dụ ‘nvidia.com/gpu’: ‘1’, ‘amd.com/gpu’: ‘2’). Phân đoạn miền chứa ít nhất một dấu chấm, điều này phân biệt khóa mở rộng với các lượng cpu/memory trần. Trình biên dịch chuyển nguyên văn lượng này; device plugin của cluster phân giải và cấp phát nó lúc lập lịch. helm xuất nó dưới resources.{requests,limits}.. compose dành trước một số lượng ‘nvidia.com/gpu’ dưới dạng một reservation thiết bị NVIDIA trên service của container — số lượng của limit nếu có viết limit, nếu không thì của request, và không có reservation nào cho số lượng 0 — và dừng khi số lượng không phải là số nguyên thiết bị, hoặc khi request và limit yêu cầu số lượng khác nhau. compose không có tương đương cho bất kỳ khóa mở rộng nào khác và bỏ qua nó, cảnh báo một lần cho mỗi khóa mở rộng riêng biệt và nêu tên khóa đó, để việc bỏ qua được báo cáo thay vì diễn ra âm thầm. Mẫu: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)+/[A-Za-z0-9]([-A-Za-z0-9_.]*[A-Za-z0-9])?$.

Không cho phép bất kỳ thuộc tính nào khác.

probe

Thuộc tínhLoạiBắt buộcMô tả
httpstringkhôngProbe HTTP GET: đường dẫn được thăm dò trên cổng container có tên đứng đầu theo thứ tự chữ cái.
tcpintegerkhôngProbe TCP socket trên số cổng container đã cho. Tối thiểu: 1. Tối đa: 65535.
execstring[]khôngProbe exec — lệnh chạy bên trong container. Ít nhất 1 mục.
timeoutSecondsintegerkhôngTối thiểu: 1.
initialDelaySecondsintegerkhôngTối thiểu: 0.
periodSecondsintegerkhôngTối thiểu: 1.
failureThresholdintegerkhôngTối thiểu: 1.
successThresholdintegerkhôngTối thiểu: 1.

Không cho phép thuộc tính bổ sung.

lifecycleHook

Thuộc tínhLoạiBắt buộcMô tả
execstring[]khôngÍt nhất 1 mục.
httpGetobjectkhôngCấu trúc httpGet gốc của K8s (path, port, scheme, host, httpHeaders). Được chuyển thẳng cho helm. Trên đích compose, một workload khai báo lifecycle hook sẽ dừng, vì compose không có nguyên thể lifecycle-hook — hook không bao giờ bị bỏ qua âm thầm.

Không cho phép thuộc tính bổ sung.

volume

Thuộc tínhLoạiBắt buộcMô tả
ephemeralobjectkhông
configmapobjectkhông
secretobjectkhông
persistentobjectkhông
persistentTemplateobjectkhôngMẫu claim cho từng replica. Yêu cầu form: stateful, vì chỉ cấu trúc stateful mới cho mỗi replica danh tính ổn định mà một claim theo replica cần. Trên Kubernetes nó trở thành StatefulSet.volumeClaimTemplates. Trên đích compose nó bị hạ cấp thành một named volume duy nhất dùng chung cho mọi replica, và một cảnh báo báo cáo việc hạ cấp này.

Không cho phép thuộc tính bổ sung.

volume.ephemeral

Thuộc tínhLoạiBắt buộcMô tả
sizeLimitstringkhôngLượng K8s (ví dụ: ‘1Gi’). K8s: emptyDir.sizeLimit. Compose: volume trở thành một mục tmpfs không mang kích thước, nên giá trị này không xuất hiện ở đâu trong đầu ra — một cảnh báo báo cáo điều đó khi giá trị được khai báo.

Không cho phép thuộc tính bổ sung.

volume.configmap

Thuộc tínhLoạiBắt buộcMô tả
sourcestringcóTên của ConfigMap, được Recipe này xuất qua artifacts: hoặc bởi một Feature được gắn; một ConfigMap do Recipe khác xuất không được tham chiếu ở đây.
itemsobject[]khôngLựa chọn ánh xạ khóa sang đường dẫn, tùy chọn.

Không cho phép thuộc tính bổ sung.

volume.secret

Thuộc tínhLoạiBắt buộcMô tả
sourcestringcó
itemsobject[]không

Không cho phép thuộc tính bổ sung.

volume.persistent

Thuộc tínhLoạiBắt buộcMô tả
sizestringcóLượng K8s (ví dụ: ‘10Gi’).
classstringkhôngStorageClassName. Tùy chọn.
accessModesstring (enum)[]khôngCác chế độ truy cập PVC. helm xuất spec.accessModes, mặc định là [ReadWriteOnce] khi bỏ qua. Volume của compose không có khái niệm chế độ truy cập và bỏ qua nó. Giá trị cho phép của mỗi mục: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Không cho phép thuộc tính bổ sung.

volume.persistentTemplate

Mẫu claim cho từng replica. Yêu cầu form: stateful, vì chỉ cấu trúc stateful mới cho mỗi replica danh tính ổn định mà một claim theo replica cần. Trên Kubernetes nó trở thành StatefulSet.volumeClaimTemplates. Trên đích compose nó bị hạ cấp thành một named volume duy nhất dùng chung cho mọi replica, và một cảnh báo báo cáo việc hạ cấp này.

Thuộc tínhLoạiBắt buộcMô tả
sizestringcó
classstringkhông
accessModesstring (enum)[]khôngCác chế độ truy cập PVC cho mẫu claim theo từng replica. helm xuất spec.accessModes, mặc định là [ReadWriteOnce] khi bỏ qua. compose không có khái niệm chế độ truy cập và bỏ qua nó. Giá trị cho phép của mỗi mục: "ReadWriteOnce", "ReadOnlyMany", "ReadWriteMany", "ReadWriteOncePod".

Không cho phép thuộc tính bổ sung.

service

Thuộc tínhLoạiBắt buộcMô tả
typestring (enum)cóLoại service: phạm vi tiếp cận của các cổng trong mục. ClusterIP giữ chúng trên mạng riêng của đích, có thể truy cập từ các workload ngang hàng; Headless cũng vậy, và trên helm hiển thị một K8s Service với clusterIP: None; NodePort và LoadBalancer công bố chúng ra ngoài mạng đó; Loopback chỉ công bố chúng trên địa chỉ loopback của chính host, có thể truy cập từ máy mà workload chạy trên đó và không từ nơi nào khác. helm hiển thị ClusterIP, NodePort và LoadBalancer thành loại K8s Service cùng tên, và từ chối một mục Loopback kèm tên, vì K8s Service không có loại nào gắn với địa chỉ loopback của host. compose không công bố gì cho ClusterIP và Headless, công bố các cổng NodePort và LoadBalancer trên mọi giao diện của host dưới dạng host:container, và công bố các cổng Loopback trên địa chỉ loopback IPv4 dưới dạng 127.0.0.1:host:container; một cổng cũng được một mục NodePort hoặc LoadBalancer công bố sẽ được công bố trên mọi giao diện. Giá trị cho phép: "ClusterIP", "NodePort", "LoadBalancer", "Headless", "Loopback"
portsmap của integercóMap từ tên cổng service → số cổng container. Tên cổng phải khớp với các khóa trong containers..ports. Một cổng service không mang giao thức truyền tải riêng: nó lấy giao thức của cổng container mà tên của nó phân giải tới, nên giao thức của một cổng được khai báo một lần, trên cổng container, và việc phơi bày service không thể mâu thuẫn với những gì container đã mở.

Không cho phép thuộc tính bổ sung.