Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma du socket Wasm de rendu du Provider d’Aggrega

Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.

Identifiant du schéma : https://aggrega.ai/schemas/wasm-provider-v1beta1.schema.json

Les formes de transmission qu’un socket de plugin de rendu du Provider consomme et émet. Un invité du Provider rend un nœud IR en fichiers de sortie par son export render_node (de RenderNodeInput à RenderNodeOutput) et, facultativement, fusionne les sorties par nœud d’une frontière en un artefact assemblé unique par son export assemble_boundary (de AssembleBoundaryInput à AssembleBoundaryOutput). AssembleBoundaryOutput porte les fichiers assemblés et les éventuels diagnostics ; l’emplacement des fichiers de chaque contributeur est déclaré une seule fois dans le contrat describe() de l’invité plutôt que dans cette réponse. Un invité peut aussi déclarer un export facultatif validate_node_input qui vérifie structurellement l’entrée résolue d’un nœud avant la distribution du rendu : il consomme la même projection RenderNodeInput que reçoit render_node et renvoie un ValidateNodeOutput qui ne porte que des diagnostics — un diagnostic de sévérité halt arrête le build de manière explicite, un diagnostic de sévérité warn est présenté dans l’issue du build. Un invité dont la cible borne ou restreint les noms qu’elle accepte peut aussi déclarer un export facultatif name_bound, que l’hôte interroge avant d’arrêter l’identité de composant d’un nœud : il consomme un NameBoundInput qui porte un nom proposé et renvoie un NameBoundOutput qui porte un verdict par type de nom que l’invité en dériverait. Un verdict porte une contrainte — utilisable, ou borné à une longueur plus courte — et jamais un nom construit par l’invité, de sorte que la connaissance de ce que la cible accepte reste dans l’invité. Par ailleurs, un invité dont la cible dérive un nom qui lui est propre pour les ressources qu’il rend — à partir d’une source fournie par l’auteur, ou d’un workload qu’il synthétise — peut déclarer un export facultatif rendered_name, que l’hôte interroge afin que l’auteur d’une Recipe puisse lire ce nom et publier une adresse construite à partir de lui : il consomme un RenderedNameInput qui porte les identités dont la cible dérive et les types d’entrée que déclare la Recipe du nœud, et renvoie un RenderedNameOutput qui porte le nom sous lequel l’invité lui-même effectuera le rendu, ou aucun nom lorsqu’il n’en dérive aucun. Les deux exports sont des directions opposées d’un même sujet et aucun ne remplace l’autre — name_bound demande à l’invité de juger un nom que l’hôte propose, tandis que rendered_name signale un nom que l’invité a composé, que l’hôte porte sans le lire. Un invité peut aussi déclarer carve et reassemble, qui découpent sa propre sortie en unités adressables pour une étape de pipeline et réassemblent les unités modifiées par patch, ainsi que link_publish et link_resolve, qui câblent une arête uses dont les extrémités s’assemblent dans des groupes de distribution différents. La forme de chaque payload est la définition que nomme son export : la table x-aggrega-exports associe chaque export avec lequel l’hôte appelle un invité — carve et reassemble compris — à la définition de son entrée et à la définition de sa sortie, chacune sous la forme d’un JSON Pointer dans les $defs de ce document, de sorte qu’un outil qui valide un payload y recherche sa définition. La racine du document ne déclare aucune forme propre, car un même document peut être un payload valide de plusieurs exports (un objet vide est une réponse valide de validate_node_input, de name_bound et de rendered_name à la fois). L’invité renvoie les octets sérialisés de chaque fichier de sortie ; l’hôte les écrit tels quels et n’exécute aucun sérialiseur, si bien que le déterminisme est de la responsabilité de l’invité : une entrée identique doit produire des octets identiques. Les types de payload Go, Rust et TypeScript sont générés à partir de ce schéma dans les paquets de l’ABI des plugins, de sorte que les trois langages lisent et écrivent le même format de transmission ; un invité les importe depuis ces paquets, ou via son kit de plugin lorsque le kit les réexporte.

Exports

La table x-aggrega-exports du schéma associe chaque export avec lequel l’hôte appelle un invité à la définition de son entrée et à la définition de sa sortie. La forme d’un payload est la définition que nomme son export.

ExportEntréeSortie
render_nodeRenderNodeInputRenderNodeOutput
validate_node_inputRenderNodeInputValidateNodeOutput
assemble_boundaryAssembleBoundaryInputAssembleBoundaryOutput
carveCarveInputCarveOutput
reassembleReassembleInputReassembleOutput
name_boundNameBoundInputNameBoundOutput
rendered_nameRenderedNameInputRenderedNameOutput
link_publishLinkPublishInputLinkPublishOutput
link_resolveLinkResolveInputLinkResolveOutput

Définitions

RenderNodeInput

Le payload qu’un invité du Provider reçoit par son export render_node : la projection IR par nœud que l’invité rend, le contexte du moment du rendu, les entrées pré-évaluées que déclare la Recipe liée au nœud — une liste de la source acquise, un workload, un ensemble d’artefacts — chacune présente uniquement lorsque cette Recipe la déclare, et les entrées nommant les unités rendues que l’invité exclut d’un rendu de source.

PropriétéTypeObligatoireDescription
nodeIRNodeProjectionouiLes données IR par nœud qu’un invité du Provider rend — une projection bornée du nœud IR complet qui porte l’identité par nœud et la provenance que l’invité estampille sur chaque manifeste émis : son id, son type, la recette résolue, les valeurs, si un mappage des valeurs a produit ces valeurs, les rattachements de feature, le marquage de sensibilité sur ses clés rendues et sur les valeurs dans leur ensemble, les arêtes uses sortantes, le chemin de frontière, la sync wave, l’identité de la Recipe, la surcharge de l’identifiant de composant, la base du nom dérivé et la provenance du build. L’identité et la base du nom dérivé sont portées séparément parce qu’elles répondent à deux questions — à quoi appartient une ressource, et par rapport à quoi la source propre d’un auteur est rendue — et un rattachement de Feature qui livre une source écrite par son auteur est le cas où les deux réponses diffèrent. Le contenu des fichiers source n’est pas porté ici ; il voyage séparément dans la projection de la source. Chaque ensemble de clés ici a un ordre fixe — features et uses dans l’ordre de l’auteur, values et le marquage de sensibilité dans l’ordre trié des clés — de sorte que le payload transmis est identique à l’octet près d’une exécution à l’autre pour une entrée identique.
contextobjectouiLe contexte du moment du rendu que l’hôte remet à l’invité, transmis sous la forme des octets de son document JSON ; ce schéma laisse l’objet non déclaré. C’est le contexte que reçoit une étape de pipeline du même nœud, plus la largeur d’indentation : parameters, les valeurs de paramètres de la Release triées par nom, absentes lorsqu’il n’y en a aucune ; annotations, les annotations du nœud réparties selon l’endroit où chacune a été écrite en aggregate, release et catalog, chacun absent lorsqu’il est vide ; boundary, la frontière dans laquelle se trouve le nœud : name, path (ses segments), sync_wave (absent lorsqu’il vaut 0), directory, sub_directory (absent lorsqu’il n’y en a pas) et annotations (l’ensemble que les frontières de la Release propagent en cascade jusqu’au nœud, avec sa propre entrée de la Release appliquée en dernier ; absent lorsqu’il est vide) ; et yaml_indent, la largeur d’indentation commune à tout le rendu avec laquelle l’invité sérialise sa sortie. Le rendu d’une FeatureRecipe de portée frontière, qui n’a aucun composant hôte, reçoit le contexte que reçoit son étape de pipeline, plus yaml_indent : parameters ; annotations, qui ne porte que le compartiment release, lequel est l’ensemble d’annotations propre de la frontière ; et un boundary qui porte son name, son path et ce même ensemble comme ses annotations. Les annotations bien connues aggrega.ai/* sont lues dans le compartiment aggregate avec le compartiment release écrit par-dessus, de sorte qu’une clé que portent les deux prend la valeur de la Release ; un fournisseur de la bibliothèque standard les lit dans cet ensemble superposé et jamais dans le compartiment catalog, de sorte qu’une valeur du catalogue n’en décide jamais aucune, et une FeatureRecipe de portée frontière, dont le contexte ne porte aucun compartiment aggregate, effectue le rendu selon les valeurs de sa frontière plutôt que selon celles d’un composant quelconque.
source_listingSourceListingnonL’énumération générique de la source acquise que l’hôte remet à l’invité pour un fournisseur à source : la racine de la source, si cette racine est un répertoire, et les entrées triées relatives à la racine qui se trouvent en dessous. L’hôte ne lit ici aucun contenu de fichier — il ne liste que des noms. L’invité applique sa propre logique de résolution à la liste et demande à l’hôte d’empaqueter une sélection choisie au moyen de la fonction hôte pack-source, de sorte que toute l’intelligence de résolution de source propre à chaque fournisseur réside dans l’invité. Présent pour les fournisseurs à source ; absent sinon.
workload_projectionWorkloadProjectionnonLe workload pré-évalué que l’hôte remet à l’invité pour qu’il en synthétise des manifestes natifs du fournisseur ; présent lorsque la Recipe liée déclare un workload plutôt qu’une source de chart, absent sinon.
artifacts_projectionArtifactsProjectionnonL’ensemble d’artefacts pré-évalué que l’hôte remet à l’invité pour qu’il le place dans la sortie du nœud, présent lorsque la Recipe liée déclare des artefacts. L’hôte a déjà lu la source de chaque entrée, l’a évaluée comme un template Go par rapport au contexte de rendu et a calculé les ensembles de clés de la provenance du build ; l’invité décide du format de sortie, du placement de la provenance, du chemin sur disque et des octets finaux. Absent lorsque le nœud ne déclare aucun artefact.
omitsOmitEntry[]nonLes entrées nommant les unités rendues que l’invité exclut de la sortie de ce nœud, dans l’ordre dans lequel l’auteur les a déclarées. Chaque entrée arrive résolue, ses champs étant de simples chaînes, et une entrée qui ne s’applique pas à ce build n’est pas portée. Ce que sélectionnent le kind, le name, le namespace et le subchart d’une entrée relève du contrat documenté propre à ce fournisseur, et non de celui de ce socket : l’invité confronte chaque entrée à ce qu’il a rendu dans les termes de son propre format, exclut chaque unité à laquelle correspond une entrée de tout ce qu’il renvoie — ses fichiers, les noms qu’il déclare dans derived_keys et les faits qu’il signale dans render_facts — et indique dans omitted de la sortie à combien d’unités chaque entrée a correspondu. Les entrées accompagnent une liste de source et aucune autre donnée d’entrée : un rendu d’un workload synthétisé ou d’un ensemble d’artefacts ne les porte jamais. Absent lorsqu’il n’y a aucune entrée, et un invité qui n’en reçoit aucune effectue le rendu exactement comme il le ferait si le champ n’existait pas.

Les propriétés supplémentaires ne sont pas autorisées.

IRNodeProjection

Les données IR par nœud qu’un invité du Provider rend — une projection bornée du nœud IR complet qui porte l’identité par nœud et la provenance que l’invité estampille sur chaque manifeste émis : son id, son type, la recette résolue, les valeurs, si un mappage des valeurs a produit ces valeurs, les rattachements de feature, le marquage de sensibilité sur ses clés rendues et sur les valeurs dans leur ensemble, les arêtes uses sortantes, le chemin de frontière, la sync wave, l’identité de la Recipe, la surcharge de l’identifiant de composant, la base du nom dérivé et la provenance du build. L’identité et la base du nom dérivé sont portées séparément parce qu’elles répondent à deux questions — à quoi appartient une ressource, et par rapport à quoi la source propre d’un auteur est rendue — et un rattachement de Feature qui livre une source écrite par son auteur est le cas où les deux réponses diffèrent. Le contenu des fichiers source n’est pas porté ici ; il voyage séparément dans la projection de la source. Chaque ensemble de clés ici a un ordre fixe — features et uses dans l’ordre de l’auteur, values et le marquage de sensibilité dans l’ordre trié des clés — de sorte que le payload transmis est identique à l’octet près d’une exécution à l’autre pour une entrée identique.

PropriétéTypeObligatoireDescription
idstringouiL’identifiant absolu du nœud dans le graphe de topologie.
typestringouiDéclaré et délibérément retenu : l’hôte l’émet toujours comme chaîne vide. L’étiquette de type de composant du nœud est une métadonnée opaque plutôt qu’un commutateur de comportement, si bien que la porter ici ne ferait qu’inciter un invité à brancher son comportement sur elle. Un invité lit une chaîne vide et ne doit pas l’interpréter comme un nœud dont le type de composant n’est pas défini. (La forme de nœud d’assemblage de frontière porte un type qui lui est propre, dans un autre but.)
resolved_recipestringouiDéclaré et délibérément retenu : l’hôte l’émet toujours comme chaîne vide. L’identité de la Recipe liée atteint déjà l’invité sous la forme du nom et de la version de recette qu’il estampille dans la provenance, si bien que l’URI résolu n’ajoute rien à partir de quoi un invité effectue le rendu. Un invité qui doit attribuer une sortie à une Recipe lit plutôt ces champs de provenance.
valuesobjectnonLe dictionnaire des valeurs rendues du nœud, l’ensemble de clés à partir duquel l’invité effectue le rendu. Les clés arrivent triées, et non dans l’ordre de l’auteur, et c’est ce tri qui rend le payload identique à l’octet près d’une exécution à l’autre pour une entrée identique ; un invité qui a besoin d’un autre ordre l’impose lui-même.
featuresobjectnonLes rattachements de feature du nœud, indexés par alias de feature, qui portent la même forme de rattachement de feature par nœud que porte l’IR. Chaque entrée porte les values, l’infra et le mappage inject du rattachement avec son marquage de sensibilité dérivé, de sorte qu’un invité lit à partir du seul payload si un rattachement traite du matériel déclaré sensible. Préserve l’ordre de l’auteur, de sorte que le payload est identique à l’octet près d’une exécution à l’autre pour une entrée identique. Opaque à ce niveau du schéma ; l’invité lit la forme de l’entrée de feature via le contrat de transmission de l’IR.
sensitive_rendered_keysmap de stringnonClés rendues dont l’identité est récupérée à partir d’une donnée qu’un auteur a déclarée sensible, chacune associée à la déclaration dont elle a hérité cette sensibilité. Circule de l’hôte vers l’invité dans l’entrée de rendu — la direction opposée à celle des noms qu’un invité déclare dans la sortie de rendu. Ce qu’une clé nomme suit la forme que porte ce payload : sur un payload qui porte les valeurs du nœud, c’est l’une des clés de cette map ; sur un payload qui porte un workload, elle nomme une entrée dans les maps de rattachement propres au workload, où les valeurs du nœud sont vides. Une clé n’est présente que là où la récupération est exacte, reliant une déclaration à une identité rendue sans rien lire du texte propre de la clé et sans répartir sur des clés individuelles un marquage par nœud ou par rattachement. Une clé inventée par un template est donc absente, car aucune déclaration ne la nomme : les clés de sortie du valuesMapping d’une recette, et le contenu d’un artefact, sont rédigés par des templates, si bien qu’aucun des deux ne produit de clé ici — le fait qu’un tel payload ait été produit à partir d’une valeur déclarée sensible est porté à la place par sensitive_values, et par le sensitive_content propre d’une entrée d’artefact. L’absence indique donc que l’identité d’aucune clé n’a pu être récupérée, jamais que rien sur ce payload ne porte de matériel sensible — un invité qui lit une clé absente comme une permission d’afficher ou d’émettre une valeur en clair l’a lue à l’envers. Les clés arrivent triées, ce qui rend le payload identique à l’octet près d’une exécution à l’autre pour une entrée identique.
sensitive_valuesbooléennonVrai lorsque les valeurs que porte ce payload ont été produites par un template qui lit une valeur qu’un auteur a déclarée sensible, ou une valeur qui remonte à une telle valeur : le valuesMapping d’une Recipe ou d’une FeatureRecipe, un template unique dont les clés et les valeurs de sortie sont sa propre invention, si bien qu’aucune clé de cette sortie ne peut être ramenée à la donnée dont elle provient et que la map entière est marquée à la place. Il est lu à partir des propres références du template confrontées aux déclarations — une référence qui atteint une valeur déclarée, le template qui transmet la totalité de ses données, ou un template qui ne s’analyse pas comptent tous — et jamais à partir du contenu d’une valeur ou du nom d’une clé. Un invité qui compose un texte destiné à une personne, un refus ou un avertissement, tient chaque valeur des valeurs du nœud hors de ce texte lorsque ceci est vrai, et tient hors de ce texte la valeur sous toute clé que nomme sensitive_rendered_keys, que ce soit le cas ou non : les deux se composent, l’un nommant les clés dont l’identité est récupérée exactement et celui-ci couvrant la map là où aucune ne peut l’être. Absent lorsqu’aucun template de ce type n’a lu une telle valeur, ce qui inclut les valeurs qui sont elles-mêmes les feuilles déclarées, marquées à la place clé par clé dans sensitive_rendered_keys, et absent sur un payload qui ne porte aucune valeur. L’absence n’indique jamais qu’aucune valeur n’est sensible.
values_mappedbooléennonVrai lorsque les valeurs que porte ce payload sont la sortie du valuesMapping de la Recipe ou de la FeatureRecipe liée, plutôt que les valeurs du nœud transmises telles que l’auteur les a écrites. Un invité dont le propre contrat lie aux entrées que déclare sa source uniquement les valeurs produites par un mappage lit ce champ, et laisse non lues les valeurs écrites pour autre chose, comme les artefacts de la Recipe ; un invité qui lie les valeurs du nœud à sa source quelle que soit la façon dont elles ont été produites ne le lit pas. Il enregistre la façon dont les valeurs ont été produites et n’est jamais dérivé du nom d’une clé ni du contenu d’une valeur. Absent là où aucun valuesMapping n’a été exécuté, et sur un payload qui ne porte aucune valeur.
usesmap de string[]nonDéclaré et délibérément retenu : l’hôte ne le renseigne jamais, si bien que la map est absente de chaque payload de rendu. Une arête sortante est consommée avant la distribution — les valeurs publiées de l’arête sont réhydratées dans le pipe inject propre au nœud, que la Recipe a déjà évalué en les valeurs et le workload que reçoit l’invité — et un invité qui assemble une frontière reçoit à la place la liste des arêtes sur sa propre entrée. S’il était renseigné, il indexerait les arêtes uses sortantes du nœud par alias de socket, chacune portant les identifiants ordonnés des nœuds cibles de ce socket dans l’ordre de l’auteur.
boundary_pathstringnonLe chemin de frontière du nœud, estampillé comme annotation aggrega.ai/boundary-path sur chaque manifeste émis qui porte un bloc metadata.
sync_waveintegernonLa vague de déploiement héritée de la frontière qui contient ce nœud (0 par défaut ; valeurs négatives autorisées), qui porte la valeur que le nœud IR détient sous la forme sync_wave. Ce qu’un invité en fait relève de son propre choix, et enregistrer la valeur et ordonner selon elle sont indépendants plutôt qu’alternatifs — un invité peut faire l’un ou l’autre, les deux ou aucun. Parmi les fournisseurs de la bibliothèque standard : helm et helm-chart l’émettent sous forme d’annotation argocd.argoproj.io/sync-wave sur chaque ressource rendue, et en outre sous forme de helm.sh/hook-weight sur une ressource que le chart marque déjà comme hook Helm ; compose l’enregistre comme label de service et ordonne les services du fichier dans lequel il effectue le rendu, au moyen de depends_on entre eux ; cloudformation ordonne le provisionnement de la stack assemblée, en déclarant que chaque ressource d’une vague dépend des ressources de la vague précédente ; terraform ordonne les blocs de module de la configuration racine dans laquelle une frontière s’assemble, en déclarant que chaque module d’une vague dépend des modules de la vague précédente, et l’enregistre aussi avec la provenance du build du nœud.
recipe_namestringnonLe nom de la Recipe liée, associé à recipe_version pour former l’annotation aggrega.ai/recipe-uri ; lorsque l’une des deux moitiés est vide, l’annotation n’est pas estampillée.
recipe_versionstringnonLa version de la Recipe liée, associée à recipe_name pour former l’annotation aggrega.ai/recipe-uri ; lorsque l’une des deux moitiés est vide, l’annotation n’est pas estampillée.
label_component_idstringnonL’identité de composant compatible avec Kubernetes — ce à quoi APPARTIENT une ressource qu’émet ce nœud, c’est-à-dire ce que la provenance enregistre et ce qu’un sélecteur interroge. Lorsqu’elle n’est pas vide, elle remplace l’identifiant du nœud comme valeur des labels app.kubernetes.io/name et aggrega.ai/component-id ; vide signifie que l’identifiant du nœud est déjà valide comme label et qu’il est utilisé directement. Elle est portée pour chaque ressource qu’émet un rattachement de Feature, quelle que soit la façon dont le rattachement les livre, de sorte que les ressources d’un rattachement se distinguent de celles de son composant hôte par le seul label. Ce à partir de quoi un invité dérive ses propres noms est porté séparément, derived_name_basis, et les deux répondent à des questions différentes.
derived_name_basisstringnonL’identité à partir de laquelle un invité dérive ses propres noms — le nom de release que lisent les templates d’un installateur de chart, d’après lequel un tel invité peut aussi nommer les ressources qu’il synthétise pour un composant, et le préfixe des fichiers qu’émet un rendu de source. Vide signifie que l’identifiant du nœud est utilisé directement, ce qui est la valeur pour un composant ordinaire et pour un rattachement de Feature par composant : un rattachement qui livre un chart ou un fragment écrit par son auteur le rend par rapport au nom du composant HÔTE, parce que les propres templates de l’auteur nomment les ressources d’après ce nom et qu’un nom différent renommerait des ressources déjà déployées. Un nœud dont l’identifiant porte une syntaxe de marqueur que l’alphabet de noms d’une cible refuse porte celle-ci explicitement à la place, de sorte que le nom que dérive un invité reste un nom que la cible accepte. Elle est délibérément distincte de label_component_id : un invité qui CONSTRUIT des ressources pour un rattachement de Feature plutôt que de rendre la source de son auteur les nomme d’après l’identité, de sorte que les ressources propres du rattachement ne peuvent pas entrer en collision avec celles de son hôte, tandis que le nom par rapport auquel la source d’un auteur est rendue ne change pas. Les deux portent la même valeur partout où l’identité d’un nœud est aussi ce par rapport à quoi sa source est rendue.
output_labelsmap de stringnonLes labels de sortie déclarés par l’auteur de la recette que l’invité estampille sur chaque manifeste émis à côté de la provenance de l’identité du build, indexés par nom de label. Deux blocs rédigés par l’auteur fusionnent dans cette map unique : les paires clé-valeur littérales qu’une recette écrit dans outputLabels, et une entrée pour chaque clé qu’une recette nomme dans outputComponentLabels, dont la valeur est lue sur cette clé dans les propres labels du composant rendu — de sorte qu’une valeur promue suit le composant dont elle provient au lieu d’être répétée dans la recette. Les deux blocs sont disjoints de l’espace de clés de la provenance par la validation au chargement (aucune clé aggrega.ai/ ou app.kubernetes.io/), si bien que l’estampillage n’entre jamais en collision avec un label de provenance. Une clé promue que le composant ne déclare pas n’estampille rien et émet un avertissement plutôt qu’un label vide. Un invité dont la sortie n’est pas du YAML Kubernetes les transpose sur sa propre surface de labels (labels de service Compose) ou les ignore.
provenanceNodeProvenanceouiLa provenance de l’identité du build que l’invité estampille sur chaque manifeste émis sous forme de labels aggrega.ai.

Les propriétés supplémentaires ne sont pas autorisées.

NodeProvenance

La provenance de l’identité du build pour un nœud — l’identité du compilateur, de l’agrégat et de l’environnement que l’invité estampille sur chaque manifeste émis sous forme de labels aggrega.ai. Chaque champ est omis lorsqu’il est vide, de sorte qu’une identité partielle n’estampille que les labels qu’elle porte.

PropriétéTypeObligatoireDescription
compiler_versionstringnonLa version du compilateur, estampillée comme label aggrega.ai/compiler-version lorsqu’elle n’est pas vide.
aggregate_namestringnonLe nom de l’agrégat, estampillé comme label aggrega.ai/aggregate-name lorsqu’il n’est pas vide.
environmentstringnonLe nom de l’environnement, estampillé comme label aggrega.ai/environment lorsqu’il n’est pas vide.
provider_namestringnonLe type de fournisseur seul, estampillé comme label aggrega.ai/provider lorsqu’il n’est pas vide.
provider_versionstringnonLa version résolue du plugin de rendu du fournisseur, estampillée comme label aggrega.ai/provider-version lorsqu’elle n’est pas vide.

Les propriétés supplémentaires ne sont pas autorisées.

RenderNodeOutput

Le payload qu’un invité du Provider renvoie depuis son export render_node : les octets sérialisés de chaque fichier de sortie que l’invité a émis, les noms qu’il a dérivés dans chacun de ses propres espaces de clés, les faits qu’il signale sur ce qu’il a émis, à combien d’unités rendues chaque entrée omits qui lui a été remise a correspondu, et les éventuels diagnostics que l’invité a levés pendant le rendu. L’invité renvoie les octets sérialisés de chaque fichier ; l’hôte les écrit tels quels et n’exécute aucun sérialiseur. Le déterminisme est de la responsabilité de l’invité : une entrée identique doit produire des octets identiques.

PropriétéTypeObligatoireDescription
filesRenderedFile[]ouiLes fichiers de sortie que l’invité a émis, dans l’ordre d’émission. Chacun nomme son chemin sur disque et porte les octets sérialisés que l’hôte écrit tels quels.
derived_keysmap de string[]nonLes noms que l’invité a dérivés pendant le rendu de ce nœud, indexés par l’espace de clés dans lequel il les a dérivés, chaque espace portant ses noms dans l’ordre de dérivation. Un invité qui dérive le nom par lequel sa sortie adresse une ressource a placé ce nom dans les octets du fichier que l’hôte écrit tels quels, là où l’hôte ne peut pas le voir ; le déclarer ici est la façon dont l’invité demande à l’hôte de confirmer que deux dérivations n’ont pas abouti au même nom. L’hôte compare l’égalité des noms déclarés au sein d’un même espace déclaré et ne fait rien d’autre — il n’analyse pas un nom, n’apprend pas ce que signifie un espace ou un nom, et n’en dérive jamais un lui-même. Deux contributeurs à la même sortie assemblée qui déclarent le même nom dans le même espace arrêtent le build, et l’arrêt nomme l’espace, le nom et les deux contributeurs. Les noms des espaces comme les noms qu’ils contiennent sont le vocabulaire propre de l’invité : un invité qui souhaite l’unicité sur une portée plus étroite ou plus large qu’une sortie assemblée exprime cette portée dans le nom d’espace qu’il déclare. Préserve l’ordre de déclaration, de sorte que le payload est identique à l’octet près d’une exécution à l’autre pour une entrée identique. Absent lorsque l’invité ne dérive aucun nom qu’il souhaite faire vérifier, ce qui laisse la vérification inerte pour cet invité.
render_factsRenderFact[]nonLes faits que l’invité signale sur ce qu’il a émis pour ce nœud, dans l’ordre dans lequel l’invité les liste. Chaque fait associe un nom à une valeur, et tous deux relèvent du vocabulaire propre de l’invité : les faits qu’un fournisseur signale, ce que signifie chaque nom et ce que contiennent ses entrées font partie du contrat documenté de ce fournisseur, et non de celui de ce socket. La valeur de chaque fait est une liste, même lorsqu’elle contient une seule entrée : l’hôte refuse un fait dont la valeur est autre chose, en nommant le fournisseur et le fait, et arrête le build. C’est la seule chose que l’hôte apprend sur une valeur. Il indexe les faits par nom et remet chaque liste aux templates qui la lisent, en joignant les listes d’un même nom signalées par plus d’un rendu du même nœud dans l’ordre dans lequel ces rendus ont été exécutés, et il n’apprend jamais ce que signifie un nom ou une entrée et ne dérive jamais un fait lui-même — de sorte qu’un fournisseur peut signaler quelque chose que seule sa propre connaissance du format peut voir, comme une propriété des documents qu’il a écrits, sans que l’hôte apprenne ce format. Signaler des faits ne change jamais ce qui est écrit : les fichiers que l’hôte écrit sont les fichiers que l’invité a renvoyés, que des faits les accompagnent ou non. L’invité liste ses faits dans un ordre fixe, de sorte que le payload est identique à l’octet près d’une exécution à l’autre pour une entrée identique. Absent lorsque l’invité ne signale rien, ce qui est une réponse complète et non une réponse manquante.
omittedinteger[]nonÀ combien d’unités rendues a correspondu chaque entrée de omits fournie en entrée : un nombre par entrée remise à l’invité, dans le même ordre, chacun étant le nombre d’unités auxquelles cette entrée a correspondu, qu’une autre entrée leur ait également correspondu ou non. Un nombre égal à zéro est une réponse complète — l’entrée n’a correspondu à rien de ce que l’invité a rendu. Les nombres sont tout ce que le socket rapporte sur ce qui a été laissé de côté : les unités elles-mêmes sont simplement absentes de ce que l’invité a renvoyé. Absent lorsque l’invité n’a reçu aucune entrée.
diagnosticsDiagnostic[]nonDiagnostics que l’invité a levés pendant le rendu. Chaque élément a la forme de diagnostic partagée des plugins Wasm.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. Il est distinct des éventuels diagnostics que porte la sortie : les diagnostics signalent des problèmes trouvés pendant une exécution qui a malgré tout produit un résultat, tandis que error signale que l’opération elle-même ne s’est pas terminée. L’hôte présente une erreur présente comme une invocation de plugin échouée.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

ValidateNodeOutput

Le payload qu’un invité du Provider renvoie depuis son export facultatif validate_node_input : les diagnostics soulevés par une vérification structurelle de l’entrée résolue du nœud. L’export consomme la même projection RenderNodeInput que reçoit render_node et n’émet aucun fichier — il ne fait que signaler des diagnostics. Un diagnostic de sévérité halt arrête le build de manière explicite, en nommant le nœud et le fournisseur ; un diagnostic de sévérité warn ou info est présenté dans l’issue du build sans modifier la sortie rendue. Une liste de diagnostics vide signifie que l’entrée a passé la vérification structurelle.

PropriétéTypeObligatoireDescription
diagnosticsDiagnostic[]nonDiagnostics soulevés par l’invité lors de la validation de l’entrée du nœud. Chaque élément est la forme de diagnostic partagée des plugins Wasm. Vide lorsque l’entrée a passé la vérification structurelle.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. Il est distinct des éventuels diagnostics que porte la sortie : les diagnostics signalent des problèmes trouvés pendant une exécution qui a malgré tout produit un résultat, tandis que error signale que l’opération elle-même ne s’est pas terminée. L’hôte présente une erreur présente comme une invocation de plugin échouée.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

RenderedFile

Un fichier de sortie qu’un invité du Provider a émis : son chemin sur disque relatif à la racine de sortie du nœud, et ses octets sérialisés exactement tels que l’invité les a produits. L’hôte écrit ces octets tels quels et n’exécute aucun sérialiseur, de sorte que la sortie sur disque est identique à l’octet près à ce que l’invité a émis.

PropriétéTypeObligatoireDescription
pathstringouiLe chemin du fichier de sortie relatif à la racine de sortie du nœud (par exemple Chart.yaml ou templates/deployment.yaml).
contentstringouiLes octets sérialisés du fichier exactement tels que l’invité les a produits ; l’hôte écrit ces octets tels quels et n’exécute aucun sérialiseur, de sorte que la sortie est identique à l’octet près à ce que l’invité a émis. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.
formatstringnonLe format dans lequel l’invité déclare que le fichier émis a été rendu, afin que l’hôte puisse acheminer le fichier vers un parseur correspondant. Absent lorsque l’invité ne déclare aucun format, auquel cas l’hôte déduit le format de l’extension du fichier.

Les propriétés supplémentaires ne sont pas autorisées.

RenderFact

Un fait qu’un invité du Provider signale sur ce qu’il a émis pour un nœud : un nom et une liste d’entrées, tous deux définis et documentés par le fournisseur. L’hôte porte le fait tel que l’invité l’a écrit, refuse un fait dont la valeur n’est pas une liste, et n’apprend rien d’autre sur l’une ou l’autre moitié.

PropriétéTypeObligatoireDescription
namestringouiLe nom du fait, tiré du vocabulaire documenté propre au fournisseur.
valuearrayouiLa valeur du fait : un tableau JSON — toujours une liste, même avec une seule entrée ou aucune — dont les entrées sont des valeurs JSON quelconques dans la forme que le fournisseur documente pour ce nom. Une liste est ce qui permet à un nom d’être signalé par plus d’un rendu d’un nœud : l’hôte joint les listes en une seule. Elle est portée comme le document JSON que l’invité a écrit, octet par octet, de sorte que l’ordre des entrées de la liste et des clés de chaque objet est celui de l’invité.

Les propriétés supplémentaires ne sont pas autorisées.

OmitEntry

Une entrée nommant les unités rendues qu’un invité du Provider exclut de la sortie d’un nœud, ses champs déjà résolus en simples chaînes et marqués lorsque l’un d’eux a été produit à partir d’une valeur déclarée sensible. Le socket ne leur attribue aucune signification : chaque fournisseur documente ce que sélectionnent kind, name, namespace et subchart dans son propre format, et les confronte lui-même.

PropriétéTypeObligatoireDescription
kindstringouiLe type d’unité rendue que nomme l’entrée, dans le vocabulaire propre au fournisseur.
namestringouiLe nom de l’unité rendue que nomme l’entrée, dans le vocabulaire propre au fournisseur.
namespacestringnonLe namespace dans lequel se trouve l’unité nommée, pour un fournisseur dont le format place les unités dans un namespace. Absent lorsque l’auteur n’en a écrit aucun ; ce à quoi correspond une entrée sans namespace relève du contrat propre au fournisseur.
subchartstringnonLa source imbriquée dont provient l’unité nommée, pour un fournisseur dont la source est assemblée à partir de sources imbriquées, comme un chart l’est à partir de ses subcharts. Absent lorsque l’auteur n’en a écrit aucune ; ce à quoi correspond une entrée sans subchart, et ce que fait un fournisseur dont la source n’a pas de sources imbriquées d’une entrée qui en nomme une, relève du contrat propre au fournisseur.
sensitivebooléennonVrai lorsque le template qui a produit l’un des champs kind, name, namespace ou subchart de l’entrée lit une valeur qu’un auteur a déclarée sensible, ou une valeur qui remonte à une telle valeur. Il est lu à partir du template de chaque champ par rapport aux déclarations — une référence qui atteint une valeur déclarée, le template qui transmet la totalité de ses données, ou un template qui ne s’analyse pas comptent tous — et jamais à partir des chaînes résolues. La marque couvre l’entrée entière plutôt que de nommer le champ, de sorte qu’un invité traite une entrée marquée comme il traite toute autre valeur marquée de son entrée : il continue de confronter et de compter l’entrée par ses champs, ce à quoi sert l’entrée, et tient chacun de ses champs à l’écart de tout texte qu’une personne lit — un refus, un avertissement ou une ligne de journal. Absent lorsque le template d’aucun champ ne lit une telle valeur ; l’absence n’affirme jamais qu’aucun champ n’est sensible.

Les propriétés supplémentaires ne sont pas autorisées.

SourceFile

Un fichier d’une projection de source pré-empaquetée : son chemin relatif à la racine de la source et ses octets bruts, exactement tels que l’hôte les a lus depuis la source locale au moment de la compilation.

PropriétéTypeObligatoireDescription
pathstringouiLe chemin du fichier relatif à la racine de la source (par exemple Chart.yaml ou templates/deployment.yaml).
contentstringouiLes octets bruts du fichier exactement tels que l’hôte les a lus depuis la source locale. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.

Les propriétés supplémentaires ne sont pas autorisées.

SourceProjection

Le contenu de source empaqueté (p. ex. les fichiers d’un chart Helm, chacun nommé par son chemin relatif à la racine de la source, dans l’ordre de parcours) que l’hôte lit et renvoie à l’invité en réponse à une requête pack-source, de sorte que l’invité reconstruit en mémoire la source sélectionnée et ne touche à aucun système de fichiers. C’est le payload de succès de la fonction hôte pack-source.

PropriétéTypeObligatoireDescription
filesSourceFile[]ouiLes fichiers de la source, chacun nommé par son chemin relatif à la racine de la source, dans l’ordre de parcours déterministe de l’hôte.

Les propriétés supplémentaires ne sont pas autorisées.

SourceEntry

Une entrée d’une liste de source : son chemin relatif à la racine de la source, et s’il s’agit d’un répertoire. L’hôte ne liste que des noms et ne lit aucun contenu, de sorte qu’une entrée ne porte aucun octet.

PropriétéTypeObligatoireDescription
pathstringouiLe chemin de l’entrée relatif à la racine de la source, séparé par des barres obliques (par exemple Chart.yaml ou templates/deployment.yaml).
is_dirbooléenouiIndique si l’entrée est un répertoire. Un invité qui résout une racine de chart ou un fichier source unique dans la liste lit ce champ pour distinguer les répertoires des fichiers sans toucher au système de fichiers.

Les propriétés supplémentaires ne sont pas autorisées.

SourceListing

L’énumération générique d’une source acquise que l’hôte remet à l’invité d’un fournisseur à source : la racine de la source, si cette racine est un répertoire, et les entrées triées relatives à la racine qui se trouvent en dessous. L’hôte parcourt la source acquise sans aucune connaissance du domaine et ne lit aucun contenu de fichier — il ne liste que des noms. L’invité applique sa propre logique de résolution à la liste (localiser une racine de chart, sélectionner un document compose unique, vendoriser une arborescence de modules) et demande à l’hôte d’empaqueter une sélection choisie au moyen de la fonction hôte pack-source. Les entrées sont triées par chemin afin que la liste soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.

PropriétéTypeObligatoireDescription
rootstringouiL’emplacement de la source acquise que l’hôte a énuméré. L’invité le reporte dans ses propres diagnostics lorsqu’il ne parvient pas à résoudre la source, de sorte qu’un arrêt de résolution nomme la source fournie par l’auteur.
root_is_dirbooléennonIndique si la racine de la source acquise est un répertoire. Faux pour une source à fichier unique (un document compose isolé, un fichier de module unique, une archive), auquel cas entries est vide et l’invité empaquette la racine elle-même.
entriesSourceEntry[]ouiLes entrées relatives à la racine sous une racine de source qui est un répertoire, triées par chemin. Vide pour une racine de source à fichier unique.

Les propriétés supplémentaires ne sont pas autorisées.

SourcePackRequest

La sélection qu’un invité demande à l’hôte d’empaqueter à partir de la source acquise au moyen de la fonction hôte pack-source. op nomme la forme de la sélection et path la nomme relativement à la racine de la source ; l’hôte résout le chemin sous la racine de la source, en rejetant toute sortie au-dessus d’elle, et renvoie les octets empaquetés sous forme de SourceProjection.

PropriétéTypeObligatoireDescription
opstring (enum)ouiLa forme de la sélection : file empaquette le fichier unique situé à path ; dir empaquette les fichiers immédiats du répertoire situé à path ; tree empaquette récursivement tout le sous-arbre enraciné à path, dans l’ordre de parcours déterministe de l’hôte. Valeurs autorisées : "file", "dir", "tree"
pathstringouiL’emplacement de la sélection relatif à la racine de la source, séparé par des barres obliques. La chaîne vide (ou ”.”) nomme la racine de la source elle-même, de sorte qu’une source à fichier unique est empaquetée avec un chemin vide.

Les propriétés supplémentaires ne sont pas autorisées.

SourcePackResponse

La réponse de la fonction hôte pack-source : en cas de succès la source empaquetée, en cas d’échec un message d’erreur. Exactement l’un des deux champs est renseigné. L’échec est transmis dans la bande plutôt que par un trap, de sorte qu’un invité reporte un rejet du bac à sable ou un échec de lecture dans ses propres diagnostics comme un échec de rendu déterministe.

PropriétéTypeObligatoireDescription
source_projectionSourceProjectionnonLa source empaquetée en cas de succès ; absente en cas d’échec.
errorstringnonLe message d’erreur en cas d’échec, nommant la sélection et la raison ; absent en cas de succès.
hostfunc_error_codestring (enum)nonL’identité de l’échec reconnaissable par une machine en cas d’échec, tirée du catalogue fermé des codes d’erreur des fonctions hôtes, définie à côté du message d’erreur lisible par un humain ; absente en cas de succès. Ce catalogue est un vocabulaire fixe qui nomme les manières dont une fonction hôte peut échouer, et c’est un vocabulaire différent des conditions d’arrêt que le compilateur enregistre, dont un invité signale les identifiants sur une sortie de socket sous condition_code et condition_short_code — le nom de la clé indique auquel des deux appartient une valeur, de sorte que les deux ne sont jamais lus comme un seul ensemble. Un invité se ramifie sur ce code sans analyser le message, en tolérant un code absent (hôte plus ancien) ou un code non reconnu (hôte plus récent) par repli sur le message. Valeurs autorisées : "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"

Les propriétés supplémentaires ne sont pas autorisées.

SourceFileRequest

La lecture du contenu d’un fichier unique qu’un invité demande à l’hôte d’effectuer au moyen de la fonction hôte read-source-file, pour un invité dont la logique de résolution doit examiner le contenu d’un fichier avant de choisir ce qu’il empaquette. L’hôte résout le chemin sous la racine de la source, en rejetant toute sortie au-dessus d’elle, et renvoie les octets du fichier.

PropriétéTypeObligatoireDescription
pathstringouiL’emplacement du fichier relatif à la racine de la source, séparé par des barres obliques.

Les propriétés supplémentaires ne sont pas autorisées.

SourceFileResponse

La réponse de la fonction hôte read-source-file : en cas de succès les octets du fichier, en cas d’échec un message d’erreur. Exactement l’un des deux champs est renseigné. L’échec est transmis dans la bande plutôt que par un trap, de sorte qu’un invité reporte un rejet du bac à sable ou un échec de lecture dans ses propres diagnostics comme un échec de rendu déterministe.

PropriétéTypeObligatoireDescription
contentstringnonLes octets bruts du fichier en cas de succès ; absents en cas d’échec. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.
errorstringnonLe message d’erreur en cas d’échec, nommant le fichier et la raison ; absent en cas de succès.
hostfunc_error_codestring (enum)nonL’identité de l’échec reconnaissable par une machine en cas d’échec, tirée du catalogue fermé des codes d’erreur des fonctions hôtes, définie à côté du message d’erreur lisible par un humain ; absente en cas de succès. Ce catalogue est un vocabulaire fixe qui nomme les manières dont une fonction hôte peut échouer, et c’est un vocabulaire différent des conditions d’arrêt que le compilateur enregistre, dont un invité signale les identifiants sur une sortie de socket sous condition_code et condition_short_code — le nom de la clé indique auquel des deux appartient une valeur, de sorte que les deux ne sont jamais lus comme un seul ensemble. Un invité se ramifie sur ce code sans analyser le message, en tolérant un code absent (hôte plus ancien) ou un code non reconnu (hôte plus récent) par repli sur le message. Valeurs autorisées : "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"

Les propriétés supplémentaires ne sont pas autorisées.

FetchExternalInputResponse

La réponse de la fonction hôte fetch-external-input : en cas de succès le contenu récupéré, en cas d’échec un message d’erreur et son code. Une réponse qui ne porte aucun des deux champs d’échec est un succès, de sorte qu’un payload de longueur nulle est la réponse dont tous les champs sont absents. L’échec est transmis dans la bande plutôt que par un trap, de sorte qu’un invité reporte une URL impossible à résoudre ou un échec de récupération dans ses propres diagnostics comme un échec de rendu déterministe. La requête est une simple chaîne d’URL plutôt qu’un payload structuré, de sorte que seule la réponse a une forme déclarée.

PropriétéTypeObligatoireDescription
contentstringnonLes octets bruts du payload récupéré en cas de succès ; absents en cas d’échec, et absents lorsque le payload est vide. Dans le format de transmission, les octets circulent sous forme de chaîne d’octets, jamais sous forme de texte base64. Le kit Go les conserve sous forme de slice d’octets ; les kits Rust et TypeScript les conservent sous forme de chaîne base64, que le wrapper de fetch de chaque kit décode, de sorte que chaque wrapper renvoie les octets bruts du payload.
errorstringnonLe message d’erreur en cas d’échec, nommant l’URL et la solution ; absent en cas de succès.
hostfunc_error_codestring (enum)nonL’identité de l’échec reconnaissable par une machine en cas d’échec, tirée du catalogue fermé des codes d’erreur des fonctions hôtes, définie à côté du message d’erreur lisible par un humain ; absente en cas de succès. Ce catalogue est un vocabulaire fixe qui nomme les manières dont une fonction hôte peut échouer, et c’est un vocabulaire différent des conditions d’arrêt que le compilateur enregistre, dont un invité signale les identifiants sur une sortie de socket sous condition_code et condition_short_code — le nom de la clé indique auquel des deux appartient une valeur, de sorte que les deux ne sont jamais lus comme un seul ensemble. Un invité se ramifie sur ce code sans analyser le message, en tolérant un code absent (hôte plus ancien) ou un code non reconnu (hôte plus récent) par repli sur le message. Valeurs autorisées : "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"

Les propriétés supplémentaires ne sont pas autorisées.

WorkloadProjection

Le contenu de workload pré-évalué que l’hôte remet à un invité du Provider pour que l’invité en synthétise en mémoire des manifestes natifs du fournisseur, présent lorsque la Recipe liée déclare un workload plutôt qu’une source de chart. Le déterminisme est de la responsabilité de l’invité : une entrée identique doit produire des octets identiques.

PropriétéTypeObligatoireDescription
workloadobjectouiLe Workload évalué par l’hôte, postérieur à la validation, que l’invité synthétise ; opaque à ce niveau du schéma afin que le schéma du socket ne redéfinisse pas le contrat de l’entité Workload.
sensitive_workloadbooléennonVrai lorsque le template qui a produit workload lit une valeur qu’un auteur a déclarée sensible, ou une valeur qui remonte à une telle valeur. Il est lu à partir des propres références du template confrontées aux déclarations — une référence qui atteint une valeur déclarée, le template qui transmet la totalité de ses données, ou un template qui ne s’analyse pas comptent tous — et jamais à partir du contenu d’un champ quelconque. Les champs d’un workload rendu ne portent aucun lien vers les données que son template a lues, de sorte que ce champ marque le document entier : un invité qui compose un texte qu’une personne lit, un refus ou un avertissement, tient chaque valeur que porte le workload à l’écart de ce texte lorsque ce champ est vrai, tandis que la forme du document — ses clés et l’endroit où se trouve une valeur — reste lisible. Les entrées de rattachement que nomme sensitive_rendered_keys de la projection du nœud y sont marquées, que ce champ soit défini ou non. Absent lorsque le template ne lit aucune valeur de ce type ; l’absence n’affirme jamais qu’aucun champ n’est sensible.
attachment_providesobjectnonChaque rattachement du nœud, projeté sur ses provides résolus et indexé par le nom d’instance de rattachement que porte une référence de rattachement de workload ; absent lorsque le nœud ne porte aucun rattachement. L’hôte recopie les chaînes sans les interpréter, de sorte que l’invité lit celles des entrées des provides d’un rattachement dont il a besoin pour résoudre une référence à la ressource que ce rattachement a produite. Le fait qu’un rattachement traite du matériel déclaré sensible n’est pas répété ici : cela voyage sur l’entrée de feature correspondante de la projection du nœud, que l’invité lit par le même nom d’instance.

Les propriétés supplémentaires ne sont pas autorisées.

ArtifactsProjection

L’ensemble d’artefacts pré-évalué que l’hôte remet à un invité du Provider pour qu’il le place dans la sortie du nœud. L’hôte a déjà résolu la source de chaque entrée (contenu inline ou fichier importé qu’il a lu), l’a évaluée comme un template Go par rapport au contexte de rendu en utilisant la paire de délimiteurs de template d’artefact déclarée par l’invité, et a calculé les ensembles de clés de labels et d’annotations de la provenance du build. L’invité est maître de la décision de format, du placement de la provenance, du chemin sur disque et des octets finaux. Les entrées préservent l’ordre de l’auteur afin que la sortie placée soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.

PropriétéTypeObligatoireDescription
entriesArtifactProjectionEntry[]ouiLes entrées d’artefact que l’invité place, dans l’ordre de l’auteur.

Les propriétés supplémentaires ne sont pas autorisées.

ArtifactProjectionEntry

Une entrée d’artefact pré-évaluée que l’hôte remet à un invité du Provider pour qu’il la place : son nom de sortie résolu par l’hôte, son origine, les octets de contenu déjà évalués comme template, si le template dont proviennent ces octets lit une valeur déclarée sensible, et les ensembles de clés de labels et d’annotations de la provenance du build que l’hôte a calculés pour le nœud. L’invité décide comment placer la provenance (en l’insérant dans les métadonnées d’un manifeste, en la préfixant sous forme de commentaire ou en émettant un fichier compagnon) et où le fichier atterrit.

PropriétéTypeObligatoireDescription
namestringouiLe nom de sortie résolu par l’hôte pour l’entrée : la clé de map déclarée par l’auteur, un fichier fourni par un bundle de bibliothèque étant imbriqué sous cette clé. L’invité place l’entrée à ce nom ou sous un sous-chemin propre au fournisseur dérivé de celui-ci.
originstring (enum)ouiIndique si l’entrée a été rédigée comme contenu inline ou comme fichier importé. Un invité qui rejette l’une des deux formes (un fournisseur d’umbrella chart rejette le contenu inline) lit ce champ pour s’arrêter de manière explicite. Valeurs autorisées : "inline", "import"
contentstringouiLes octets de contenu déjà évalués comme template que l’hôte a produits à partir du contenu inline ou du fichier importé de l’entrée, évalués par rapport au contexte de rendu en utilisant la paire de délimiteurs de template d’artefact déclarée par l’invité. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.
sensitive_contentbooléennonVrai lorsque le template à partir duquel le contenu de cette entrée a été évalué lit une valeur qu’un auteur a déclarée sensible, ou une valeur qui remonte à une telle valeur. Il est lu à partir des propres références du template confrontées aux déclarations, avec la paire de délimiteurs avec laquelle le contenu a été évalué — une référence qui atteint une valeur déclarée, le template qui transmet la totalité de ses données, ou un template qui ne s’analyse pas comptent tous — et jamais à partir du contenu lui-même. Le contenu est la sortie de ce template, de sorte que rien en lui ne peut être ramené à la donnée dont il provient : un invité qui compose un texte qu’une personne lit, un refus ou un avertissement, tient chaque partie du contenu à l’écart de ce texte lorsque ce champ est vrai, y compris le propre message d’un parseur au sujet du contenu. Il est défini par entrée, de sorte que le template d’une entrée qui lit une telle valeur ne dit rien de celui d’une autre. Absent lorsque le template ne lit aucune valeur de ce type ; l’absence n’affirme jamais que le contenu n’est pas sensible.
labelsobjectnonL’ensemble de clés de la provenance du build compatible avec les labels Kubernetes que l’hôte a calculé pour le nœud, indexé par nom de label. Un invité qui estampille la provenance dans metadata.labels d’un manifeste y insère ces clés ; un invité dont la sortie n’est pas du YAML Kubernetes les ignore.
annotationsobjectnonL’ensemble de clés de la provenance du build, calculé par l’hôte pour le nœud, qu’un label Kubernetes ne peut pas représenter, indexé par nom d’annotation. Un invité qui estampille la provenance dans metadata.annotations d’un manifeste y insère ces clés ; un invité dont la sortie n’est pas du YAML Kubernetes les ignore.

Les propriétés supplémentaires ne sont pas autorisées.

AssembleBoundaryInput

Le payload qu’un invité du Provider reçoit par son export assemble_boundary — l’export qui fusionne les sorties de rendu par nœud d’un groupe de distribution en un artefact assemblé unique (un umbrella chart, un fichier compose fusionné). Il porte les sorties de rendu par nœud avec leurs annotations fusionnées et leurs vagues de déploiement, le chemin de sortie du groupe de distribution où atterrit l’artefact assemblé, les arêtes uses du graphe pour l’inférence des dépendances par service, et le contexte du moment du rendu. Tous les fournisseurs ne déclarent pas l’export : les fournisseurs qui n’émettent qu’une sortie plate par nœud l’omettent.

PropriétéTypeObligatoireDescription
rendered_nodesRenderedNode[]ouiLes sorties de rendu par nœud qui ont alimenté ce groupe de distribution, dans l’ordre des nœuds.
contextobjectouiLe contexte du moment du rendu, transmis sous la forme des octets de son document JSON. Sur cet export, l’hôte ne définit que yaml_indent, la largeur d’indentation commune à tout le rendu avec laquelle les fichiers assemblés sont sérialisés ; les autres membres du contexte ne portent rien ici, car un assemblage fusionne des contributeurs dont les annotations et les frontières diffèrent, et les annotations de chaque contributeur arrivent plutôt sur son entrée de rendered_nodes.
boundary_pathstringouiLe chemin de sortie évalué du groupe de distribution où atterrit l’artefact assemblé ; un assembleur de frontière l’utilise comme identité de repli au niveau de la frontière (par exemple le nom du réseau compose pour un nœud qui ne porte aucune annotation namespace).
edgesRenderEdge[]nonLes arêtes uses orientées du graphe, afin qu’un assembleur de frontière puisse inférer l’ordre/les dépendances par service entre les contributeurs du groupe de distribution (par exemple depends_on de compose).
sub_chartsSubChart[]nonLe payload par sous-chart qu’un assembleur d’umbrella chart consomme pour émettre une dépendance et une portée de valeurs par contributeur. Chaque entrée porte l’identité du sous-chart, les valeurs par instance et, pour un sous-chart vendorisé depuis une source de chart, les octets intacts du fichier Chart.yaml de ce chart. Présent pour l’assemblage d’umbrella chart ; un assembleur qui fusionne à plat l’omet.
chart_namestringnonLe nom de chart qu’un assembleur d’umbrella chart utilise pour le chart assemblé lorsqu’un nom est fourni pour le groupe de distribution ; vide lorsque l’assembleur dérive le nom du chemin de sortie du groupe de distribution.
aggregate_namestringnonLe nom de l’agrégat de premier niveau qu’un assembleur d’umbrella chart intègre au nom dérivé du chart assemblé ; vide lorsqu’aucune identité d’agrégat ne contribue au nom.

Les propriétés supplémentaires ne sont pas autorisées.

RenderedNode

La sortie de rendu d’un nœud telle qu’elle apparaît dans une entrée de assemble_boundary : l’identifiant du nœud, son type, ses annotations fusionnées, sa sync wave, les valeurs que le compilateur a résolues pour lui là où il revient au compilateur de les fournir et le fait qu’un mappage des valeurs les a produites ou non, et les fichiers que l’export render_node a produits pour lui — portés dans la forme de la sortie de rendu, chaque membre de cette forme autre que ses fichiers étant laissé absent.

PropriétéTypeObligatoireDescription
idstringouiL’identifiant absolu du nœud dans le graphe de topologie. Un contributeur qui n’est pas l’un des nœuds du graphe — une Feature rattachée à une frontière plutôt qu’à un composant — porte ici à la place l’identité de distribution propre au compilateur pour lui, qui est la même identité que celle qu’a portée l’appel render_node pour ce contributeur ; elle distingue un contributeur d’un autre et n’est pas un nom qu’une cible accepte. Ce à partir de quoi un tel contributeur dérive des noms à l’intérieur de l’artefact assemblé est une donnée portée séparément, derived_name_basis.
typestringouiL’étiquette de type de composant du nœud, portée sur cette forme — contrairement à la projection de rendu par nœud, qui la retient. Une métadonnée opaque plutôt qu’un commutateur de comportement : elle est ici pour qu’un assembleur puisse regrouper et étiqueter les nœuds qu’il fusionne, et non pour qu’un invité puisse brancher son comportement sur elle.
derived_name_basisstringnonL’identité à partir de laquelle ce contributeur dérive ses propres noms à l’intérieur de l’artefact assemblé — un identifiant logique qu’un assembleur forge pour l’une des entrées publiées du contributeur, une portée par contributeur dans un document fusionné, le nom d’une unité enfant placée à une position qui lui est propre. Vide signifie que l’identifiant est utilisé directement, ce qui est la valeur pour un composant ordinaire. Un contributeur dont l’identifiant est une identité de distribution que l’alphabet de noms d’une cible refuse porte cette valeur explicitement, de sorte que l’artefact assemblé adresse son contenu par un nom que la cible accepte, et que deux contributeurs qu’un auteur sait distinguer ne peuvent pas arriver sous un seul nom. Là où le contenu du contributeur est intégré à un document que l’assembleur fusionne, il s’agit de la même donnée portée que celle qu’a reçue l’appel render_node pour ce contributeur, et la porter sur les deux est ce qui maintient les deux réponses égales : un nom que le contributeur a déclaré pendant le rendu et le nom par lequel le document fusionné adresse ce contenu sont dérivés d’une seule identité plutôt que de deux qui se trouvent concorder. Là où le contributeur est plutôt placé à une position qui lui est propre, il s’agit de l’identité composée pour ce contributeur — pour une Feature rattachée à un composant, la sienne plutôt que celle du composant hôte par rapport auquel son rendu a été effectué — de sorte qu’une unité enfant placée à côté de son hôte est adressée séparément de lui.
output_directorystringnonLe répertoire dans lequel se trouvent les fichiers rendus de ce contributeur, relatif à la position propre de l’artefact assemblé, sans séparateur final. Un invité qui doit nommer les fichiers d’un contributeur depuis l’intérieur de l’artefact assemblé — le chemin source d’un bloc de module, une directive include — lit la position ici plutôt que d’en composer une à partir de l’identité du contributeur, de sorte que le chemin vers lequel pointe l’artefact assemblé est le chemin dans lequel les fichiers ont été écrits. Les deux ne sont pas toujours distants d’un seul répertoire : un contributeur que l’hôte a placé à l’intérieur de la position d’un autre contributeur se trouve plus en profondeur que les contributeurs placés directement sous l’assemblage. Présent uniquement là où le fournisseur qui assemble place chaque contributeur sous une position qui lui est propre ; un fournisseur qui intègre ses contributeurs dans un seul document ne place aucun répertoire par contributeur et n’en reçoit aucun.
renderedRenderNodeOutputouiLe payload qu’un invité du Provider renvoie depuis son export render_node : les octets sérialisés de chaque fichier de sortie que l’invité a émis, les noms qu’il a dérivés dans chacun de ses propres espaces de clés, les faits qu’il signale sur ce qu’il a émis, à combien d’unités rendues chaque entrée omits qui lui a été remise a correspondu, et les éventuels diagnostics que l’invité a levés pendant le rendu. L’invité renvoie les octets sérialisés de chaque fichier ; l’hôte les écrit tels quels et n’exécute aucun sérialiseur. Le déterminisme est de la responsabilité de l’invité : une entrée identique doit produire des octets identiques.
annotationsmap de stringnonLes annotations fusionnées du nœud, afin qu’un assembleur de frontière puisse attribuer le placement par nœud (par exemple le réseau compose dérivé de l’annotation aggrega.ai/namespace).
sync_waveintegernonLa vague de déploiement héritée de la frontière qui contient ce nœud (0 par défaut ; valeurs négatives autorisées), afin qu’un assembleur de frontière puisse ordonner les uns par rapport aux autres les contributeurs qu’il fusionne. Un groupe de distribution peut fusionner des contributeurs de plusieurs frontières, chacun portant sa propre vague, de sorte que la vague voyage ici avec chaque nœud plutôt qu’une seule fois pour l’ensemble du payload. Un assembleur dont la forme de sortie n’exprime aucun ordre l’ignore.
valuesobjectnonLes valeurs que le compilateur a résolues pour ce nœud, présentes uniquement pour un nœud rendu à partir d’une source — l’appel render_node qui a produit ses fichiers portait un source_listing. C’est le seul cas où les fichiers proviennent d’ailleurs et où les valeurs n’ont pas pu y être écrites, si bien qu’une position extérieure à eux doit les fournir : un assembleur de frontière place un dictionnaire présent comme entrées de ce contributeur dans l’artefact assemblé lui-même, plutôt qu’à côté des propres fichiers du contributeur, et là où l’artefact assemblé est la seule position que la cible évalue, c’est la différence entre une entrée que la cible lit et une entrée qu’elle n’atteint jamais. Un nœud rendu à partir d’un workload_projection ou d’un artifacts_projection a résolu ces valeurs dans les fichiers qu’il a produits, de sorte qu’il n’en porte aucune ici et que le champ est absent : les fournir une seconde fois offrirait à l’artefact assemblé des entrées que les propres fichiers de ce nœud ne déclarent jamais, et que la cible est libre de rejeter. Les clés arrivent triées, et non dans l’ordre de l’auteur, et c’est ce tri qui rend le payload identique à l’octet près d’une exécution à l’autre pour une entrée identique ; un invité qui a besoin d’un autre ordre l’impose lui-même. Un assembleur dont la forme de sortie ne porte aucune entrée par contributeur ignore le champ.
values_mappedbooléennonVrai lorsque les valeurs que porte ce nœud sont la sortie du valuesMapping de sa Recipe ou FeatureRecipe liée (la Recipe d’un composant, la FeatureRecipe d’une Feature rattachée), plutôt que les valeurs du nœud transmises telles que l’auteur les a écrites — le même marquage que l’appel render_node pour ce nœud portait sur sa projection de nœud, porté ici à côté des valeurs qu’il décrit. Absent là où aucun valuesMapping n’a été exécuté, et partout où values est absent. Le fait qu’un assembleur le lise ou non relève du contrat propre de cet assembleur : un assembleur dont le render_node lie les valeurs d’un nœud mappé aux entrées que déclare sa source peut y apprendre quels noms cette liaison a renseignés, tandis qu’un assembleur qui place les valeurs d’un nœud comme ses entrées quelle que soit la façon dont elles ont été produites ne le lit pas. Il enregistre la façon dont les valeurs ont été produites et n’est jamais dérivé du nom d’une clé ni du contenu d’une valeur.

Les propriétés supplémentaires ne sont pas autorisées.

RenderEdge

Une arête uses orientée du graphe, nommée par ses deux identifiants de nœud : source est le nœud consommateur et target le nœud consommé. La liste porte chaque arête uses du graphe, de sorte que l’une ou l’autre extrémité peut être un nœud extérieur à ce groupe de distribution.

PropriétéTypeObligatoireDescription
sourcestringouiL’identifiant du nœud consommateur — l’extrémité source d’une arête uses orientée.
targetstringouiL’identifiant du nœud consommé — l’extrémité target vers laquelle pointe une arête uses orientée.

Les propriétés supplémentaires ne sont pas autorisées.

SubChart

Un sous-chart qui contribue à un umbrella chart : son identité d’instance, la version que l’umbrella épingle, les valeurs par instance que l’umbrella place sous l’alias du sous-chart et, pour un sous-chart vendorisé depuis une source de chart, les octets intacts du fichier Chart.yaml de ce chart. Un assembleur d’umbrella chart construit les dépendances et le fichier de valeurs de l’umbrella à partir de ces seules vues de données pures et ne touche à aucun système de fichiers.

PropriétéTypeObligatoireDescription
instance_idstringouiL’identité d’instance du sous-chart au sein du groupe de distribution ; l’umbrella place sous elle l’alias de dépendance du sous-chart et ses valeurs, de sorte que plusieurs instances d’un même chart source restent distinctes.
versionstringnonLa version que l’umbrella épingle pour le sous-chart. Un sous-chart vendorisé depuis une source de chart tire plutôt le nom et la version de sa dépendance du fichier Chart.yaml de ce chart, afin que la dépendance se lie ; cette valeur s’applique à un sous-chart génératif qui ne porte aucun chart vendorisé.
valuesobjectnonLes valeurs par instance que l’umbrella place sous l’alias du sous-chart dans le fichier values.yaml de l’umbrella. Les clés arrivent triées, et non dans l’ordre de l’auteur, et c’est ce tri qui rend le payload identique à l’octet près d’une exécution à l’autre pour une entrée identique ; un invité qui a besoin d’un autre ordre l’impose lui-même.
chart_yamlstringnonLes octets intacts du Chart.yaml du chart vendorisé, lus depuis la source locale au moment de la compilation, dont l’umbrella tire le nom et la version de la dépendance du sous-chart. Vide pour un sous-chart génératif qui ne porte aucun chart vendorisé. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.

Les propriétés supplémentaires ne sont pas autorisées.

AssembleBoundaryOutput

Le payload qu’un invité du Provider renvoie depuis son export assemble_boundary : les octets sérialisés de chaque fichier assemblé et les éventuels diagnostics que l’invité a levés pendant l’assemblage. L’emplacement des fichiers par nœud du groupe assemblé ne fait pas partie de cette réponse — c’est une propriété statique du fournisseur, déclarée une seule fois dans son contrat describe() et connue avant qu’aucun nœud ne soit rendu. L’invité renvoie les octets sérialisés de chaque fichier ; l’hôte les écrit tels quels et n’exécute aucun sérialiseur. Le déterminisme est de la responsabilité de l’invité : une entrée identique doit produire des octets identiques.

PropriétéTypeObligatoireDescription
filesRenderedFile[]ouiLes fichiers de sortie assemblés que l’invité a émis, dans l’ordre d’émission. Chacun nomme son chemin sur disque et porte les octets sérialisés que l’hôte écrit tels quels.
diagnosticsDiagnostic[]nonDiagnostics que l’invité a levés pendant l’assemblage. Chaque élément est la forme de diagnostic partagée des plugins Wasm.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. Il est distinct des éventuels diagnostics que porte la sortie : les diagnostics signalent des problèmes trouvés pendant une exécution qui a malgré tout produit un résultat, tandis que error signale que l’opération elle-même ne s’est pas terminée. L’hôte présente une erreur présente comme une invocation de plugin échouée.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

CarveInput

Le payload qu’un invité du Provider reçoit par son export facultatif carve : un fichier de sortie nommé que le pipeline découpe en unités adressables avant qu’une étape de FeatureRecipe n’en modifie certaines. Un fournisseur dont le codec YAML standard ne peut pas découper directement la forme de sortie (un chart à base de templates, par exemple) annonce carve et reassemble, de sorte que sa propre connaissance de la forme de sortie réside dans l’invité ; un fournisseur qui omet ces exports emprunte le codec YAML standard de l’hôte.

PropriétéTypeObligatoireDescription
namestringouiLe nom du fichier de sortie, afin que le codec puisse appliquer toute règle de découpage liée au nom.
bodystringouiLes octets du fichier de sortie à découper en unités adressables. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.
yaml_indentintegernonLa largeur d’indentation que le codec utilise lorsqu’il doit synthétiser un nouveau texte structuré ; portée afin que le découpage de l’invité corresponde à l’indentation commune à tout le rendu.

Les propriétés supplémentaires ne sont pas autorisées.

CarveOutput

Le payload qu’un invité du Provider renvoie depuis son export carve : les unités adressables ordonnées en lesquelles il a découpé le fichier. Une unité structurée porte un arbre (une cible de PATCH) ; une unité opaque ne porte que son type de média et ses octets.

PropriétéTypeObligatoireDescription
unitsobject[]ouiLes unités adressables ordonnées en lesquelles l’invité a découpé le fichier.

Les propriétés supplémentaires ne sont pas autorisées.

ReassembleInput

Le payload qu’un invité du Provider reçoit par son export facultatif reassemble : le fichier d’origine ainsi que ses unités découpées et les unités modifiées par patch qu’une étape de pipeline a produites, afin que l’invité réinsère chirurgicalement les modifications dans les octets d’origine. Un token absent de l’ensemble modifié est rejoint tel quel à partir de ses octets d’origine ; d’un token modifié, seules les plages d’octets adressées sont modifiées.

PropriétéTypeObligatoireDescription
namestringouiLe nom du fichier de sortie, qui correspond au nom sous lequel ce même fichier a été découpé.
bodystringouiLes octets du fichier d’origine dans lesquels le réassemblage réinsère les unités modifiées. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.
segsobject[]nonLes unités en lesquelles le fichier a été découpé, telles que carve les a renvoyées.
patchedobject[]nonLes unités qu’une étape de pipeline a modifiées, chacune portant son token, son arbre modifié et les ops qui ont produit la modification.
yaml_indentintegernonLa largeur d’indentation que le codec utilise lorsqu’une op doit synthétiser un nouveau texte structuré ; portée afin que le réassemblage corresponde à l’indentation commune à tout le rendu.

Les propriétés supplémentaires ne sont pas autorisées.

ReassembleOutput

Le payload qu’un invité du Provider renvoie depuis son export reassemble : les octets du fichier avec les unités modifiées réinsérées. Le réassemblage est fidèle à l’octet près — chaque octet que les ops n’ont pas touché survit tel quel.

PropriétéTypeObligatoireDescription
bodystringouiLes octets du fichier réassemblé que l’hôte écrit tels quels. Chaque kit les porte dans son propre type de champ — bruts lorsque ce type est un type d’octets, encodés en base64 lorsqu’il s’agit d’une chaîne que l’invité décode pour les retrouver — et l’encodeur généré convertit entre le champ et la forme sous laquelle le format de transmission porte les octets.

Les propriétés supplémentaires ne sont pas autorisées.

NameBoundInput

Le payload qu’un invité du Provider reçoit par son export facultatif name_bound : un nom que l’hôte propose d’utiliser comme identité de composant d’un nœud, pour que l’invité le juge par rapport à chaque nom qu’il en dériverait pour sa cible, accompagné des faits du workload résolu du nœud dont dépendent certains de ces noms, lorsque l’identité est fixée après la résolution de ce workload. L’invité répond par une contrainte plutôt que par un nom qui lui soit propre — un nom dérivé renvoyé à l’hôte mettrait celui-ci en position de composer des noms pour une cible dont il ne sait rien, ce qui est exactement ce que le fait de poser la question supprime. Un fournisseur dont la cible borne ou restreint les noms qu’elle accepte annonce l’export ; un fournisseur dont la cible accepte n’importe quel nom l’omet et n’est jamais interrogé, et son rendu reste inchangé.

PropriétéTypeObligatoireDescription
proposedstringouiLe nom que l’hôte propose comme identité de composant du nœud. L’invité en dérive, en mémoire, chaque nom qu’il dérive d’une identité de composant et signale si chacun est un nom que sa cible accepte. Un verdict porte sur la PROPOSITION plutôt que sur le nœud : l’hôte pose une seule question partout où il compose une identité, et il ne dit pas de quels noms de ce nœud cette identité finira par être la base, si bien qu’un invité répond comme si elle était la base de tous. C’est la direction prudente, car l’hôte ne fait jamais que raccourcir en fonction de la réponse et n’allonge jamais — un nom que le nœud dérivera en fait d’une autre donnée portée est donc jugé trop strictement plutôt que trop largement.
authoredbooléennonIndique si le nom proposé est un nom qu’une personne a écrit plutôt qu’un nom que le compilateur a composé à partir de parties rédigées par l’auteur. Il est porté afin qu’un invité puisse formuler sa raison pour le lecteur qui est en mesure d’agir en conséquence. Il ne décide pas de ce que fait un refus : un nom rédigé par l’auteur est refusé et un nom composé est raccourci, et cette décision revient à l’hôte.
workload_formstringnonLa forme du workload en lequel se résout la Recipe ou la FeatureRecipe du nœud, telle que l’a produite son template de workload, transmise lorsque l’identité est fixée après la résolution de ce workload et que le workload indique une forme. Elle est transmise telle qu’elle est écrite ; l’hôte ne l’interprète pas. Un invité dont la cible borne un nom qu’il émet pour une seule forme — un job planifié, dont la cible veut le nom plus court que ses autres noms parce qu’un suffixe y est ajouté à chaque exécution — la lit pour juger ce nom. Absent signifie que l’hôte ne transmet aucune forme pour cette question : le nœud ne déclare aucun workload, son workload n’en indique aucune, ou l’identité est fixée avant la résolution de tout workload. Un invité ne juge alors aucun nom qui dépend de la forme, et répond exactement comme il le ferait si le champ n’existait pas.
service_keysstring[]nonLes clés des Services que déclare le workload résolu du nœud, dans l’ordre où le workload les déclare, transmises lorsque l’identité est fixée après la résolution de ce workload et que le workload en déclare. Un invité dont la cible nomme chaque Service qu’il émet pour le nœud à partir de l’identité du composant et de la clé du Service les lit pour juger chacun de ces noms. Une clé est écrite par l’auteur de la Recipe ou de la FeatureRecipe plutôt que par celui qui a écrit l’identité, de sorte qu’un invité formule aussi pour cet auteur un refus causé par une clé. Absent signifie que l’hôte ne transmet aucune clé pour cette question : le nœud ne déclare aucun workload, son workload ne déclare aucun Service, ou l’identité est fixée avant la résolution de tout workload. Un invité ne juge alors aucun nom construit à partir d’une clé de Service, et répond exactement comme il le ferait si le champ n’existait pas.

Les propriétés supplémentaires ne sont pas autorisées.

DerivedNameVerdict

Le verdict d’un type de nom sur une identité proposée : si le nom que l’invité dériverait pour ce type est un nom que sa cible accepte, et — là où une identité plus courte serait acceptée — la plus grande longueur qui le serait. Il porte une contrainte et une raison, jamais un nom construit par l’invité.

PropriétéTypeObligatoireDescription
kindstringouiLe nom propre à l’invité pour le type de nom que couvre ce verdict, écrit dans le vocabulaire de la cible plutôt que dans celui du compilateur — le nom de release d’un installateur de chart, le nom de service d’un orchestrateur de conteneurs. Il atteint un lecteur tel quel dans un refus, il est donc écrit pour quelqu’un qui connaît la cible.
usablebooléenouiIndique si le nom que l’invité dériverait pour ce type à partir de l’identité proposée est un nom que la cible accepte.
boundintegernonLe plus grand nombre de caractères qu’une identité proposée peut porter pour que le nom dérivé de ce type soit un nom que la cible accepte. Présent uniquement sur un refus qu’une identité plus courte satisferait. ABSENT signifie que la longueur n’est pas ce à quoi la cible s’est opposée — soit il n’existe aucune limite de longueur, soit l’objection est de celles qu’aucun raccourcissement ne répare, comme un caractère que la grammaire de la cible refuse à la position où il s’est retrouvé. L’absence est donc distincte d’une borne de zéro, qui, elle, énonce une longueur : qu’aucune identité, quelle que soit sa longueur, ne produit un nom acceptable de ce type. L’hôte raccourcit jusqu’à une borne présente et pose de nouveau la question ; face à une borne absente, il s’arrête, car il ne reste rien à essayer.
reasonstringnonPourquoi la cible n’accepte pas le nom dérivé, dans les propres termes de la cible, pour un lecteur qui décide de ce qu’il doit écrire à la place. Vide lorsque le verdict est utilisable.

Les propriétés supplémentaires ne sont pas autorisées.

NameBoundOutput

Le payload qu’un invité du Provider renvoie depuis son export name_bound : un verdict par type de nom qu’il dériverait de l’identité proposée. Une proposition est utilisable lorsque chaque verdict l’est ; lorsque l’un ne l’est pas, l’hôte raccourcit la proposition à la plus petite borne que portent les verdicts de refus et pose de nouveau la question, et il s’arrête lorsqu’un verdict de refus ne porte aucune borne. Une liste de verdicts vide signifie que l’invité ne dérive aucun nom d’une identité de composant, ce qui est la même réponse qu’accepter la proposition.

PropriétéTypeObligatoireDescription
namesDerivedNameVerdict[]nonUne entrée par type de nom que l’invité dérive d’une identité de composant, dans l’ordre propre à l’invité. Un invité signale chaque type qu’il dériverait plutôt que seulement les types qui ont refusé, de sorte qu’un lecteur voit quels noms ont été jugés et qu’un hôte qui lit les entrées n’a pas besoin d’un second appel pour connaître le reste.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. Il se distingue d’un verdict de refus : un verdict signale un nom que la cible n’acceptera pas, tandis que error signale que la question elle-même n’a pas pu recevoir de réponse. L’hôte présente un error présent comme un appel de plugin en échec.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

RenderedNameInput

Le payload qu’un invité du Provider reçoit par son export facultatif rendered_name : les deux identités à partir desquelles une cible dérive ses propres noms, et les types d’entrée que déclare la Recipe du nœud — une source fournie par l’auteur, un workload que l’invité synthétise. L’invité répond par le nom que sa cible donnera aux ressources qu’il rend pour ce nœud : pour une source fournie, le nom par rapport auquel les propres templates de l’auteur sont rendus, comme le nom de release que lit un chart ; pour un workload synthétisé, le nom que l’invité donne aux ressources qu’il construit, lorsqu’il en dérive un au lieu d’écrire l’identité du nœud telle quelle. Un invité qui ne dérive aucun nom de ce type n’en signale aucun, ce qui est la réponse honnête pour une cible dont une Recipe écrit les noms de ressources tels quels, et pour une cible dont le nom dépend de l’endroit où les fichiers sont placés plutôt que du nœud. Cet export signale un nom que l’invité compose lui-même et n’est pas l’échange qui demande à l’invité de juger un nom que propose l’hôte ; ce sont des questions différentes et chacune a son propre export.

PropriétéTypeObligatoireDescription
node_idstringouiL’identité propre du nœud, telle qu’elle a été rédigée. Elle est portée sans encodage : une cible la restreint au moyen de son propre alphabet, de sorte que l’encoder au préalable placerait un échappement dans un autre et écrirait le nom différemment de celui d’après lequel l’auteur d’une recette le prévoit.
derived_name_basisstringnonL’identité par rapport à laquelle la source propre d’un contributeur est rendue lorsqu’elle n’est pas celle du nœud — définie pour un contributeur dont l’identité est refusée par l’alphabet de noms d’une cible, absente sinon. Un invité résout la paire de la même façon que toute autre surface : cette valeur lorsqu’elle est présente, l’identifiant du nœud sinon.
sourcedbooléennonIndique si la Recipe liée du nœud déclare une source fournie par l’auteur, lu à partir du texte que l’auteur a écrit. Il est porté, avec synthesized, afin que la question puisse être posée pour n’importe quel nœud et recevoir une réponse correcte : un invité ne signale aucun nom pour un nœud qui ne déclare ni l’un ni l’autre, dont la sortie est un ensemble d’artefacts seul, car les ressources d’un tel ensemble sont nommées par les artefacts que l’auteur a écrits plutôt que par un nom que dérive l’invité.
synthesizedbooléennonIndique si la Recipe liée du nœud déclare un workload que l’invité doit synthétiser, lu à partir du texte que l’auteur a écrit, comme l’est sourced. Un invité dont la cible nomme les ressources qu’il synthétise d’après un nom qu’il dérive, plutôt que d’après l’identité du nœud telle qu’elle est écrite, signale ce nom pour un tel nœud, de sorte qu’une adresse qu’une Recipe publie pour l’une de ces ressources puisse être construite à partir du nom que porte la ressource.

Les propriétés supplémentaires ne sont pas autorisées.

RenderedNameOutput

Le payload qu’un invité du Provider renvoie depuis son export rendered_name : le nom que sa cible donne aux ressources qu’il rend pour le nœud — à partir de la source du nœud fournie par l’auteur, ou du workload qu’il synthétise — ou aucun nom. Un nom absent ou vide est une réponse positive plutôt qu’un échec — il indique que cette cible ne dérive aucun nom de ce type — et l’hôte utilise ce qu’on lui a dit sans le lire, de sorte qu’aucune connaissance du nommage de la cible ne franchit la frontière.

PropriétéTypeObligatoireDescription
namestringnonLe nom sous lequel l’invité rend la source de ce nœud fournie par l’auteur, ou qu’il donne aux ressources qu’il synthétise pour le nœud, déjà écrit dans l’alphabet que sa cible accepte à cette position. Vide ou absent signifie que l’invité ne dérive aucun nom de ce type.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. Il se distingue du fait de ne signaler aucun nom : l’absence de nom est une réponse au sujet de la cible, tandis que error signale que la question elle-même n’a pas pu recevoir de réponse. L’hôte présente un error présent comme un appel de plugin en échec.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

LinkEndpoint

Un point de terminaison d’un lien inter-frontières : le nœud, le chemin de frontière dans lequel sa sortie rendue s’assemble, et le fournisseur qui l’a rendu. Les deux points de terminaison d’un lien nomment les extrémités consommatrice et consommée d’une arête uses dont les extrémités s’assemblent dans des groupes de distribution différents.

PropriétéTypeObligatoireDescription
nodestringouiL’identifiant absolu du nœud du point de terminaison dans le graphe de topologie.
boundarystringouiLe chemin de frontière du point de terminaison — le groupe de distribution dans lequel sa sortie rendue s’assemble.
providerstringouiLe fournisseur qui a rendu le point de terminaison (le simple nom du fournisseur). Les deux points de terminaison d’un lien câblé nomment le même fournisseur ; l’hôte n’achemine pas un lien dont les points de terminaison nomment des fournisseurs différents.
releasestringnonLa Release à laquelle appartient la sortie rendue du point de terminaison — la portée dans laquelle ses artefacts assemblés sont nommés. L’hôte l’assemble à partir de la Release que le build a résolue et la transmet telle quelle ; il n’infère aucune signification de la valeur. Un fournisseur la lit pour limiter à la Release la portée d’un nom de référence croisée. Une valeur absente est la chaîne vide, qu’un fournisseur traite comme un nom sans portée.

Les propriétés supplémentaires ne sont pas autorisées.

LinkEdge

Le payload par arête généralisé et agnostique vis-à-vis du domaine que l’hôte assemble pour une arête uses dont les extrémités consommatrice et consommée s’assemblent dans des groupes de distribution différents. Il porte les deux points de terminaison, les annotations de placement des deux points de terminaison sous forme de maps scalaires opaques que l’hôte n’interprète pas, la sortie provides du point de terminaison consommé, ainsi que le socket et le mappage inject que câble l’arête. Un fournisseur le lit pour produire le câblage de référence croisée natif du fournisseur dont les deux extrémités ont besoin ; l’hôte l’assemble et transmet la map d’annotations sous forme de scalaires opaques, sans inférer aucune signification d’aucune valeur.

PropriétéTypeObligatoireDescription
sourceLinkEndpointouiLe point de terminaison consommateur — l’extrémité source de l’arête uses orientée, dans la sortie assemblée de laquelle le câblage côté consommateur est injecté.
targetLinkEndpointouiLe point de terminaison consommé — l’extrémité cible vers laquelle pointe l’arête uses, dont le câblage côté producteur publie la sortie assemblée.
target_annotationsmap de stringnonLes annotations de placement du point de terminaison consommé (cible) sous forme de map scalaire opaque, indexée par nom d’annotation. L’hôte les assemble à partir des annotations résolues de la cible et les transmet telles quelles ; il n’infère aucune signification d’aucune valeur. Un fournisseur les lit pour décider comment façonner une référence croisée (par exemple si les deux extrémités partagent un placement ou ont besoin d’une référence entre placements). Les clés sont sérialisées dans l’ordre trié afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
source_annotationsmap de stringnonLes annotations de placement du point de terminaison consommateur (source) sous forme de map scalaire opaque, indexée par nom d’annotation. L’hôte les assemble à partir des annotations résolues de la source et les transmet telles quelles ; il n’infère aucune signification d’aucune valeur. Un fournisseur les lit pour comparer le placement des deux extrémités — par exemple si la source et la cible partagent un placement ou se trouvent dans des placements différents. Les clés sont sérialisées dans l’ordre trié afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
socketstringouiL’alias de socket sous lequel l’arête uses est liée.
providesmap de stringouiLa sortie provides du point de terminaison consommé, un ensemble de clés ordonné par l’auteur qui expose les sorties déclarées de la cible. Préserve l’ordre de l’auteur afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
injectobjectouiLe mappage inject du point de terminaison consommateur, indexé par mécanisme de livraison vers un ensemble de clés ordonné par l’auteur, qui décrit comment l’extrémité consommatrice reçoit la sortie du point de terminaison consommé. Préserve l’ordre de l’auteur afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
read_provides_keysstring[]nonLes clés de la sortie provides du point de terminaison consommé que les templates du point de terminaison consommateur lisent directement au moyen de .context.uses, que le mappage inject les livre aussi ou non, dans l’ordre de l’auteur de provides. Chaque entrée est l’une des clés que porte provides. La liste voyage sur l’arête afin que la publication côté producteur et la résolution côté consommateur lisent une seule liste. Absent lorsque le point de terminaison consommateur n’a lu directement aucune clé de provides, et un fournisseur qui n’en reçoit aucune câble le lien exactement comme il le ferait si le champ n’existait pas.

Les propriétés supplémentaires ne sont pas autorisées.

LinkPatch

Un patch structurel par fichier qu’un fournisseur renvoie comme câblage d’artefacts : le fichier de sortie et les opérations structurelles ordonnées à lui appliquer. Une passe ultérieure de l’hôte découpe le fichier nommé, applique les opérations et le réassemble fidèlement à l’octet près. La forme de l’opération est le vocabulaire partagé des opérations de patch du pipeline ; elle est opaque à ce niveau du schéma, de sorte qu’un invité porte chaque opération telle quelle tandis que l’hôte réalise l’opération typée que son pipeline applique.

PropriétéTypeObligatoireDescription
filestringouiLe fichier de sortie auquel s’appliquent les opérations, nommé tel que le fournisseur l’a émis.
opsany[]ouiLes opérations structurelles ordonnées à appliquer au fichier, dans l’ordre d’application.

Les propriétés supplémentaires ne sont pas autorisées.

LinkPublishInput

Le payload qu’un fournisseur reçoit par son export link_publish : un lien inter-frontières dont la sortie du point de terminaison consommé est référencée à travers une frontière, et les fichiers assemblés de ce point de terminaison. L’export renvoie l’identité publiée par rapport à laquelle le consommateur effectue la résolution et tout câblage d’artefacts côté producteur dont la sortie du point de terminaison consommé a besoin.

PropriétéTypeObligatoireDescription
edgeLinkEdgeouiLe lien inter-frontières en cours de publication, lu du côté du point de terminaison consommé (cible).
producer_filesRenderedFile[]nonLes fichiers assemblés du point de terminaison consommé, afin que le fournisseur puisse lire ce que ce point de terminaison déclare déjà et vérifier par rapport à eux les noms qu’il s’apprête à publier. Chacun nomme son chemin sur disque et porte les octets assemblés. Absent lorsque l’hôte n’a aucune sortie de producteur assemblée à remettre à la publication ; un fournisseur qui n’a besoin d’aucun document pour rédiger son câblage l’ignore.

Les propriétés supplémentaires ne sont pas autorisées.

LinkPublishOutput

Le payload qu’un fournisseur renvoie depuis son export link_publish : le handle d’identité publiée par rapport auquel le consommateur effectue la résolution, et le câblage d’artefacts côté producteur à appliquer à la sortie assemblée du point de terminaison consommé.

PropriétéTypeObligatoireDescription
handlemap de stringouiL’identité publiée que le point de terminaison consommé expose pour que le consommateur effectue la résolution par rapport à elle, une map opaque de chaînes de pointeurs déterministes indexée par nom de champ (par exemple un nom d’export, un nom de stack, une région, une référence de rôle). Les valeurs sont des chaînes de pointeurs déterministes que le compilateur achemine et ne résout jamais ; l’environnement d’exécution les résout au moment du déploiement. Les clés sont sérialisées dans l’ordre trié afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
patchesLinkPatch[]nonLe câblage d’artefacts côté producteur, un patch structurel par fichier de sortie du point de terminaison consommé que la publication doit modifier. Vide lorsque la sortie du point de terminaison consommé ne nécessite aucune modification pour le lien.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu publier le lien ; absent en cas de succès. L’hôte présente un error présent comme un appel de plugin en échec. Une publication qui ne peut pas aboutir — un nom d’export que la stack déclare déjà sous une autre entrée, par exemple — est signalée ici plutôt que seulement comme un plantage, de sorte que la condition sous-jacente puisse être nommée.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.

LinkResolveInput

Le payload qu’un fournisseur reçoit par son export link_resolve : un lien inter-frontières, le handle d’identité publiée qu’a exposé son point de terminaison consommé, et les fichiers assemblés du point de terminaison consommateur. L’export renvoie le câblage d’artefacts côté consommateur qui injecte la référence dans la sortie assemblée du point de terminaison consommateur.

PropriétéTypeObligatoireDescription
edgeLinkEdgeouiLe lien inter-frontières en cours de résolution, lu du côté du point de terminaison consommateur (source).
handlemap de stringouiLe handle d’identité publiée qu’a renvoyé le link_publish du point de terminaison consommé, par rapport auquel le consommateur résout sa référence. Des chaînes de pointeurs déterministes opaques indexées par nom de champ ; le compilateur les achemine et ne les résout jamais. Les clés sont sérialisées dans l’ordre trié afin que le payload soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
consumer_filesRenderedFile[]nonLes fichiers assemblés du point de terminaison consommateur, afin que le fournisseur puisse localiser l’espace réservé que l’hôte a estampillé dans la sortie consommatrice et rédiger son remplacement au chemin réel de l’espace réservé. Chacun nomme son chemin sur disque et porte les octets assemblés. Absent lorsque l’hôte n’a aucune sortie de consommateur assemblée à remettre à la résolution ; un fournisseur qui n’a besoin d’aucun document pour rédiger son câblage l’ignore.

Les propriétés supplémentaires ne sont pas autorisées.

LinkResolveOutput

Le payload qu’un fournisseur renvoie depuis son export link_resolve : le câblage d’artefacts côté consommateur à appliquer à la sortie assemblée du point de terminaison consommateur, injectant la référence à l’identité publiée du point de terminaison consommé.

PropriétéTypeObligatoireDescription
patchesLinkPatch[]ouiLe câblage d’artefacts côté consommateur, un patch structurel par fichier de sortie du point de terminaison consommateur que la résolution doit modifier.
errorstringnonUn message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu résoudre le lien ; absent en cas de succès. L’hôte présente un error présent comme un appel de plugin en échec. Une résolution qui ne peut pas aboutir — une référence que la cible ne peut porter que comme un scalaire entier, rencontrée à l’intérieur d’une chaîne plus longue — est signalée ici plutôt que seulement comme un plantage, de sorte que la condition sous-jacente puisse être nommée.
condition_codestringnonL’identité descriptive et reconnaissable par une machine de la condition que nomme l’échec — le code sous lequel la condition est enregistrée, dans le même ensemble ouvert que celui dans lequel le compilateur enregistre ses propres conditions d’arrêt, et non un membre du catalogue fermé des codes d’erreur des fonctions hôtes dont est tiré le hostfunc_error_code d’une enveloppe de réponse. Définie à côté du message d’erreur lisible par un humain ; absente en cas de succès, et absente lorsque l’invité ne nomme aucune condition de ce type. Un invité qui s’arrête signale ici l’identifiant de la condition que nomme son message, de sorte qu’un consommateur se ramifie sur lui au lieu de reconstituer une identité en lisant le message. L’hôte résout cet identifiant par rapport aux conditions que le compilateur déclare et publie les identifiants propres de la condition résolue sur le diagnostic structuré, de sorte qu’un code qui parvient à un lecteur se résout toujours ; un identifiant qui ne nomme aucune condition de ce type, ou un identifiant que la numérotation a retiré, arrête le build. Un invité sans condition précise à nommer se tourne plutôt vers l’une des conditions génériques d’échec de plugin que le compilateur déclare à cet effet, et met les détails dans son propre message. Cet identifiant et condition_short_code sont signalés ensemble, car ils nomment une même condition sous deux formes : un invité qui définit l’un et pas l’autre a nommé une condition que l’hôte ne peut pas résoudre, et l’hôte signale alors sa propre condition générique d’échec de plugin à la place, tandis que le message porte toujours l’échec entier.
condition_short_codestringnonL’identifiant compact de la même condition — la lettre E et quatre chiffres, la forme qu’un lecteur cite, recherche et colle dans un rapport — défini à côté du message d’erreur lisible par un humain ; absent en cas de succès, et absent lorsque l’invité ne nomme aucune condition de ce type. L’hôte l’imprime dans l’en-tête entre crochets du diagnostic qu’il produit pour cet échec, de sorte qu’une condition que lève un invité est citable exactement comme une condition que lève le compilateur. L’hôte résout la valeur par rapport aux conditions que le compilateur déclare plutôt que de la porter de confiance : une valeur qui ne nomme aucune condition de ce type, une valeur que la numérotation a retirée, ou une graphie que l’enregistrement ne porte pas arrête le build et cite la valeur fautive, le propre message de l’invité étant toujours signalé. Il est signalé avec condition_code, pour la raison indiquée à cet endroit.

Les propriétés supplémentaires ne sont pas autorisées.