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.

Schema của Render Socket cho Aggrega Wasm Provider

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 của schema: https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json

Các dạng dữ liệu truyền tải mà socket của plugin render Provider tiêu thụ và phát ra. Một guest Provider render một nút IR thành các tệp đầu ra trên export render_node của nó (RenderNodeInput sang RenderNodeOutput), và tùy chọn hợp nhất các đầu ra theo từng nút tại một ranh giới thành một artifact được lắp ráp duy nhất trên export assemble_boundary của nó (AssembleBoundaryInput sang AssembleBoundaryOutput). AssembleBoundaryOutput mang các tệp đã lắp ráp và mọi chẩn đoán; vị trí các tệp của từng bên đóng góp được khai báo một lần trên hợp đồng describe() của guest chứ không phải trên phản hồi này. Một guest cũng có thể khai báo một export validate_node_input tùy chọn, kiểm tra về mặt cấu trúc đầu vào đã được phân giải của một nút trước khi điều phối render: nó tiêu thụ cùng phép chiếu RenderNodeInput mà render_node nhận và trả về một ValidateNodeOutput chỉ mang các chẩn đoán — một chẩn đoán mức halt dừng bản build một cách rõ ràng, một chẩn đoán mức warn được hiển thị trong kết quả build. Một guest có target giới hạn hoặc hạn chế các tên mà nó chấp nhận cũng có thể khai báo một export name_bound tùy chọn, mà host hỏi trước khi xác định danh tính component của một nút: nó tiêu thụ một NameBoundInput mang một tên được đề xuất và trả về một NameBoundOutput mang một phán định cho mỗi loại tên mà guest sẽ dẫn xuất từ tên đó. Một phán định mang một ràng buộc — dùng được, hoặc bị giới hạn ở độ dài ngắn hơn — và không bao giờ là một tên do guest tạo ra, nhờ vậy kiến thức về những gì target chấp nhận vẫn nằm trong guest. Riêng biệt, một guest có target tự dẫn xuất tên riêng cho các tài nguyên mà nó render — từ nguồn do tác giả cung cấp, hoặc từ một workload mà nó tổng hợp — có thể khai báo một export rendered_name tùy chọn, mà host hỏi để tác giả Recipe có thể đọc tên đó và công bố một địa chỉ được xây dựng từ nó: nó tiêu thụ một RenderedNameInput mang các danh tính mà target dẫn xuất từ đó và các loại đầu vào mà Recipe của nút khai báo, và trả về một RenderedNameOutput mang tên mà chính guest sẽ render theo, hoặc không có tên nào nếu nó không dẫn xuất tên nào. Hai export này là hai chiều ngược nhau của cùng một chủ đề và không cái nào thay thế cho cái nào — name_bound yêu cầu guest đánh giá một tên do host đề xuất, trong khi rendered_name báo cáo một tên do guest tạo ra, mà host mang theo mà không đọc. Một guest cũng có thể khai báo carve và reassemble, vốn cắt đầu ra của chính nó thành các đơn vị có thể định địa chỉ cho một bước pipeline và ghép các đơn vị đã được patch trở lại, cùng link_publish và link_resolve, vốn nối một cạnh uses có hai đầu được lắp ráp vào các nhóm điều phối khác nhau. Dạng của mỗi payload là định nghĩa mà export của nó nêu tên: bảng x-aggrega-exports ánh xạ mọi export mà host dùng để gọi một guest — bao gồm cả carve và reassemble — tới định nghĩa đầu vào và định nghĩa đầu ra của nó, mỗi định nghĩa dưới dạng một JSON Pointer trỏ vào $defs của tài liệu này, nên một công cụ xác thực payload sẽ tra cứu định nghĩa của nó ở đó. Gốc tài liệu không khai báo dạng nào của riêng nó, vì một tài liệu có thể là payload hợp lệ của nhiều export (một đối tượng rỗng là câu trả lời hợp lệ từ validate_node_input, name_bound và rendered_name như nhau). Guest trả về các byte đã tuần tự hóa của từng tệp đầu ra; host ghi chúng nguyên văn và không chạy bộ tuần tự hóa nào, vì vậy tính tất định là trách nhiệm của guest: đầu vào giống hệt nhau phải tạo ra các byte giống hệt nhau. Các kiểu payload Go, Rust và TypeScript được sinh từ schema này vào các gói plugin-ABI, nên ba ngôn ngữ đọc và ghi cùng một dạng dữ liệu truyền tải; một guest nhập chúng từ các gói đó, hoặc thông qua bộ kit plugin của nó nếu bộ kit tái xuất chúng.

Các export

Bảng x-aggrega-exports của schema ánh xạ mỗi export mà host dùng để gọi một guest tới định nghĩa đầu vào và định nghĩa đầu ra của nó. Dạng của một payload là định nghĩa mà export của nó nêu tên.

ExportĐầu vàoĐầu ra
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

Định nghĩa

RenderNodeInput

Payload mà một guest Provider nhận được trên export render_node của nó: phép chiếu IR theo từng node mà guest render, ngữ cảnh lúc render, các đầu vào đã được đánh giá trước mà Recipe gắn với node khai báo — một danh sách nguồn đã thu nhận, một workload, một tập artifact — mỗi thứ chỉ có mặt khi Recipe đó khai báo nó, và các mục chỉ định những đơn vị được render mà guest bỏ ra khỏi một lần render nguồn.

Thuộc tínhLoạiBắt buộcMô tả
nodeIRNodeProjectioncóDữ liệu IR theo từng node mà một guest Provider render — một phép chiếu có giới hạn của node IR đầy đủ, mang danh tính theo từng node và nguồn gốc mà guest đóng dấu lên mọi manifest được phát ra: id, type, recipe đã phân giải, values, việc một ánh xạ values có tạo ra các values đó hay không, các feature attachment, đánh dấu tính nhạy cảm trên các khóa đã render và trên toàn bộ values, các cạnh uses đi ra, đường dẫn boundary, sync wave, danh tính Recipe, ghi đè component-id, cơ sở tên dẫn xuất, và nguồn gốc bản build. Danh tính và cơ sở tên dẫn xuất là hai trường mang riêng vì chúng trả lời hai câu hỏi — một tài nguyên thuộc về cái gì, và nguồn của chính tác giả được render dựa trên cái gì — và một Feature attachment cung cấp nguồn do tác giả của nó viết là nơi hai câu trả lời khác nhau. Nội dung tệp nguồn không được mang ở đây; nó được truyền riêng trong phép chiếu nguồn. Mọi tập khóa ở đây có thứ tự cố định — features và uses theo thứ tự của tác giả, values và đánh dấu tính nhạy cảm theo thứ tự khóa đã sắp xếp — để payload truyền đi giống hệt nhau từng byte giữa các lần chạy với cùng đầu vào.
contextobjectcóNgữ cảnh thời điểm render mà host trao cho guest, được mang dưới dạng các byte của tài liệu JSON của nó; schema này không khai báo đối tượng đó. Đó là ngữ cảnh mà một bước pipeline của cùng node nhận, cộng thêm độ rộng thụt lề: parameters, các giá trị tham số của Release được sắp xếp theo tên, vắng mặt khi không có; annotations, các annotation của node được chia theo nơi mỗi annotation được viết thành aggregate, release và catalog, mỗi phần vắng mặt khi rỗng; boundary, ranh giới chứa node: name, path (các đoạn của nó), sync_wave (vắng mặt khi bằng 0), directory, sub_directory (vắng mặt khi không có) và annotations (tập mà các ranh giới của Release truyền xuống node, với tập của mục Release riêng của nó được xếp lớp sau cùng; vắng mặt khi rỗng); và yaml_indent, độ rộng thụt lề trên toàn bộ lần render mà guest dùng để tuần tự hóa đầu ra của nó. Lần render của một FeatureRecipe phạm vi ranh giới, vốn không có component host, nhận ngữ cảnh mà bước pipeline của nó nhận, cộng thêm yaml_indent: parameters; annotations chỉ mang nhóm release, tức tập annotation riêng của ranh giới; và một boundary mang name, path của nó và chính tập đó làm annotations. Các annotation aggrega.ai/* phổ biến được đọc từ nhóm aggregate với nhóm release được ghi đè lên trên, nên một khóa mà cả hai cùng mang sẽ lấy giá trị của Release; một provider của thư viện chuẩn đọc chúng từ tập đã xếp lớp đó và không bao giờ từ nhóm catalog, nên một giá trị catalog không bao giờ quyết định annotation nào, và một FeatureRecipe phạm vi ranh giới, vốn có ngữ cảnh không mang nhóm aggregate, render theo các giá trị của ranh giới của nó chứ không theo giá trị của bất kỳ component nào.
source_listingSourceListingkhôngBản liệt kê chung của nguồn đã thu nhận mà host trao cho guest đối với một provider có nguồn: gốc nguồn, việc gốc đó có phải là thư mục hay không, và các mục tương đối với gốc đã được sắp xếp bên dưới nó. Host không đọc nội dung tệp nào ở đây — nó chỉ liệt kê tên. Guest áp dụng logic phân giải riêng của mình lên danh sách và yêu cầu host đóng gói một lựa chọn thông qua hàm host pack-source, nên mọi logic phân giải nguồn riêng của từng provider đều nằm trong guest. Có mặt đối với provider có nguồn; vắng mặt trong trường hợp khác.
workload_projectionWorkloadProjectionkhôngWorkload đã được đánh giá trước mà host trao cho guest để từ đó tổng hợp các manifest gốc của provider; có mặt khi Recipe được gắn khai báo một workload thay vì một nguồn chart, vắng mặt trong trường hợp khác.
artifacts_projectionArtifactsProjectionkhôngTập artifact đã được đánh giá trước mà host trao cho guest để đặt vào đầu ra của node, có mặt khi Recipe được gắn khai báo artifacts. Host đã đọc nguồn của từng mục, đánh giá nó như một Go template dựa trên ngữ cảnh render, và tính toán các tập khóa nguồn gốc bản build; guest quyết định định dạng đầu ra, vị trí đặt nguồn gốc, đường dẫn trên đĩa và các byte cuối cùng. Vắng mặt khi node không khai báo artifact nào.
omitsOmitEntry[]khôngCác mục chỉ định những đơn vị được render mà guest bỏ ra khỏi đầu ra của node này, theo thứ tự tác giả đã khai báo. Mỗi mục đến ở dạng đã phân giải, các trường của nó là chuỗi thuần, và một mục không áp dụng cho bản build này thì không được mang theo. Những gì kind, name, namespace và subchart của một mục chọn là hợp đồng được tài liệu hóa riêng của provider này, không phải của socket này: guest so khớp mọi mục với những gì nó đã render theo thuật ngữ của định dạng riêng của nó, bỏ mỗi đơn vị mà một mục khớp ra khỏi mọi thứ nó trả về — các tệp của nó, các tên nó khai báo trong derived_keys và các fact nó báo cáo trong render_facts — và báo cáo trong omitted của đầu ra số đơn vị mà mỗi mục đã khớp. Các mục đi kèm một danh sách nguồn và không đi kèm đầu vào nào khác: một lần render của workload được tổng hợp hoặc của một tập artifact không bao giờ mang chúng. Vắng mặt khi không có mục nào, và một guest không được trao mục nào sẽ render đúng như khi trường này không tồn tại.

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

IRNodeProjection

Dữ liệu IR theo từng node mà một guest Provider render — một phép chiếu có giới hạn của node IR đầy đủ, mang danh tính theo từng node và nguồn gốc mà guest đóng dấu lên mọi manifest được phát ra: id, type, recipe đã phân giải, values, việc một ánh xạ values có tạo ra các values đó hay không, các feature attachment, đánh dấu tính nhạy cảm trên các khóa đã render và trên toàn bộ values, các cạnh uses đi ra, đường dẫn boundary, sync wave, danh tính Recipe, ghi đè component-id, cơ sở tên dẫn xuất, và nguồn gốc bản build. Danh tính và cơ sở tên dẫn xuất là hai trường mang riêng vì chúng trả lời hai câu hỏi — một tài nguyên thuộc về cái gì, và nguồn của chính tác giả được render dựa trên cái gì — và một Feature attachment cung cấp nguồn do tác giả của nó viết là nơi hai câu trả lời khác nhau. Nội dung tệp nguồn không được mang ở đây; nó được truyền riêng trong phép chiếu nguồn. Mọi tập khóa ở đây có thứ tự cố định — features và uses theo thứ tự của tác giả, values và đánh dấu tính nhạy cảm theo thứ tự khóa đã sắp xếp — để payload truyền đi giống hệt nhau từng byte giữa các lần chạy với cùng đầu vào.

Thuộc tínhLoạiBắt buộcMô tả
idstringcóId tuyệt đối của node trong đồ thị topology.
typestringcóĐược khai báo và cố ý giữ lại: host luôn phát ra trường này dưới dạng chuỗi rỗng. Nhãn component-type của node là siêu dữ liệu mờ chứ không phải công tắc hành vi, nên mang nó ở đây chỉ khiến guest rẽ nhánh dựa trên nó. Guest đọc được một chuỗi rỗng và không được hiểu đó là một node có component type chưa được đặt. (Hình dạng node trong việc lắp ráp boundary mang một type riêng, cho một mục đích khác.)
resolved_recipestringcóĐược khai báo và cố ý giữ lại: host luôn phát ra trường này dưới dạng chuỗi rỗng. Danh tính của Recipe được gắn đã đến guest dưới dạng tên và phiên bản recipe mà nó đóng dấu vào nguồn gốc, nên URI đã phân giải không thêm gì mà guest render từ đó. Một guest cần gán đầu ra cho một Recipe thì đọc các trường nguồn gốc đó thay vào.
valuesobjectkhôngTừ điển values đã render của node, tập khóa mà guest render từ đó. Các khóa đến theo thứ tự đã sắp xếp, không theo thứ tự của tác giả, và chính việc sắp xếp đó làm cho payload giống hệt nhau từng byte giữa các lần chạy với cùng đầu vào; một guest cần thứ tự khác thì tự áp đặt thứ tự đó.
featuresobjectkhôngCác feature attachment của node được đánh khóa theo alias của feature, mang cùng hình dạng feature attachment theo từng node mà IR mang. Mỗi mục mang values, infra và ánh xạ inject của attachment cùng với đánh dấu tính nhạy cảm được dẫn xuất của nó, nên guest đọc được từ riêng payload việc một attachment có xử lý dữ liệu được khai báo là nhạy cảm hay không. Giữ thứ tự của tác giả để payload giống hệt nhau từng byte giữa các lần chạy với cùng đầu vào. Mờ ở tầng schema này; guest đọc hình dạng feature-entry thông qua hợp đồng truyền đi của IR.
sensitive_rendered_keysmap của stringkhôngCác khóa đã render có danh tính được khôi phục từ một dữ liệu mà tác giả đã khai báo là nhạy cảm, mỗi khóa được ánh xạ tới khai báo mà nó kế thừa tính nhạy cảm đó. Đi từ host đến guest trên đầu vào render — ngược chiều với các tên mà guest khai báo trên đầu ra render. Điều một khóa đặt tên tuân theo dạng mà payload này mang: trên payload mang values của node, nó là một trong các khóa của map đó; trên payload mang một workload, nó đặt tên một mục trong các map đính kèm riêng của workload, nơi values của node rỗng. Một khóa chỉ có mặt khi việc khôi phục là chính xác, nối một khai báo với một danh tính đã render mà không đọc gì từ văn bản của chính khóa và không có đánh dấu theo node hay theo attachment nào được trải ra trên từng khóa riêng lẻ. Vì vậy, một khóa do template tạo ra sẽ vắng mặt, vì không có khai báo nào đặt tên nó: các khóa đầu ra của valuesMapping của một recipe và nội dung của một artifact đều do template tạo ra, nên không cái nào sinh ra khóa ở đây — việc một payload như vậy có được tạo từ một giá trị được khai báo là nhạy cảm hay không thì được mang thay vào đó bởi sensitive_values, và bởi sensitive_content của chính mục artifact. Do đó, sự vắng mặt chỉ cho biết không khôi phục được danh tính của khóa nào, không bao giờ cho biết rằng không có gì trên payload này mang dữ liệu nhạy cảm — một guest đọc một khóa vắng mặt như sự cho phép hiển thị hoặc xuất một giá trị ở dạng rõ là đã hiểu ngược. Các khóa đến theo thứ tự đã sắp xếp, đó là điều làm cho payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.
sensitive_valuesbooleankhôngTrue khi các values mà payload này mang được tạo ra bởi một template đọc một giá trị mà tác giả đã khai báo là nhạy cảm, hoặc một giá trị truy được về một giá trị như vậy: valuesMapping của một Recipe hoặc của một FeatureRecipe, một template duy nhất có các khóa và giá trị đầu ra do chính nó tạo ra, nên không khóa nào của đầu ra đó truy ngược được về dữ liệu gốc và thay vào đó toàn bộ map được đánh dấu. Nó được đọc từ các tham chiếu của chính template đối chiếu với các khai báo — một tham chiếu chạm tới một giá trị đã khai báo, template chuyển tiếp toàn bộ dữ liệu của nó, hoặc một template không phân tích được đều được tính — và không bao giờ từ nội dung của một giá trị hay tên của một khóa. Một guest soạn văn bản mà người đọc, một lời từ chối hoặc một cảnh báo, sẽ giữ mọi giá trị trong values của node ngoài văn bản đó khi trường này là true, và giữ ngoài giá trị dưới bất kỳ khóa nào mà sensitive_rendered_keys nêu tên dù trường này có là true hay không: hai trường kết hợp với nhau, một trường nêu tên các khóa có danh tính được khôi phục chính xác và trường này bao phủ map khi không khôi phục được khóa nào. Vắng mặt khi không có template nào như vậy đọc một giá trị như vậy, bao gồm cả các values chính là các lá đã khai báo, vốn được đánh dấu theo từng khóa trong sensitive_rendered_keys, và vắng mặt trên payload không mang values. Sự vắng mặt không bao giờ cho biết rằng không có giá trị nào nhạy cảm.
values_mappedbooleankhôngTrue khi các values mà payload này mang là đầu ra của valuesMapping của Recipe hoặc FeatureRecipe được gắn, thay vì values của node được chuyển tiếp nguyên như tác giả đã viết. Một guest có hợp đồng riêng chỉ gắn vào các đầu vào mà source của nó khai báo những values do mapping tạo ra sẽ đọc trường này, và không đọc các values được viết cho thứ khác, chẳng hạn các artifact của Recipe; một guest gắn values của node vào source của nó bất kể chúng được tạo ra thế nào thì không đọc trường này. Nó ghi lại cách các values được tạo ra và không bao giờ được suy ra từ tên của một khóa hay nội dung của một giá trị. Vắng mặt khi không có valuesMapping nào chạy, và trên payload không mang values.
usesmap của string[]khôngĐược khai báo và cố ý giữ lại: host không bao giờ điền trường này, nên map vắng mặt trong mọi payload render. Một cạnh đi ra được tiêu thụ trước khi dispatch — các values được publish của cạnh được nạp lại vào inject pipe riêng của node, mà Recipe đã đánh giá thành values và workload mà guest nhận — và một guest lắp ráp một boundary thay vào đó nhận danh sách cạnh trên đầu vào riêng của nó. Nếu được điền, nó sẽ lập khóa các cạnh uses đi ra của node theo socket alias, mỗi cạnh mang các id node đích có thứ tự của socket đó theo thứ tự của tác giả.
boundary_pathstringkhôngĐường dẫn boundary của node, được đóng dấu thành annotation aggrega.ai/boundary-path trên mọi manifest được xuất ra có mang khối metadata.
sync_waveintegerkhôngWave triển khai mà node này kế thừa từ boundary chứa nó (mặc định 0; cho phép giá trị âm), mang giá trị mà node IR giữ dưới dạng sync_wave. Guest làm gì với nó là lựa chọn riêng của guest, và việc ghi lại giá trị và sắp thứ tự theo nó là độc lập chứ không phải lựa chọn thay thế — một guest có thể làm một trong hai, cả hai hoặc không làm gì. Trong các provider của thư viện chuẩn: helm và helm-chart xuất nó thành annotation argocd.argoproj.io/sync-wave trên mọi tài nguyên được render, và thêm vào đó là helm.sh/hook-weight trên tài nguyên mà chart đã đánh dấu là Helm hook; compose vừa ghi nó thành nhãn service vừa sắp thứ tự các service của tệp mà nó render vào, thông qua depends_on giữa chúng; cloudformation sắp thứ tự việc cấp phát stack đã lắp ráp, khai báo mọi tài nguyên trong một wave phụ thuộc vào các tài nguyên của wave trước đó; terraform sắp thứ tự các khối module của cấu hình gốc mà một boundary lắp ráp vào, khai báo mọi module trong một wave phụ thuộc vào các module của wave trước đó, và đồng thời ghi nó cùng với build provenance của node.
recipe_namestringkhôngTên của Recipe được gắn, kết hợp với recipe_version để tạo thành annotation aggrega.ai/recipe-uri; khi một trong hai nửa rỗng thì annotation không được đóng dấu.
recipe_versionstringkhôngPhiên bản của Recipe được gắn, kết hợp với recipe_name để tạo thành annotation aggrega.ai/recipe-uri; khi một trong hai nửa rỗng thì annotation không được đóng dấu.
label_component_idstringkhôngDanh tính component an toàn với Kubernetes — thứ mà tài nguyên do node này xuất ra THUỘC VỀ, cũng là điều provenance ghi lại và điều một selector truy vấn. Khi không rỗng, nó ghi đè id node làm giá trị nhãn app.kubernetes.io/name và aggrega.ai/component-id; rỗng nghĩa là id node đã hợp lệ làm nhãn và được dùng trực tiếp. Nó được mang cho mọi tài nguyên mà một Feature attachment xuất ra, bất kể attachment cung cấp chúng theo cách nào, nên tài nguyên của một attachment có thể phân biệt với tài nguyên của component host chỉ bằng nhãn. Thứ mà guest dùng để suy ra tên riêng của nó là một trường riêng, derived_name_basis, và hai trường trả lời hai câu hỏi khác nhau.
derived_name_basisstringkhôngDanh tính mà guest dùng để suy ra tên riêng của nó — tên release mà các template của trình cài đặt chart đọc, mà một guest như vậy cũng có thể dùng để đặt tên cho các tài nguyên nó tổng hợp cho một component, và tiền tố trên các tệp mà một lần render source xuất ra. Rỗng nghĩa là id node được dùng trực tiếp, đó là giá trị cho một component thông thường và cho một Feature attachment theo từng component: một attachment cung cấp một chart hoặc một fragment do tác giả của nó viết sẽ render nó theo tên của component HOST, vì các template của chính tác giả đặt tên tài nguyên theo tên đó và một tên khác sẽ đổi tên các tài nguyên đã được triển khai. Một node có id mang cú pháp đánh dấu mà bảng chữ cái tên của đích từ chối sẽ mang trường này một cách tường minh, để tên mà guest suy ra vẫn là tên đích chấp nhận. Nó được cố ý tách khỏi label_component_id: một guest XÂY DỰNG tài nguyên cho một Feature attachment thay vì render source của tác giả sẽ đặt tên chúng theo danh tính, để tài nguyên riêng của attachment không thể xung đột với tài nguyên của host, trong khi tên mà source của tác giả render theo vẫn giữ nguyên. Hai trường mang cùng giá trị ở bất kỳ đâu danh tính của node cũng là thứ mà source của nó render theo.
output_labelsmap của stringkhôngCác nhãn đầu ra do tác giả recipe khai báo mà guest gắn lên mọi manifest được phát ra, cùng với provenance về danh tính bản dựng, được đánh khóa theo tên nhãn. Hai khối do tác giả viết được hợp nhất vào map này: các cặp khóa-giá trị nguyên văn mà một recipe viết trong outputLabels, và một mục cho mỗi khóa mà một recipe nêu trong outputComponentLabels, có giá trị được đọc từ khóa đó trên chính các nhãn của component được render — vì vậy một giá trị được nâng lên đi theo component mà nó xuất phát, thay vì được lặp lại trong recipe. Cả hai khối đều tách biệt với không gian khóa provenance nhờ kiểm tra lúc nạp (không có khóa aggrega.ai/ hay app.kubernetes.io/), nên việc gắn nhãn không bao giờ xung đột với một nhãn provenance. Một khóa được nâng lên mà component không khai báo sẽ không gắn gì và phát ra một cảnh báo tư vấn thay vì một nhãn rỗng. Một guest có đầu ra không phải YAML của Kubernetes sẽ chuyển chúng sang bề mặt nhãn của riêng nó (nhãn service của Compose) hoặc bỏ qua chúng.
provenanceNodeProvenancecóProvenance về danh tính bản dựng mà guest gắn lên mọi manifest được phát ra dưới dạng các nhãn aggrega.ai.

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

NodeProvenance

Provenance về danh tính bản dựng cho một node — danh tính của trình biên dịch, aggregate và môi trường mà guest gắn lên mọi manifest được phát ra dưới dạng các nhãn aggrega.ai. Mỗi trường được lược bỏ khi rỗng, nên một danh tính không đầy đủ chỉ gắn những nhãn mà nó mang.

Thuộc tínhLoạiBắt buộcMô tả
compiler_versionstringkhôngPhiên bản trình biên dịch, được gắn dưới dạng nhãn aggrega.ai/compiler-version khi không rỗng.
aggregate_namestringkhôngTên aggregate, được gắn dưới dạng nhãn aggrega.ai/aggregate-name khi không rỗng.
environmentstringkhôngTên môi trường, được gắn dưới dạng nhãn aggrega.ai/environment khi không rỗng.
provider_namestringkhôngLoại provider thuần, được gắn dưới dạng nhãn aggrega.ai/provider khi không rỗng.
provider_versionstringkhôngPhiên bản đã được phân giải của plugin render provider, được gắn dưới dạng nhãn aggrega.ai/provider-version khi không rỗng.

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

RenderNodeOutput

Payload mà một guest Provider trả về từ export render_node của nó: các byte đã tuần tự hóa của từng tệp đầu ra mà guest đã phát ra, các tên mà nó đã suy ra vào từng không gian khóa riêng của nó, các dữ kiện mà nó báo cáo về những gì nó đã phát ra, số đơn vị được render mà mỗi mục omit được giao cho nó đã khớp, và mọi chẩn đoán mà guest đưa ra trong khi render. Guest trả về các byte đã tuần tự hóa của từng tệp; host ghi chúng nguyên văn và không chạy bộ tuần tự hóa nào. Tính tất định là trách nhiệm của guest: đầu vào giống hệt nhau phải tạo ra các byte giống hệt nhau.

Thuộc tínhLoạiBắt buộcMô tả
filesRenderedFile[]cóCác tệp đầu ra mà guest đã phát ra, theo thứ tự phát ra. Mỗi tệp nêu đường dẫn trên đĩa của nó và mang các byte đã tuần tự hóa mà host ghi nguyên văn.
derived_keysmap của string[]khôngCác tên mà guest đã suy ra trong khi render node này, được đánh khóa theo không gian khóa mà nó đã suy ra chúng vào, mỗi không gian mang các tên của nó theo thứ tự suy ra. Một guest suy ra tên mà đầu ra của nó dùng để tham chiếu một tài nguyên đã đặt tên đó bên trong các byte tệp mà host ghi nguyên văn, nơi host không thể thấy nó; khai báo nó ở đây là cách guest yêu cầu host xác nhận không có hai lần suy ra nào trùng vào cùng một tên. Host so sánh các tên đã khai báo về tính bằng nhau trong phạm vi một không gian đã khai báo và không làm gì khác — nó không phân tích cú pháp một tên, không biết một không gian hay một tên có nghĩa gì, và không bao giờ tự suy ra một tên. Hai bên đóng góp vào cùng một đầu ra được lắp ráp mà khai báo cùng một tên trong cùng một không gian sẽ làm dừng bản build, và việc dừng nêu tên không gian, tên đó và cả hai bên đóng góp. Cả tên các không gian lẫn các tên bên trong chúng đều là từ vựng riêng của guest: một guest muốn tính duy nhất trên một phạm vi hẹp hơn hoặc rộng hơn một đầu ra được lắp ráp sẽ thể hiện phạm vi đó trong tên không gian mà nó khai báo. Giữ nguyên thứ tự khai báo để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau. Vắng mặt khi guest không suy ra tên nào mà nó muốn được kiểm tra, điều này khiến việc kiểm tra không có tác dụng đối với guest đó.
render_factsRenderFact[]khôngCác dữ kiện mà guest báo cáo về những gì nó đã phát ra cho node này, theo thứ tự guest liệt kê chúng. Mỗi dữ kiện ghép một tên với một giá trị, và cả hai đều là từ vựng riêng của guest: những dữ kiện nào một provider báo cáo, mỗi tên có nghĩa gì và các mục của nó chứa gì là một phần của hợp đồng được tài liệu hóa của provider đó, không phải của socket này. Giá trị của mọi dữ kiện đều là một danh sách, kể cả khi nó chỉ chứa một mục: host từ chối một dữ kiện có giá trị là bất cứ thứ gì khác, nêu tên provider và dữ kiện, và dừng bản build. Đó là điều duy nhất host biết về một giá trị. Nó đánh khóa các dữ kiện theo tên và giao từng danh sách cho các template đọc nó, nối các danh sách của cùng một tên được báo cáo bởi nhiều hơn một lần render của cùng một node theo thứ tự các lần render đó đã chạy, và nó không bao giờ biết một tên hay một mục có nghĩa gì hoặc tự suy ra một dữ kiện — vì vậy một provider có thể báo cáo điều mà chỉ kiến thức về định dạng của riêng nó mới thấy được, chẳng hạn một thuộc tính của các tài liệu nó đã viết, mà host không cần biết định dạng đó. Việc báo cáo dữ kiện không bao giờ thay đổi những gì được ghi: các tệp host ghi chính là các tệp guest đã trả về, dù có dữ kiện đi kèm hay không. Guest liệt kê các dữ kiện của nó theo một thứ tự cố định để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau. Vắng mặt khi guest không báo cáo gì, đây là một câu trả lời đầy đủ chứ không phải một câu trả lời bị thiếu.
omittedinteger[]khôngSố đơn vị được render mà mỗi mục trong omits của đầu vào đã khớp: một số đếm cho mỗi mục được giao cho guest, theo cùng thứ tự, mỗi số là số đơn vị mà mục đó đã khớp bất kể có mục khác cũng khớp chúng hay không. Số đếm bằng không là một câu trả lời đầy đủ — mục đó không khớp với thứ gì guest đã render. Các số đếm là tất cả những gì socket mang về liên quan đến những gì bị bỏ ra: bản thân các đơn vị đơn giản là vắng mặt trong những gì guest trả về. Vắng mặt khi guest không được giao mục nào.
diagnosticsDiagnostic[]khôngCác chẩn đoán mà guest đưa ra trong khi render. Mỗi phần tử có dạng chẩn đoán dùng chung của Wasm-plugin.
errorstringkhôngMột thông điệp lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với mọi chẩn đoán mà đầu ra mang theo: chẩn đoán báo cáo các vấn đề phát hiện trong một lần chạy vẫn tạo ra kết quả, còn error báo cáo rằng bản thân thao tác đã không hoàn tất. Host hiển thị một error có mặt như một lần gọi plugin thất bại.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

ValidateNodeOutput

Payload mà một guest Provider trả về từ export validate_node_input tùy chọn của nó: các chẩn đoán phát sinh từ một lần kiểm tra cấu trúc đối với đầu vào đã được phân giải của node. Export này tiêu thụ cùng phép chiếu RenderNodeInput mà render_node nhận được và không xuất ra tệp nào — nó chỉ báo cáo chẩn đoán. Một chẩn đoán có mức độ halt dừng bản build một cách rõ ràng, nêu tên node và provider; một chẩn đoán có mức độ warn hoặc info được đưa lên kết quả build mà không thay đổi đầu ra đã render. Một danh sách diagnostics rỗng nghĩa là đầu vào đã vượt qua lần kiểm tra cấu trúc.

Thuộc tínhLoạiBắt buộcMô tả
diagnosticsDiagnostic[]khôngCác chẩn đoán mà guest phát sinh khi xác thực đầu vào của node. Mỗi phần tử có dạng chẩn đoán dùng chung của Wasm-plugin. Rỗng khi đầu vào đã vượt qua lần kiểm tra cấu trúc.
errorstringkhôngMột thông điệp lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với mọi chẩn đoán mà đầu ra mang theo: chẩn đoán báo cáo các vấn đề phát hiện trong một lần chạy vẫn tạo ra kết quả, còn error báo cáo rằng bản thân thao tác đã không hoàn tất. Host hiển thị một error có mặt như một lần gọi plugin thất bại.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

RenderedFile

Một tệp đầu ra mà một guest Provider đã xuất ra: đường dẫn trên đĩa của nó tương đối với thư mục gốc đầu ra của node, và các byte đã tuần tự hóa của nó đúng như guest đã tạo ra. Host ghi nguyên văn các byte này và không chạy bộ tuần tự hóa nào, nên đầu ra trên đĩa giống hệt từng byte với những gì guest đã xuất ra.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóĐường dẫn của tệp đầu ra tương đối với thư mục gốc đầu ra của node (ví dụ Chart.yaml hoặc templates/deployment.yaml).
contentstringcóCác byte đã tuần tự hóa của tệp đúng như guest đã tạo ra; host ghi nguyên văn các byte này và không chạy bộ tuần tự hóa nào, nên đầu ra giống hệt từng byte với những gì guest đã xuất ra. Mỗi kit mang chúng trong kiểu trường riêng của nó — ở dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.
formatstringkhôngĐịnh dạng mà guest khai báo tệp đã xuất được render theo, để host có thể chuyển tệp tới một parser phù hợp. Vắng mặt khi guest không khai báo định dạng nào, trong trường hợp đó host suy ra định dạng từ phần mở rộng của tệp.

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

RenderFact

Một fact mà một guest Provider báo cáo về những gì nó đã xuất ra cho một node: một tên và một danh sách các mục, cả hai đều do provider định nghĩa và mô tả trong tài liệu. Host mang fact đúng như guest đã viết, từ chối một fact có giá trị không phải danh sách, và không biết thêm gì khác về cả hai nửa.

Thuộc tínhLoạiBắt buộcMô tả
namestringcóTên của fact, lấy từ bộ từ vựng đã được mô tả trong tài liệu của chính provider.
valuearraycóGiá trị của fact: một mảng JSON — luôn là một danh sách, kể cả khi có một mục hoặc không có mục nào — với các mục là bất kỳ giá trị JSON nào theo dạng mà provider mô tả cho tên đó. Một danh sách là điều cho phép một tên được báo cáo bởi nhiều hơn một lần render của một node: host nối các danh sách thành một. Nó được mang dưới dạng tài liệu JSON mà guest đã viết, đúng từng byte, nên thứ tự các mục của danh sách và các khóa của mỗi đối tượng là của chính guest.

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

OmitEntry

Một mục nêu tên các đơn vị đã render mà một guest Provider bỏ ra khỏi đầu ra của một node, các trường của nó đã được phân giải thành chuỗi thuần và được đánh dấu ở chỗ bất kỳ trường nào trong số đó được tạo ra từ một giá trị được khai báo là nhạy cảm. Socket không gán ý nghĩa nào cho chúng: mỗi provider tự mô tả kind, name, namespace và subchart chọn gì trong định dạng riêng của nó, và tự đối khớp chúng.

Thuộc tínhLoạiBắt buộcMô tả
kindstringcóLoại đơn vị đã render mà mục nêu tên, theo bộ từ vựng riêng của provider.
namestringcóTên của đơn vị đã render mà mục nêu tên, theo bộ từ vựng riêng của provider.
namespacestringkhôngNamespace chứa đơn vị được nêu tên, đối với một provider có định dạng đặt các đơn vị vào namespace. Vắng mặt khi tác giả không viết namespace nào; một mục không có namespace khớp với gì là hợp đồng riêng của provider.
subchartstringkhôngNguồn lồng nhau mà đơn vị được nêu tên đến từ đó, dành cho một provider có nguồn được lắp ráp từ các nguồn lồng nhau, như một chart được lắp ráp từ các subchart của nó. Vắng mặt khi tác giả không viết; một mục không có subchart khớp với gì, và một provider có nguồn không có nguồn lồng nhau làm gì với một mục nêu tên một nguồn như vậy, là hợp đồng riêng của provider đó.
sensitivebooleankhôngTrue khi template tạo ra bất kỳ kind, name, namespace hoặc subchart nào của mục đọc một giá trị mà tác giả đã khai báo là nhạy cảm, hoặc một giá trị được truy nguồn từ giá trị như vậy. Điều này được đọc từ template của mỗi trường đối chiếu với các khai báo — một tham chiếu chạm tới một giá trị đã khai báo, template chuyển tiếp toàn bộ dữ liệu của nó, hoặc một template không phân tích được đều được tính — và không bao giờ từ các chuỗi đã phân giải. Dấu này bao trùm toàn bộ mục thay vì nêu tên trường, nên guest xử lý một mục được đánh dấu như cách nó xử lý mọi giá trị được đánh dấu khác trong đầu vào: nó vẫn đối khớp và đếm mục theo các trường của mục, vốn là mục đích của mục, và giữ mọi trường của mục ra khỏi bất kỳ văn bản nào mà con người đọc — một lời từ chối, một cảnh báo hay một dòng log. Vắng mặt khi không có template của trường nào đọc giá trị như vậy; sự vắng mặt không bao giờ khẳng định rằng không có trường nào nhạy cảm.

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

SourceFile

Một tệp của một phép chiếu nguồn đã đóng gói sẵn: đường dẫn của nó tương đối với gốc nguồn và các byte thô của nó, đúng như host đã đọc chúng từ nguồn cục bộ tại thời điểm biên dịch.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóĐường dẫn của tệp tương đối với thư mục gốc nguồn (ví dụ Chart.yaml hoặc templates/deployment.yaml).
contentstringcóCác byte thô của tệp đúng như host đã đọc chúng từ nguồn cục bộ. Mỗi kit mang chúng trong kiểu trường riêng của nó — ở dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.

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

SourceProjection

Nội dung nguồn đã đóng gói (ví dụ: các tệp của một Helm chart, mỗi tệp được đặt tên theo đường dẫn của nó tương đối với gốc nguồn, theo thứ tự duyệt) mà host đọc và trả về cho guest để đáp lại một yêu cầu pack-source, nhờ đó guest dựng lại nguồn đã chọn trong bộ nhớ và không chạm vào hệ thống tệp nào. Đây là payload thành công của hàm host pack-source.

Thuộc tínhLoạiBắt buộcMô tả
filesSourceFile[]cóCác tệp nguồn, mỗi tệp được đặt tên theo đường dẫn của nó tương đối với gốc nguồn, theo thứ tự duyệt tất định của host.

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

SourceEntry

Một mục của danh sách nguồn: đường dẫn của nó tương đối với gốc nguồn, và việc nó có phải là thư mục hay không. Host chỉ liệt kê tên và không đọc nội dung nào, vì vậy một mục không mang byte nào.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóĐường dẫn của mục tương đối với gốc nguồn, phân tách bằng dấu gạch chéo (ví dụ Chart.yaml hoặc templates/deployment.yaml).
is_dirbooleancóMục có phải là thư mục hay không. Một guest xác định gốc chart hoặc một tệp nguồn đơn lẻ trong danh sách sẽ đọc giá trị này để phân biệt thư mục với tệp mà không chạm vào hệ thống tệp.

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

SourceListing

Bản liệt kê chung của một nguồn đã thu nhận mà host giao cho một guest provider có nguồn: gốc nguồn, việc gốc đó có phải là thư mục hay không, và các mục tương đối với gốc đã được sắp xếp bên dưới nó. Host duyệt nguồn đã thu nhận mà không có kiến thức miền nào và không đọc nội dung tệp nào — nó chỉ liệt kê tên. Guest áp dụng logic phân giải riêng của mình trên danh sách (định vị gốc chart, chọn một tài liệu compose đơn lẻ, vendor một cây module) và yêu cầu host đóng gói một lựa chọn đã chọn thông qua hàm host pack-source. Các mục được sắp xếp theo đường dẫn để danh sách giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.

Thuộc tínhLoạiBắt buộcMô tả
rootstringcóVị trí nguồn đã thu nhận mà host đã liệt kê. Guest mang nó vào các chẩn đoán của riêng mình khi không thể phân giải nguồn, để một lần dừng do phân giải nêu tên nguồn mà tác giả đã cung cấp.
root_is_dirbooleankhôngGốc nguồn đã thu nhận có phải là thư mục hay không. False đối với nguồn một tệp (một tài liệu compose đơn lẻ, một tệp module đơn lẻ, một kho lưu trữ), khi đó entries rỗng và guest đóng gói chính gốc đó.
entriesSourceEntry[]cóCác mục tương đối với gốc bên dưới một gốc nguồn là thư mục, được sắp xếp theo đường dẫn. Rỗng đối với gốc nguồn một tệp.

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

SourcePackRequest

Lựa chọn mà guest yêu cầu host đóng gói từ nguồn đã thu nhận thông qua hàm host pack-source. op nêu hình dạng của lựa chọn và path nêu nó tương đối với gốc nguồn; host phân giải đường dẫn bên dưới gốc nguồn, từ chối mọi lần thoát lên trên gốc, và trả về các byte đã đóng gói dưới dạng một SourceProjection.

Thuộc tínhLoạiBắt buộcMô tả
opstring (enum)cóHình dạng lựa chọn: file đóng gói tệp đơn lẻ tại path; dir đóng gói các tệp trực tiếp của thư mục tại path; tree đóng gói toàn bộ cây con có gốc tại path, một cách đệ quy, theo thứ tự duyệt tất định của host. Giá trị được phép: "file", "dir", "tree"
pathstringcóVị trí lựa chọn tương đối với gốc nguồn, phân tách bằng dấu gạch chéo. Chuỗi rỗng (hoặc ”.”) chỉ chính gốc nguồn, vì vậy một nguồn một tệp được đóng gói với đường dẫn rỗng.

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

SourcePackResponse

Phản hồi của hàm host pack-source: khi thành công là nguồn đã đóng gói, khi thất bại là một thông điệp lỗi. Đúng một trong hai trường được điền. Lỗi được chuyển trong băng thay vì bằng trap, nhờ đó guest mang một lần từ chối của sandbox hoặc một lỗi đọc vào các chẩn đoán của riêng mình như một lỗi render tất định.

Thuộc tínhLoạiBắt buộcMô tả
source_projectionSourceProjectionkhôngNguồn đã đóng gói khi thành công; vắng mặt khi thất bại.
errorstringkhôngThông điệp lỗi khi thất bại, nêu lựa chọn và lý do; vắng mặt khi thành công.
hostfunc_error_codestring (enum)khôngDanh tính lỗi mà máy có thể so khớp khi thất bại, lấy từ danh mục mã lỗi đóng của host function, được đặt bên cạnh thông điệp lỗi cho con người; vắng mặt khi thành công. Danh mục đó là một bộ từ vựng cố định nêu tên các cách một host function có thể thất bại, và nó là một bộ từ vựng khác với các điều kiện dừng mà trình biên dịch đăng ký, vốn có các định danh mà guest báo cáo trên đầu ra socket dưới dạng condition_code và condition_short_code — tên khóa cho biết một giá trị thuộc về bộ nào trong hai bộ, nên hai bộ không bao giờ bị đọc như một tập. Guest rẽ nhánh dựa trên mã này mà không cần phân tích thông điệp, chấp nhận một mã vắng mặt (host cũ hơn) hoặc một mã không nhận ra (host mới hơn) bằng cách quay về dùng thông điệp. Các giá trị cho phép: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

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

SourceFileRequest

Lần đọc nội dung một tệp đơn lẻ mà guest yêu cầu host thực hiện thông qua hàm host read-source-file, dành cho guest có logic phân giải phải kiểm tra nội dung của một tệp trước khi chọn thứ cần đóng gói. Host phân giải đường dẫn bên dưới gốc nguồn, từ chối mọi lần thoát lên trên gốc, và trả về các byte của tệp.

Thuộc tínhLoạiBắt buộcMô tả
pathstringcóVị trí tệp tương đối với gốc nguồn, phân tách bằng dấu gạch chéo.

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

SourceFileResponse

Phản hồi của hàm host read-source-file: khi thành công là các byte của tệp, khi thất bại là một thông điệp lỗi. Đúng một trong hai trường được điền. Lỗi được chuyển trong băng thay vì bằng trap, nhờ đó guest mang một lần từ chối của sandbox hoặc một lỗi đọc vào các chẩn đoán của riêng mình như một lỗi render tất định.

Thuộc tínhLoạiBắt buộcMô tả
contentstringkhôngCác byte thô của tệp khi thành công; vắng mặt khi thất bại. Mỗi kit mang chúng trong kiểu trường riêng của mình — ở dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.
errorstringkhôngThông điệp lỗi khi thất bại, nêu tệp và lý do; vắng mặt khi thành công.
hostfunc_error_codestring (enum)khôngDanh tính lỗi mà máy có thể so khớp khi thất bại, lấy từ danh mục mã lỗi đóng của host function, được đặt bên cạnh thông điệp lỗi cho con người; vắng mặt khi thành công. Danh mục đó là một bộ từ vựng cố định nêu tên các cách một host function có thể thất bại, và nó là một bộ từ vựng khác với các điều kiện dừng mà trình biên dịch đăng ký, vốn có các định danh mà guest báo cáo trên đầu ra socket dưới dạng condition_code và condition_short_code — tên khóa cho biết một giá trị thuộc về bộ nào trong hai bộ, nên hai bộ không bao giờ bị đọc như một tập. Guest rẽ nhánh dựa trên mã này mà không cần phân tích thông điệp, chấp nhận một mã vắng mặt (host cũ hơn) hoặc một mã không nhận ra (host mới hơn) bằng cách quay về dùng thông điệp. Các giá trị cho phép: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

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

FetchExternalInputResponse

Phản hồi của hàm host fetch-external-input: khi thành công là nội dung đã tải về, khi thất bại là thông báo lỗi và mã lỗi của nó. Một phản hồi không mang trường thất bại nào là một phản hồi thành công, vì vậy một payload có độ dài bằng không là phản hồi mà mọi trường đều vắng mặt. Thất bại được truyền trong luồng thay vì bằng trap, nên guest đưa một URL không phân giải được hoặc một lần tải thất bại vào chẩn đoán của chính nó như một lỗi render tất định. Yêu cầu là một chuỗi URL thuần thay vì một payload có cấu trúc, nên chỉ phản hồi mới có hình dạng được khai báo.

Thuộc tínhLoạiBắt buộcMô tả
contentstringkhôngCác byte thô của payload đã tải về khi thành công; vắng mặt khi thất bại, và vắng mặt khi payload rỗng. Các byte đi qua wire dưới dạng chuỗi byte, không bao giờ dưới dạng văn bản base64. Kit Go giữ chúng dưới dạng byte slice; kit Rust và TypeScript giữ chúng dưới dạng chuỗi base64, được wrapper fetch của mỗi kit giải mã, nên mọi wrapper đều trả về các byte thô của payload.
errorstringkhôngThông báo lỗi khi thất bại, nêu URL và cách khắc phục; vắng mặt khi thành công.
hostfunc_error_codestring (enum)khôngDanh tính lỗi mà máy có thể so khớp khi thất bại, lấy từ danh mục mã lỗi đóng của host function, được đặt bên cạnh thông điệp lỗi cho con người; vắng mặt khi thành công. Danh mục đó là một bộ từ vựng cố định nêu tên các cách một host function có thể thất bại, và nó là một bộ từ vựng khác với các điều kiện dừng mà trình biên dịch đăng ký, vốn có các định danh mà guest báo cáo trên đầu ra socket dưới dạng condition_code và condition_short_code — tên khóa cho biết một giá trị thuộc về bộ nào trong hai bộ, nên hai bộ không bao giờ bị đọc như một tập. Guest rẽ nhánh dựa trên mã này mà không cần phân tích thông điệp, chấp nhận một mã vắng mặt (host cũ hơn) hoặc một mã không nhận ra (host mới hơn) bằng cách quay về dùng thông điệp. Các giá trị cho phép: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

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

WorkloadProjection

Nội dung workload đã được đánh giá trước mà host giao cho một guest Provider để guest tổng hợp các manifest gốc của provider từ đó trong bộ nhớ; có mặt khi Recipe được ràng buộc khai báo một workload thay vì một nguồn chart. Tính tất định là trách nhiệm của guest: đầu vào giống hệt nhau phải tạo ra các byte giống hệt nhau.

Thuộc tínhLoạiBắt buộcMô tả
workloadobjectcóWorkload đã được host đánh giá, sau xác thực, mà guest tổng hợp; không trong suốt ở tầng schema này để schema socket không ràng buộc lại hợp đồng thực thể Workload.
sensitive_workloadbooleankhôngTrue khi template tạo ra workload đọc một giá trị mà tác giả đã khai báo là nhạy cảm, hoặc một giá trị truy vết được về một giá trị như vậy. Điều này được xác định từ chính các tham chiếu của template đối chiếu với các khai báo — một tham chiếu chạm tới một giá trị đã khai báo, template chuyển tiếp toàn bộ dữ liệu của nó, hoặc một template không phân tích được đều được tính — và không bao giờ từ nội dung của bất kỳ trường nào. Các trường của một workload đã render không mang liên kết nào ngược về dữ liệu mà template của nó đã đọc, nên giá trị này đánh dấu toàn bộ tài liệu: một guest soạn văn bản mà con người đọc, một lời từ chối hay một cảnh báo, sẽ giữ mọi giá trị mà workload mang ra khỏi văn bản đó khi giá trị này là true, trong khi hình dạng của tài liệu — các khóa và vị trí của một giá trị — vẫn đọc được. Các mục attachment mà sensitive_rendered_keys của node projection nêu tên được đánh dấu ở đó dù giá trị này có được đặt hay không. Vắng mặt khi template không đọc giá trị nào như vậy; sự vắng mặt không bao giờ khẳng định rằng không có trường nào nhạy cảm.
attachment_providesobjectkhôngMọi attachment trên node, được chiếu thành các provides đã phân giải của nó và được đánh khóa theo tên instance attachment mà một tham chiếu attachment của workload mang theo; vắng mặt khi node không mang attachment nào. Host sao chép các chuỗi nguyên vẹn mà không diễn giải chúng, nên guest đọc bất kỳ mục nào trong provides của một attachment mà nó cần để phân giải một tham chiếu tới tài nguyên do attachment đó tạo ra. Việc một attachment có xử lý dữ liệu được khai báo là nhạy cảm hay không không được lặp lại ở đây: thông tin đó đi trên mục feature tương ứng của node projection, mà guest đọc theo cùng tên instance.

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

ArtifactsProjection

Tập artifact đã được đánh giá trước mà host giao cho một guest Provider để đặt vào đầu ra của node. Host đã phân giải nguồn của từng mục (nội dung inline hoặc một tệp được import mà nó đã đọc), đánh giá nó như một Go template với render context, dùng cặp delimiter artifact-template mà guest đã khai báo, và tính toán các tập khóa label và annotation build-provenance. Guest quyết định định dạng, vị trí đặt provenance, đường dẫn trên đĩa và các byte cuối cùng. Các mục giữ nguyên thứ tự của tác giả để đầu ra được đặt giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.

Thuộc tínhLoạiBắt buộcMô tả
entriesArtifactProjectionEntry[]cóCác mục artifact mà guest đặt, theo thứ tự của tác giả.

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

ArtifactProjectionEntry

Một mục artifact đã được đánh giá trước mà host giao cho một guest Provider để đặt: tên đầu ra do host phân giải, nguồn gốc của nó, các byte nội dung đã được đánh giá template, việc template sinh ra các byte đó có đọc một giá trị được khai báo là nhạy cảm hay không, và các tập khóa label và annotation build-provenance mà host đã tính cho node. Guest quyết định cách đặt provenance (chèn vào metadata của một manifest, thêm vào đầu dưới dạng chú thích, hoặc xuất một tệp đi kèm) và nơi tệp được đặt.

Thuộc tínhLoạiBắt buộcMô tả
namestringcóTên đầu ra do host phân giải cho mục: khóa map do tác giả khai báo, với một tệp do library bundle cung cấp được lồng dưới khóa đó. Guest đặt mục tại tên này hoặc dưới một đường dẫn con riêng của provider được suy ra từ nó.
originstring (enum)cóMục được viết dưới dạng nội dung inline hay dưới dạng tệp được import. Một guest từ chối một trong hai dạng (một provider umbrella-chart từ chối nội dung inline) đọc giá trị này để dừng một cách rõ ràng. Giá trị cho phép: "inline", "import"
contentstringcóCác byte nội dung đã được đánh giá template mà host tạo ra từ nội dung inline hoặc tệp được import của mục, được đánh giá với render context, dùng cặp delimiter artifact-template mà guest đã khai báo. Mỗi kit mang chúng trong kiểu trường riêng của nó — dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.
sensitive_contentbooleankhôngTrue khi template mà nội dung của mục này được đánh giá từ đó đọc một giá trị mà tác giả đã khai báo là nhạy cảm, hoặc một giá trị truy vết được về một giá trị như vậy. Điều này được xác định từ chính các tham chiếu của template đối chiếu với các khai báo, với cặp delimiter mà nội dung được đánh giá cùng — một tham chiếu chạm tới một giá trị đã khai báo, template chuyển tiếp toàn bộ dữ liệu của nó, hoặc một template không phân tích được đều được tính — và không bao giờ từ chính nội dung. Nội dung là đầu ra của template đó, nên không có gì trong nó có thể truy vết ngược về dữ liệu gốc: một guest soạn văn bản mà con người đọc, một lời từ chối hay một cảnh báo, sẽ giữ mọi phần của nội dung ra khỏi văn bản đó khi giá trị này là true, kể cả thông báo riêng của một parser về nội dung. Giá trị được đặt theo từng mục, nên việc template của một mục đọc một giá trị như vậy không nói gì về mục khác. Vắng mặt khi template không đọc giá trị nào như vậy; sự vắng mặt không bao giờ khẳng định rằng nội dung không nhạy cảm.
labelsobjectkhôngTập khóa build-provenance an toàn cho label Kubernetes mà host đã tính cho node, được đánh khóa theo tên label. Một guest đóng dấu provenance vào metadata.labels của một manifest sẽ chèn các khóa này; một guest có đầu ra không phải YAML Kubernetes sẽ bỏ qua chúng.
annotationsobjectkhôngTập khóa build-provenance mà host đã tính cho node nhưng một label Kubernetes không thể biểu diễn, được đánh khóa theo tên annotation. Một guest đóng dấu provenance vào metadata.annotations của một manifest sẽ chèn các khóa này; một guest có đầu ra không phải YAML Kubernetes sẽ bỏ qua chúng.

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

AssembleBoundaryInput

Payload mà một guest Provider nhận trên export assemble_boundary của nó — export hợp nhất các đầu ra render theo từng node tại một nhóm điều phối thành một artifact được lắp ráp duy nhất (một umbrella chart, một tệp compose đã hợp nhất). Nó mang các đầu ra render theo từng node cùng với annotation đã hợp nhất và các wave triển khai của chúng, đường dẫn đầu ra của nhóm điều phối nơi artifact được lắp ráp được đặt vào, các cạnh uses của đồ thị để suy ra phụ thuộc theo từng service, và ngữ cảnh tại thời điểm render. Không phải provider nào cũng khai báo export này: các provider chỉ xuất đầu ra phẳng theo từng node sẽ bỏ qua nó.

Thuộc tínhLoạiBắt buộcMô tả
rendered_nodesRenderedNode[]cóCác đầu ra render theo từng node đã đưa vào nhóm điều phối này, theo thứ tự node.
contextobjectcóNgữ cảnh thời điểm render, được mang dưới dạng các byte của tài liệu JSON của nó. Trên export này, host chỉ đặt yaml_indent, độ rộng thụt lề trên toàn bộ lần render mà các tệp đã lắp ráp được tuần tự hóa theo; các thành viên khác của ngữ cảnh không mang gì ở đây, vì một lần lắp ráp hợp nhất các bên đóng góp có annotation và ranh giới khác nhau, và annotation của mỗi bên đóng góp thay vào đó đến trên mục rendered_nodes của nó.
boundary_pathstringcóĐường dẫn đầu ra đã được đánh giá của nhóm điều phối nơi artifact được lắp ráp được đặt vào; một trình lắp ráp ranh giới dùng nó làm danh tính dự phòng ở cấp ranh giới (ví dụ: tên mạng compose cho một node không mang annotation namespace).
edgesRenderEdge[]khôngCác cạnh uses có hướng của đồ thị, để một trình lắp ráp ranh giới có thể suy ra thứ tự/phụ thuộc theo từng service giữa các thành phần đóng góp của nhóm điều phối (ví dụ: depends_on của compose).
sub_chartsSubChart[]khôngPayload theo từng sub-chart mà một trình lắp ráp umbrella chart tiêu thụ để xuất một dependency và một phạm vi values cho mỗi thành phần đóng góp. Mỗi mục mang danh tính của sub-chart, values theo từng instance, và, với một sub-chart được vendor từ một nguồn chart, các byte nguyên bản của tệp Chart.yaml của chart đó. Có mặt khi lắp ráp umbrella chart; một trình lắp ráp hợp nhất phẳng sẽ bỏ qua nó.
chart_namestringkhôngTên chart mà một trình lắp ráp umbrella chart dùng cho chart được lắp ráp khi có tên được cung cấp cho nhóm điều phối; rỗng khi trình lắp ráp suy ra tên từ đường dẫn đầu ra của nhóm điều phối.
aggregate_namestringkhôngTên aggregate cấp cao nhất mà một trình lắp ráp umbrella chart đưa vào tên được suy ra của chart được lắp ráp; rỗng khi không có danh tính aggregate nào góp phần vào tên.

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

RenderedNode

Đầu ra render của một node như nó xuất hiện trong đầu vào assemble_boundary: id của node, loại của nó, các annotation đã hợp nhất, sync wave của nó, các giá trị mà trình biên dịch đã phân giải cho nó khi việc cung cấp chúng thuộc về trình biên dịch cùng việc liệu một values mapping có tạo ra chúng hay không, và các tệp mà export render_node đã tạo cho nó — được mang theo trong hình dạng của đầu ra render, với mọi thành phần khác của hình dạng đó ngoài các tệp đều để vắng mặt.

Thuộc tínhLoạiBắt buộcMô tả
idstringcóId tuyệt đối của node trong đồ thị topology. Một contributor không phải là một trong các node của đồ thị — một Feature được gắn tại một boundary thay vì tại một component — thay vào đó mang ở đây danh tính dispatch riêng của trình biên dịch dành cho nó, chính là danh tính mà lời gọi render_node cho contributor đó đã mang; nó phân biệt contributor này với contributor khác và không phải là một tên mà bất kỳ target nào chấp nhận. Thứ mà một contributor như vậy dùng để dẫn xuất tên bên trong artifact đã lắp ráp là một trường mang riêng biệt, derived_name_basis.
typestringcóNhãn component-type của node, được mang trên hình dạng này — khác với projection render theo từng node, vốn giữ lại nó. Đây là siêu dữ liệu mờ chứ không phải công tắc hành vi: nó có ở đây để một assembler có thể nhóm và gắn nhãn các node mà nó hợp nhất, không phải để một guest rẽ nhánh dựa trên nó.
derived_name_basisstringkhôngDanh tính mà contributor này dùng để dẫn xuất các tên riêng của nó bên trong artifact đã lắp ráp — một id logic mà assembler tạo ra cho một trong các mục đã công bố của contributor, một phạm vi theo từng contributor trong một tài liệu đã hợp nhất, tên của một đơn vị con được đặt tại một vị trí riêng. Rỗng nghĩa là id được dùng trực tiếp, đó là giá trị cho một component thông thường. Một contributor có id là một danh tính dispatch mà bảng chữ cái tên của target từ chối sẽ mang trường này một cách tường minh, để artifact đã lắp ráp tham chiếu nội dung của nó bằng một tên mà target chấp nhận, và hai contributor mà tác giả có thể phân biệt không thể xuất hiện dưới cùng một tên. Khi nội dung của contributor được gộp vào một tài liệu mà assembler hợp nhất, đây cũng chính là trường mang mà lời gọi render_node cho contributor đó đã nhận, và việc mang nó ở cả hai nơi là điều giữ cho hai câu trả lời bằng nhau: một tên mà contributor đã khai báo khi render và tên mà tài liệu đã hợp nhất dùng để tham chiếu nội dung đó được dẫn xuất từ một danh tính duy nhất chứ không phải từ hai danh tính tình cờ trùng nhau. Khi contributor thay vào đó được đặt tại một vị trí riêng, đây là danh tính được tạo cho contributor đó — với một Feature gắn vào một component, là danh tính của chính nó chứ không phải của component host mà lần render của nó dựa vào — nên một đơn vị con được đặt cạnh host của nó sẽ được định địa chỉ tách biệt với host.
output_directorystringkhôngThư mục chứa các tệp đã render của contributor này, tương đối so với vị trí riêng của artifact đã lắp ráp, không có dấu phân cách ở cuối. Một guest cần gọi tên các tệp của một contributor từ bên trong artifact đã lắp ráp — đường dẫn nguồn của một khối module, một chỉ thị include — đọc vị trí từ đây thay vì tự ghép một vị trí từ danh tính của contributor, để đường dẫn mà artifact đã lắp ráp trỏ tới chính là đường dẫn mà các tệp đã được ghi vào. Hai thứ này không phải lúc nào cũng cách nhau một thư mục: một contributor mà host đặt bên trong vị trí của một contributor khác nằm sâu hơn các contributor được đặt trực tiếp bên dưới bản lắp ráp. Chỉ có mặt khi provider lắp ráp đặt mỗi contributor dưới một vị trí riêng; một provider gộp các contributor của nó vào một tài liệu duy nhất không đặt thư mục theo từng contributor và không nhận được trường này.
renderedRenderNodeOutputcóPayload mà một guest Provider trả về từ export render_node của nó: các byte đã tuần tự hóa của từng tệp đầu ra mà guest đã phát ra, các tên mà nó đã suy ra vào từng không gian khóa riêng của nó, các dữ kiện mà nó báo cáo về những gì nó đã phát ra, số đơn vị được render mà mỗi mục omit được giao cho nó đã khớp, và mọi chẩn đoán mà guest đưa ra trong khi render. Guest trả về các byte đã tuần tự hóa của từng tệp; host ghi chúng nguyên văn và không chạy bộ tuần tự hóa nào. Tính tất định là trách nhiệm của guest: đầu vào giống hệt nhau phải tạo ra các byte giống hệt nhau.
annotationsmap của stringkhôngCác annotation đã hợp nhất của node, để một boundary assembler có thể xác định vị trí đặt theo từng node (ví dụ: mạng compose được dẫn xuất từ annotation aggrega.ai/namespace).
sync_waveintegerkhôngDeployment wave mà node này kế thừa từ boundary chứa nó (mặc định 0; cho phép giá trị âm), để một boundary assembler có thể sắp thứ tự các contributor mà nó hợp nhất so với nhau. Một dispatch group có thể hợp nhất các contributor từ nhiều boundary, mỗi boundary mang wave riêng, vì vậy wave đi kèm mỗi node ở đây thay vì chỉ một lần cho toàn bộ payload. Một assembler có hình dạng đầu ra không biểu diễn thứ tự nào sẽ bỏ qua nó.
valuesobjectkhôngCác giá trị mà trình biên dịch đã phân giải cho node này, chỉ có mặt đối với một node được render từ một nguồn — lời gọi render_node tạo ra các tệp của nó đã mang một source_listing. Đó là trường hợp duy nhất mà các tệp đến từ nơi khác và các giá trị không thể được ghi vào chúng, nên một vị trí bên ngoài chúng phải cung cấp các giá trị đó: một boundary assembler đặt một dictionary có mặt làm đầu vào của contributor đó ngay trong artifact đã lắp ráp, thay vì bên cạnh các tệp riêng của contributor, và khi artifact đã lắp ráp là vị trí duy nhất mà target đánh giá, đó là sự khác biệt giữa một đầu vào mà target đọc và một đầu vào mà nó không bao giờ chạm tới. Một node được render từ workload_projection hoặc artifacts_projection đã phân giải các giá trị này vào các tệp nó tạo ra, nên nó không mang gì ở đây và trường này vắng mặt: cung cấp chúng lần thứ hai sẽ đưa cho artifact đã lắp ráp những đầu vào mà chính các tệp của node đó không bao giờ khai báo, điều mà target có quyền từ chối. Các khóa đến theo thứ tự đã sắp xếp, không theo thứ tự của tác giả, và chính việc sắp xếp đó khiến payload giống hệt nhau từng byte qua các lần chạy với cùng đầu vào; một guest cần thứ tự khác thì tự áp đặt thứ tự đó. Một assembler có hình dạng đầu ra không mang đầu vào theo từng contributor sẽ bỏ qua trường này.
values_mappedbooleankhôngTrue khi các giá trị mà node này mang là đầu ra của valuesMapping thuộc Recipe hoặc FeatureRecipe được gắn với nó (Recipe của một component, FeatureRecipe của một Feature được gắn), thay vì các giá trị của node được chuyển tiếp nguyên như tác giả đã viết — cùng dấu hiệu mà lời gọi render_node cho node này đã mang trên node projection của nó, được mang ở đây bên cạnh các giá trị mà nó mô tả. Vắng mặt khi không có valuesMapping nào chạy, và ở bất cứ đâu values vắng mặt. Việc một assembler có đọc nó hay không là hợp đồng riêng của assembler đó: một assembler có render_node gắn các giá trị của node đã ánh xạ với các đầu vào mà nguồn của nó khai báo có thể biết từ đây những tên nào mà việc gắn đó đã điền, trong khi một assembler đặt các giá trị của node làm đầu vào bất kể chúng được tạo ra thế nào thì không đọc nó. Nó ghi lại cách các giá trị được tạo ra và không bao giờ được dẫn xuất từ tên của một khóa hay nội dung của một giá trị.

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

RenderEdge

Một cạnh uses có hướng của đồ thị, được nêu tên bằng hai id node của nó: source là node tiêu thụ và target là node được tiêu thụ. Danh sách mang mọi cạnh uses của đồ thị, nên một trong hai đầu có thể là một node nằm ngoài nhóm điều phối này.

Thuộc tínhLoạiBắt buộcMô tả
sourcestringcóId của node tiêu thụ — đầu nguồn của một cạnh uses có hướng.
targetstringcóId của node được tiêu thụ — đầu đích mà một cạnh uses có hướng trỏ tới.

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

SubChart

Một sub-chart đóng góp vào một umbrella chart: định danh instance của nó, phiên bản mà umbrella ghim, các giá trị theo từng instance mà umbrella đặt phạm vi dưới alias của sub-chart, và, đối với một sub-chart được vendor từ một nguồn chart, các byte nguyên bản của tệp Chart.yaml của chart đó. Một bộ lắp ráp umbrella chart xây dựng các dependency và tệp values của umbrella chỉ từ các khung nhìn dữ liệu thuần túy này và không chạm vào hệ thống tệp nào.

Thuộc tínhLoạiBắt buộcMô tả
instance_idstringcóĐịnh danh instance của sub-chart trong nhóm dispatch; umbrella đặt phạm vi cho alias dependency của sub-chart và các giá trị của nó dưới định danh này, để nhiều instance của cùng một chart nguồn vẫn tách biệt.
versionstringkhôngPhiên bản mà umbrella ghim cho sub-chart. Một sub-chart được vendor từ một nguồn chart thì lấy tên và phiên bản dependency từ tệp Chart.yaml của chart đó để dependency khớp; giá trị này áp dụng cho một sub-chart sinh ra không mang chart được vendor nào.
valuesobjectkhôngCác giá trị theo từng instance mà umbrella đặt phạm vi dưới alias của sub-chart trong tệp values.yaml của umbrella. Các khóa đến theo thứ tự đã sắp xếp, không theo thứ tự của tác giả, và chính việc sắp xếp đó làm cho payload giống hệt nhau từng byte qua các lần chạy với cùng đầu vào; một guest cần thứ tự khác thì tự áp đặt thứ tự đó.
chart_yamlstringkhôngCác byte nguyên bản của Chart.yaml của chart được vendor, được đọc từ nguồn cục bộ tại thời điểm biên dịch, từ đó umbrella lấy tên và phiên bản của dependency sub-chart. Rỗng đối với một sub-chart sinh ra không mang chart được vendor nào. Mỗi kit mang chúng trong kiểu trường riêng của mình — dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một string mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.

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

AssembleBoundaryOutput

Payload mà một guest Provider trả về từ export assemble_boundary của nó: các byte đã tuần tự hóa của mỗi tệp được lắp ráp và mọi chẩn đoán mà guest phát ra trong khi lắp ráp. Vị trí các tệp theo từng node của nhóm được lắp ráp không thuộc phản hồi này — đó là một thuộc tính tĩnh của provider, được khai báo một lần trên hợp đồng describe() của nó và có sẵn trước khi bất kỳ node nào được render. Guest trả về các byte đã tuần tự hóa của mỗi tệp; host ghi chúng nguyên văn và không chạy bộ tuần tự hóa nào. Tính tất định là trách nhiệm của guest: đầu vào giống hệt nhau phải tạo ra các byte giống hệt nhau.

Thuộc tínhLoạiBắt buộcMô tả
filesRenderedFile[]cóCác tệp đầu ra được lắp ráp mà guest đã phát ra, theo thứ tự phát ra. Mỗi tệp nêu đường dẫn trên đĩa của nó và mang các byte đã tuần tự hóa mà host ghi nguyên văn.
diagnosticsDiagnostic[]khôngCác chẩn đoán mà guest phát ra trong khi lắp ráp. Mỗi phần tử có hình dạng chẩn đoán dùng chung của Wasm-plugin.
errorstringkhôngMột thông điệp lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với mọi chẩn đoán mà đầu ra mang theo: chẩn đoán báo cáo các vấn đề phát hiện trong một lần chạy vẫn tạo ra kết quả, còn error báo cáo rằng bản thân thao tác đã không hoàn tất. Host hiển thị một error có mặt như một lần gọi plugin thất bại.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

CarveInput

Payload mà một guest Provider nhận được trên export carve tùy chọn của nó: một tệp đầu ra có tên mà pipeline cắt thành các đơn vị có thể định địa chỉ trước khi một bước FeatureRecipe chỉnh sửa một số đơn vị trong đó. Một provider có hình dạng đầu ra mà codec YAML mặc định không thể cắt trực tiếp (ví dụ một chart dùng template) công bố carve và reassemble để kiến thức về hình dạng đầu ra của chính nó nằm trong guest; một provider bỏ qua các export này sẽ mượn codec YAML mặc định của host.

Thuộc tínhLoạiBắt buộcMô tả
namestringcóTên của tệp đầu ra, để codec có thể áp dụng mọi quy tắc cắt theo phạm vi tên.
bodystringcóCác byte của tệp đầu ra cần cắt thành các đơn vị có thể định địa chỉ. Mỗi kit mang chúng trong kiểu trường riêng của mình — dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một string mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.
yaml_indentintegerkhôngĐộ rộng thụt lề mà codec dùng khi phải tổng hợp văn bản có cấu trúc mới; được mang theo để việc cắt của guest khớp với thụt lề trên toàn bộ quá trình render.

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

CarveOutput

Payload mà một guest Provider trả về từ export carve của nó: các đơn vị có thể định địa chỉ, theo thứ tự, mà nó đã cắt tệp thành. Một đơn vị có cấu trúc mang một cây (một đích PATCH); một đơn vị mờ chỉ mang kiểu media và các byte của nó.

Thuộc tínhLoạiBắt buộcMô tả
unitsobject[]cóCác đơn vị có thể định địa chỉ, theo thứ tự, mà guest đã cắt tệp thành.

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

ReassembleInput

Payload mà một guest Provider nhận được trên export reassemble tùy chọn của nó: tệp gốc cùng các đơn vị đã được cắt và các đơn vị đã được vá mà một bước pipeline tạo ra, để guest ghép các thay đổi trở lại vào các byte gốc một cách chính xác. Một token không có trong tập đã vá được nối lại nguyên văn từ các byte gốc của nó; một token đã vá chỉ có các đoạn byte được định địa chỉ của nó bị chỉnh sửa.

Thuộc tínhLoạiBắt buộcMô tả
namestringcóTên của tệp đầu ra, khớp với tên mà chính tệp đó đã được cắt theo.
bodystringcóCác byte của tệp gốc mà quá trình tái hợp ghép các đơn vị đã vá trở lại vào. Mỗi kit mang chúng trong kiểu trường riêng của nó — dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.
segsobject[]khôngCác đơn vị mà tệp đã được cắt thành, đúng như carve đã trả về.
patchedobject[]khôngCác đơn vị mà một bước pipeline đã thay đổi, mỗi đơn vị mang token của nó, cây đã vá và các op đã tạo ra thay đổi.
yaml_indentintegerkhôngĐộ rộng thụt lề mà codec dùng khi một op phải tổng hợp văn bản có cấu trúc mới; được mang theo để quá trình tái hợp khớp với thụt lề áp dụng cho toàn bộ lần render.

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

ReassembleOutput

Payload mà một guest Provider trả về từ export reassemble của nó: các byte của tệp với các đơn vị đã vá được ghép trở lại. Quá trình tái hợp trung thành đến từng byte — mọi byte mà các op không chạm vào đều được giữ nguyên văn.

Thuộc tínhLoạiBắt buộcMô tả
bodystringcóCác byte của tệp đã tái hợp mà host ghi nguyên văn. Mỗi kit mang chúng trong kiểu trường riêng của nó — dạng thô khi kiểu đó là kiểu byte, mã hóa base64 khi đó là một chuỗi mà guest giải mã để khôi phục chúng — và bộ mã hóa được sinh ra chuyển đổi giữa trường và dạng mà wire dùng để mang byte.

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

NameBoundInput

Payload mà một guest Provider nhận được trên export name_bound tùy chọn của nó: một tên mà host đề xuất dùng làm danh tính component của một node, để guest đánh giá theo mọi tên mà nó sẽ suy ra từ danh tính đó cho target của mình, cùng với các dữ kiện về workload đã phân giải của node mà một số tên đó phụ thuộc vào, khi danh tính được xác định sau khi workload đó được phân giải. Guest trả lời bằng một ràng buộc chứ không phải bằng một tên của riêng nó — một tên suy ra được gửi ngược lại sẽ buộc host phải tự ghép tên cho một target mà nó không biết gì, đó chính là điều mà việc đặt câu hỏi loại bỏ. Một provider có target giới hạn hoặc hạn chế các tên mà nó chấp nhận sẽ quảng bá export này; một provider có target chấp nhận mọi tên thì bỏ qua nó và không bao giờ được hỏi, và việc render của nó không thay đổi.

Thuộc tínhLoạiBắt buộcMô tả
proposedstringcóTên mà host đề xuất làm danh tính component của node. Guest suy ra từ nó, trong bộ nhớ, mọi tên mà nó suy ra từ một danh tính component và báo cáo liệu mỗi tên có phải là tên mà target của nó chấp nhận hay không. Một verdict nói về ĐỀ XUẤT chứ không phải về node: host đặt một câu hỏi ở bất cứ đâu nó ghép một danh tính, và nó không cho biết danh tính này rốt cuộc sẽ làm cơ sở cho những tên nào của node đó, nên guest trả lời như thể nó là cơ sở cho tất cả. Đó là hướng thận trọng, vì host chỉ rút ngắn theo câu trả lời và không bao giờ kéo dài — do đó một tên mà thực tế node sẽ suy ra từ một nguồn khác được đánh giá quá chặt chứ không quá lỏng.
authoredbooleankhôngLiệu tên được đề xuất có phải do một người viết ra chứ không phải do trình biên dịch ghép từ các phần được tác giả viết hay không. Nó được mang theo để guest có thể diễn đạt lý do của mình cho người đọc có khả năng hành động dựa trên đó. Nó không quyết định việc từ chối dẫn đến điều gì: một tên do tác giả viết sẽ bị từ chối còn một tên được ghép sẽ bị rút ngắn, và quyết định đó thuộc về host.
workload_formstringkhôngDạng của workload mà Recipe hoặc FeatureRecipe của node phân giải thành, đúng như template workload của nó tạo ra, được mang theo khi danh tính được xác định sau khi workload đó được phân giải và workload nêu một dạng. Nó được mang theo đúng như đã viết; host không diễn giải nó. Một guest có target giới hạn một tên mà nó phát ra chỉ cho một dạng — một job theo lịch, mà target giữ tên ngắn hơn các tên khác vì một hậu tố được nối vào cho mỗi lần chạy — sẽ đọc nó để đánh giá tên đó. Vắng mặt nghĩa là host không mang dạng nào cho câu hỏi này: node không khai báo workload nào, workload của nó không nêu dạng nào, hoặc danh tính được xác định trước khi bất kỳ workload nào được phân giải. Khi đó guest không đánh giá tên nào phụ thuộc vào dạng, và trả lời đúng như khi trường này không tồn tại.
service_keysstring[]khôngCác khóa của những Service mà workload đã phân giải của node khai báo, theo thứ tự workload khai báo chúng, được mang theo khi danh tính được xác định sau khi workload đó được phân giải và workload có khai báo Service nào đó. Một guest có target đặt tên cho mỗi Service mà nó phát ra cho node từ danh tính component và khóa của Service sẽ đọc chúng để đánh giá từng tên như vậy. Một khóa được viết bởi tác giả của Recipe hoặc FeatureRecipe chứ không phải bởi người đã viết danh tính, nên guest cũng diễn đạt lần từ chối mà một khóa gây ra cho tác giả đó. Vắng mặt nghĩa là host không mang khóa nào cho câu hỏi này: node không khai báo workload nào, workload của nó không khai báo Service nào, hoặc danh tính được xác định trước khi bất kỳ workload nào được phân giải. Khi đó guest không đánh giá tên nào được tạo từ một khóa Service, và trả lời đúng như khi trường này không tồn tại.

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

DerivedNameVerdict

Verdict của một loại tên về một danh tính được đề xuất: liệu tên mà guest sẽ suy ra cho loại đó có phải là tên mà target của nó chấp nhận hay không, và — khi một danh tính ngắn hơn sẽ được chấp nhận — độ dài lớn nhất có thể được chấp nhận. Nó mang một ràng buộc và một lý do, không bao giờ mang một tên do guest tạo ra.

Thuộc tínhLoạiBắt buộcMô tả
kindstringcóTên riêng của guest cho loại tên mà verdict này bao quát, được viết theo từ vựng của target chứ không phải của trình biên dịch — tên release của một trình cài đặt chart, tên service của một bộ điều phối container. Nó đến với người đọc nguyên văn trong một lần từ chối, nên nó được viết cho người hiểu target.
usablebooleancóLiệu tên mà guest sẽ suy ra cho loại này từ danh tính được đề xuất có phải là tên mà target chấp nhận hay không.
boundintegerkhôngSố ký tự lớn nhất mà một danh tính được đề xuất có thể có để tên suy ra của loại này là tên mà target chấp nhận. Chỉ có mặt trong một lần từ chối mà một danh tính ngắn hơn sẽ thỏa mãn. VẮNG MẶT nghĩa là độ dài không phải là điều target phản đối — hoặc hoàn toàn không có giới hạn độ dài, hoặc sự phản đối là loại mà không việc rút ngắn nào khắc phục được, chẳng hạn một ký tự mà ngữ pháp của target từ chối ở vị trí nó rơi vào. Do đó vắng mặt khác với giới hạn bằng 0, vốn có nêu một độ dài: rằng không danh tính nào với bất kỳ độ dài nào tạo ra được một tên chấp nhận được của loại này. Host rút ngắn theo giới hạn có mặt và hỏi lại; khi giới hạn vắng mặt thì nó dừng, vì không còn gì để thử.
reasonstringkhôngLý do target không chấp nhận tên suy ra, theo thuật ngữ riêng của target, dành cho người đọc đang quyết định nên viết gì thay thế. Rỗng khi verdict có thể dùng được.

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

NameBoundOutput

Payload mà một guest của Provider trả về từ export name_bound của nó: một phán quyết cho mỗi loại tên mà guest sẽ suy ra từ định danh được đề xuất. Một đề xuất dùng được khi mọi phán quyết đều dùng được; khi có một phán quyết không dùng được, host rút ngắn đề xuất xuống giới hạn nhỏ nhất mà các phán quyết từ chối mang theo rồi hỏi lại, và dừng khi một phán quyết từ chối không mang giới hạn nào. Một danh sách phán quyết rỗng nghĩa là guest không suy ra tên nào từ định danh component, và đó là cùng một câu trả lời với việc chấp nhận đề xuất.

Thuộc tínhLoạiBắt buộcMô tả
namesDerivedNameVerdict[]khôngMột mục cho mỗi loại tên mà guest suy ra từ định danh component, theo thứ tự riêng của guest. Guest báo cáo mọi loại tên mà nó sẽ suy ra chứ không chỉ các loại bị từ chối, để người đọc thấy những tên nào đã được đánh giá và host đọc các mục không cần gọi lần thứ hai để biết phần còn lại.
errorstringkhôngThông báo lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với một phán quyết từ chối: phán quyết báo cáo một tên mà target sẽ không chấp nhận, còn error báo cáo rằng chính câu hỏi không thể được trả lời. Host hiển thị một error có mặt như một lần gọi plugin thất bại.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

RenderedNameInput

Payload mà một guest của Provider nhận được trên export tùy chọn rendered_name của nó: hai định danh mà một target suy ra tên riêng của nó, và những loại đầu vào mà Recipe của node khai báo — source do tác giả cung cấp, một workload do guest tổng hợp. Guest trả lời bằng tên mà target của nó sẽ đặt cho các tài nguyên nó render cho node đó: với source được cung cấp, đó là tên mà các template của chính tác giả render theo, chẳng hạn tên release mà một chart đọc; với một workload được tổng hợp, đó là tên guest đặt cho các tài nguyên nó xây dựng, khi nó suy ra một tên thay vì ghi nguyên định danh của node. Một guest không suy ra tên nào như vậy thì không báo cáo tên nào, đó là câu trả lời trung thực cho một target có tên tài nguyên do một Recipe ghi nguyên văn, và cho một target có tên phụ thuộc vào vị trí đặt các tệp chứ không phụ thuộc vào node. Export này báo cáo một tên do chính guest tạo ra và không phải là trao đổi yêu cầu guest đánh giá một tên mà host đề xuất; đó là hai câu hỏi khác nhau và mỗi câu có export riêng.

Thuộc tínhLoạiBắt buộcMô tả
node_idstringcóĐịnh danh riêng của node, như được tác giả viết. Nó được truyền ở dạng chưa mã hóa: một target thu hẹp nó qua bảng ký tự riêng của mình, nên mã hóa trước sẽ đặt một lớp thoát ký tự bên trong một lớp khác và viết tên khác với tên mà tác giả recipe dự đoán.
derived_name_basisstringkhôngĐịnh danh mà source riêng của một contributor render theo khi nó không phải định danh riêng của node — được đặt cho một contributor có định danh bị bảng ký tự tên của target từ chối, vắng mặt trong các trường hợp khác. Guest phân giải cặp này giống như mọi bề mặt khác: dùng giá trị này khi nó có mặt, dùng id của node khi nó vắng mặt.
sourcedbooleankhôngRecipe được gắn với node có khai báo source do tác giả cung cấp hay không, đọc từ văn bản tác giả đã viết. Nó được truyền cùng với synthesized để câu hỏi có thể được đặt ra cho bất kỳ node nào và được trả lời đúng: guest không báo cáo tên nào cho một node không khai báo cái nào, có đầu ra chỉ là một tập artifact, vì các tài nguyên trong tập như vậy được đặt tên theo các artifact tác giả đã viết chứ không theo tên nào guest suy ra.
synthesizedbooleankhôngRecipe được gắn với node có khai báo một workload để guest tổng hợp hay không, đọc từ văn bản tác giả đã viết, giống như sourced. Một guest có target đặt tên cho các tài nguyên nó tổng hợp theo một tên nó suy ra, thay vì theo định danh của node như đã viết, sẽ báo cáo tên đó cho một node như vậy, để một địa chỉ mà một Recipe công bố cho một trong các tài nguyên đó có thể được xây dựng từ tên mà tài nguyên mang.

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

RenderedNameOutput

Payload mà một guest Provider trả về từ export rendered_name của nó: tên mà target của nó đặt cho các tài nguyên nó render cho node — từ source do tác giả cung cấp của node, hoặc từ workload mà nó tổng hợp — hoặc không có tên nào cả. Một tên vắng mặt hoặc rỗng là một câu trả lời khẳng định chứ không phải một lỗi — nó cho biết target này không suy ra tên như vậy — và host sử dụng những gì nó được cho biết mà không đọc nội dung, nên không có hiểu biết nào về cách đặt tên của target vượt qua ranh giới.

Thuộc tínhLoạiBắt buộcMô tả
namestringkhôngTên mà guest dùng để render source do tác giả cung cấp của node này, hoặc tên mà nó đặt cho các tài nguyên nó tổng hợp cho node, đã được viết sẵn theo bảng ký tự mà target của nó chấp nhận ở vị trí đó. Rỗng hoặc vắng mặt nghĩa là guest không suy ra tên như vậy.
errorstringkhôngThông báo lỗi được đặt khi guest đã chạy nhưng không thể hoàn tất thao tác; vắng mặt khi thành công. Nó khác với việc báo cáo không có tên: không có tên là một câu trả lời về target, còn error báo cáo rằng bản thân câu hỏi không thể được trả lời. Host hiển thị một error có mặt như một lần gọi plugin thất bại.
condition_codestringkhôngĐịnh danh mô tả, có thể so khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó. Được đặt bên cạnh thông báo lỗi dành cho con người; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host phân giải định danh này theo các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, nên một mã đến tay người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ thống đánh số đã loại bỏ, sẽ dừng bản build. Một guest không có điều kiện chính xác để nêu tên thì thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đưa các chi tiết cụ thể vào thông báo của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt một cái mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào, trong khi thông báo vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

LinkEndpoint

Một đầu mút của một liên kết xuyên ranh giới: node, đường dẫn ranh giới mà đầu ra đã render của nó được lắp ráp vào, và provider đã render nó. Hai đầu mút của một liên kết nêu tên đầu tiêu thụ và đầu được tiêu thụ của một cạnh uses có hai đầu được lắp ráp vào các nhóm dispatch khác nhau.

Thuộc tínhLoạiBắt buộcMô tả
nodestringcóId tuyệt đối của node đầu mút trong đồ thị topology.
boundarystringcóĐường dẫn ranh giới của đầu mút — nhóm dispatch mà đầu ra đã render của nó được lắp ráp vào.
providerstringcóProvider đã render đầu mút (tên provider trần). Cả hai đầu mút của một liên kết đã nối đều nêu tên cùng một provider; host không định tuyến một liên kết có các đầu mút nêu tên các provider khác nhau.
releasestringkhôngRelease mà đầu ra đã render của đầu mút thuộc về — phạm vi mà trong đó các artifact đã lắp ráp của nó được đặt tên. Host lắp ráp nó từ Release mà bản build đã phân giải và truyền nguyên văn; nó không suy ra ý nghĩa nào từ giá trị. Một provider đọc nó để giới hạn phạm vi của một tên tham chiếu chéo vào Release. Một giá trị vắng mặt là chuỗi rỗng, mà provider coi là một tên không có phạm vi.

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

LinkEdge

Payload tổng quát, không phụ thuộc vào miền, theo từng cạnh mà host lắp ráp cho một cạnh uses có đầu tiêu thụ và đầu được tiêu thụ được lắp ráp vào các nhóm dispatch khác nhau. Nó mang cả hai đầu mút, các annotation vị trí của cả hai đầu mút dưới dạng map vô hướng mờ mà host không diễn giải, đầu ra provides của đầu mút được tiêu thụ, và socket cùng ánh xạ inject mà cạnh nối. Một provider đọc nó để tạo ra phần nối tham chiếu chéo gốc của provider mà hai đầu cần; host lắp ráp nó và truyền map annotation dưới dạng các giá trị vô hướng mờ, không suy ra ý nghĩa nào từ bất kỳ giá trị nào.

Thuộc tínhLoạiBắt buộcMô tả
sourceLinkEndpointcóĐầu mút tiêu thụ — đầu nguồn của cạnh uses có hướng, nơi phần nối phía bên tiêu thụ được inject vào đầu ra đã lắp ráp của nó.
targetLinkEndpointcóĐầu mút được tiêu thụ — đầu đích mà cạnh uses trỏ tới, nơi phần nối phía bên cung cấp công bố đầu ra đã lắp ráp của nó.
target_annotationsmap của stringkhôngCác annotation vị trí của đầu mút được tiêu thụ (đích) dưới dạng một map vô hướng mờ, với khóa là tên annotation. Host lắp ráp chúng từ các annotation đã phân giải của đích và truyền nguyên văn; nó không suy ra ý nghĩa nào từ bất kỳ giá trị nào. Một provider đọc chúng để quyết định cách định hình một tham chiếu chéo (ví dụ hai đầu có chung một vị trí hay cần một tham chiếu xuyên vị trí). Các khóa được tuần tự hóa theo thứ tự sắp xếp để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.
source_annotationsmap của stringkhôngCác annotation vị trí của đầu mút tiêu thụ (nguồn) dưới dạng một map vô hướng mờ, với khóa là tên annotation. Host lắp ráp chúng từ các annotation đã phân giải của nguồn và truyền nguyên văn; nó không suy ra ý nghĩa nào từ bất kỳ giá trị nào. Một provider đọc chúng để so sánh vị trí của hai đầu — ví dụ nguồn và đích có chung một vị trí hay nằm ở các vị trí khác nhau. Các khóa được tuần tự hóa theo thứ tự sắp xếp để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.
socketstringcóBí danh socket mà cạnh uses được gắn dưới đó.
providesmap của stringcóĐầu ra provides của đầu mút được tiêu thụ, một tập khóa theo thứ tự của tác giả, phơi bày các đầu ra đã khai báo của đích. Giữ nguyên thứ tự của tác giả để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.
injectobjectcóÁnh xạ inject của đầu mút tiêu thụ, với khóa là cơ chế phân phối, trỏ tới một tập khóa theo thứ tự của tác giả, mô tả cách đầu tiêu thụ nhận đầu ra của đầu mút được tiêu thụ. Giữ nguyên thứ tự của tác giả để payload giống hệt nhau từng byte qua các lần chạy với đầu vào giống hệt nhau.
read_provides_keysstring[]khôngCác khóa trong đầu ra provides của endpoint được sử dụng mà template của endpoint sử dụng đọc trực tiếp qua .context.uses, bất kể ánh xạ inject có đồng thời phân phối chúng hay không, theo thứ tự tác giả của provides. Mỗi mục là một trong các khóa mà provides mang. Danh sách đi kèm cạnh để bước publish phía producer và bước resolve phía consumer cùng đọc một danh sách. Vắng mặt khi endpoint sử dụng không đọc trực tiếp khóa provides nào, và một provider không được trao danh sách sẽ nối liên kết đúng như khi trường này không tồn tại.

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

LinkPatch

Một bản vá cấu trúc theo từng tệp mà provider trả về làm phần nối artifact: tệp đầu ra và các thao tác cấu trúc có thứ tự cần áp dụng cho nó. Một lượt xử lý sau của host tách tệp được nêu tên, áp dụng các thao tác và lắp ráp lại nó trung thành từng byte. Dạng thao tác là bộ từ vựng thao tác vá dùng chung của pipeline; nó mờ ở tầng schema này, nên guest mang từng thao tác nguyên văn trong khi host hiện thực hóa thao tác có kiểu mà pipeline của nó áp dụng.

Thuộc tínhLoạiBắt buộcMô tả
filestringcóTệp đầu ra mà các thao tác áp dụng vào, được đặt tên như provider đã xuất ra.
opsany[]cóCác thao tác cấu trúc có thứ tự cần áp dụng cho tệp, theo thứ tự áp dụng.

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

LinkPublishInput

Payload mà một provider nhận được trên export link_publish của nó: một liên kết xuyên ranh giới mà đầu ra của endpoint được tiêu thụ được tham chiếu qua một ranh giới, cùng các tệp đã lắp ráp của endpoint đó. Export trả về danh tính đã công bố mà bên tiêu thụ phân giải theo, và mọi phần nối artifact phía bên sản xuất mà đầu ra của endpoint được tiêu thụ cần.

Thuộc tínhLoạiBắt buộcMô tả
edgeLinkEdgecóLiên kết xuyên ranh giới đang được công bố, đọc từ phía endpoint được tiêu thụ (đích).
producer_filesRenderedFile[]khôngCác tệp đã lắp ráp của endpoint được tiêu thụ, để provider có thể đọc những gì endpoint đó đã khai báo và kiểm tra các tên mà nó sắp công bố với chúng. Mỗi tệp nêu đường dẫn trên đĩa của nó và mang các byte đã lắp ráp. Vắng mặt khi host không có đầu ra đã lắp ráp của bên sản xuất để giao cho thao tác công bố; một provider không cần tài liệu nào để tạo phần nối của nó thì bỏ qua trường này.

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

LinkPublishOutput

Payload mà một provider trả về từ export link_publish của nó: handle danh tính đã công bố mà bên tiêu thụ phân giải theo, và phần nối artifact phía bên sản xuất cần áp dụng cho đầu ra đã lắp ráp của endpoint được tiêu thụ.

Thuộc tínhLoạiBắt buộcMô tả
handlemap của stringcóDanh tính đã công bố mà endpoint được tiêu thụ cung cấp để bên tiêu thụ phân giải theo, một map string con trỏ tất định mờ, có khóa là tên trường (ví dụ một tên export, một tên stack, một region, một tham chiếu role). Các giá trị là các chuỗi con trỏ tất định mà trình biên dịch chuyển tiếp và không bao giờ phân giải; môi trường runtime phân giải chúng lúc triển khai. Các khóa được tuần tự hóa theo thứ tự đã sắp xếp để payload giống hệt nhau đến từng byte qua các lần chạy với đầu vào giống hệt nhau.
patchesLinkPatch[]khôngPhần nối artifact phía bên sản xuất, một bản vá cấu trúc cho mỗi tệp đầu ra của endpoint được tiêu thụ mà thao tác công bố phải chỉnh sửa. Rỗng khi đầu ra của endpoint được tiêu thụ không cần thay đổi gì cho liên kết.
errorstringkhôngThông báo lỗi được đặt khi guest đã chạy nhưng không thể công bố liên kết; vắng mặt khi thành công. Host hiển thị một lỗi có mặt như một lần gọi plugin thất bại. Một thao tác công bố không thể tiếp tục — chẳng hạn một tên export mà stack đã khai báo dưới một mục khác — được báo cáo ở đây thay vì chỉ như một sự cố sập, để điều kiện đằng sau nó có thể được gọi tên.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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

LinkResolveInput

Payload mà một provider nhận được trên export link_resolve của nó: một liên kết xuyên ranh giới, handle danh tính đã công bố mà endpoint được tiêu thụ của nó đã cung cấp, và các tệp đã lắp ráp của endpoint tiêu thụ. Export trả về phần nối artifact phía bên tiêu thụ, phần chèn tham chiếu vào đầu ra đã lắp ráp của endpoint tiêu thụ.

Thuộc tínhLoạiBắt buộcMô tả
edgeLinkEdgecóLiên kết xuyên ranh giới đang được phân giải, đọc từ phía endpoint tiêu thụ (nguồn).
handlemap của stringcóHandle danh tính đã công bố mà link_publish của endpoint được tiêu thụ đã trả về, theo đó bên tiêu thụ phân giải tham chiếu của nó. Các chuỗi con trỏ tất định mờ có khóa là tên trường; trình biên dịch chuyển tiếp chúng và không bao giờ phân giải chúng. Các khóa được tuần tự hóa theo thứ tự đã sắp xếp để payload giống hệt nhau đến từng byte qua các lần chạy với đầu vào giống hệt nhau.
consumer_filesRenderedFile[]khôngCác tệp đã lắp ráp của endpoint tiêu thụ, để provider có thể định vị placeholder mà host đã đóng vào đầu ra tiêu thụ và tạo phần thay thế của nó tại đường dẫn thực của placeholder. Mỗi tệp nêu đường dẫn trên đĩa của nó và mang các byte đã lắp ráp. Vắng mặt khi host không có đầu ra đã lắp ráp của bên tiêu thụ để giao cho thao tác phân giải; một provider không cần tài liệu nào để tạo phần nối của nó thì bỏ qua trường này.

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

LinkResolveOutput

Payload mà một provider trả về từ export link_resolve của nó: phần nối artifact phía consumer cần áp dụng vào đầu ra đã lắp ráp của endpoint tiêu thụ, chèn tham chiếu tới danh tính đã công bố của endpoint được tiêu thụ.

Thuộc tínhLoạiBắt buộcMô tả
patchesLinkPatch[]cóPhần nối artifact phía consumer, mỗi tệp đầu ra của endpoint tiêu thụ mà thao tác resolve phải chỉnh sửa có một bản vá cấu trúc.
errorstringkhôngThông báo lỗi được đặt khi guest đã chạy nhưng không thể resolve liên kết; vắng mặt khi thành công. Host hiển thị một lỗi có mặt dưới dạng một lần gọi plugin thất bại. Một thao tác resolve không thể tiếp tục — một tham chiếu mà đích chỉ có thể mang dưới dạng một giá trị vô hướng nguyên vẹn, lại gặp bên trong một chuỗi lớn hơn — được báo cáo tại đây thay vì chỉ dưới dạng một sự cố sập, để điều kiện đằng sau nó có thể được gọi tên.
condition_codestringkhôngDanh tính mô tả, có thể đối khớp bằng máy, của điều kiện mà lỗi nêu tên — mã mà điều kiện được đăng ký dưới đó, trong cùng tập mở mà trình biên dịch đăng ký các điều kiện dừng của chính nó, và không phải là thành viên của danh mục mã lỗi host-function đóng mà hostfunc_error_code của một phong bì phản hồi lấy từ đó. Được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Một guest dừng sẽ báo cáo ở đây định danh của điều kiện mà thông điệp của nó nêu tên, để bên tiêu thụ rẽ nhánh dựa trên nó thay vì khôi phục một danh tính bằng cách đọc thông điệp. Host phân giải định danh này dựa trên các điều kiện mà trình biên dịch khai báo và công bố các định danh của chính điều kiện đã phân giải trên chẩn đoán có cấu trúc, để một mã đến được với người đọc luôn phân giải được; một định danh không nêu tên điều kiện nào như vậy, hoặc một định danh mà hệ đánh số đã loại bỏ, sẽ làm dừng bản build. Một guest không có điều kiện chính xác nào để nêu tên sẽ thay vào đó dùng một trong các điều kiện lỗi plugin chung mà trình biên dịch khai báo cho mục đích này, và đặt các chi tiết cụ thể vào thông điệp của chính nó. Định danh này và condition_short_code được báo cáo cùng nhau, vì chúng nêu tên một điều kiện dưới hai dạng: một guest đặt cái này mà không đặt cái kia đã nêu tên một điều kiện mà host không thể phân giải, và khi đó host báo cáo điều kiện lỗi plugin chung của chính nó thay vào đó trong khi thông điệp vẫn mang toàn bộ lỗi.
condition_short_codestringkhôngĐịnh danh rút gọn của cùng điều kiện đó — chữ E và bốn chữ số, dạng mà người đọc trích dẫn, tìm kiếm và dán vào một báo cáo — được đặt bên cạnh thông điệp lỗi dành cho người đọc; vắng mặt khi thành công, và vắng mặt khi guest không nêu tên điều kiện nào như vậy. Host in nó trong phần đầu đặt trong ngoặc vuông của chẩn đoán mà nó hiển thị cho lỗi này, để một điều kiện do guest đưa ra có thể được trích dẫn đúng như một điều kiện do trình biên dịch đưa ra. Host phân giải giá trị dựa trên các điều kiện mà trình biên dịch khai báo thay vì tin tưởng mang nó theo: một giá trị không nêu tên điều kiện nào như vậy, một giá trị mà hệ đánh số đã loại bỏ, hoặc một cách viết mà bản đăng ký không mang sẽ làm dừng bản build và trích dẫn giá trị vi phạm, trong khi thông điệp riêng của guest vẫn được báo cáo. Nó được báo cáo cùng với condition_code, vì lý do đã nêu ở đó.

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