Schéma de la base d’infrastructure d’Aggrega (Recipe)
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/recipe-v1beta1.schema.json
Couche de pointeurs et de mappage rédigée par Ops qui relie l’intention Dev à un fournisseur d’infrastructure spécifique. Strictement 1:1 avec un fournisseur physique et un composant du catalogue.
Consultez la référence de rédaction de la Recipe pour des conseils rédigés sur l’écriture des entités Recipe ; cette page documente le schéma structurel que décrit cette référence.
Type de premier niveau : object
Propriétés
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | oui | Constante : "aggrega.ai/v1beta1" |
kind | const “Recipe” | oui | Constante : "Recipe" |
metadata | object | oui | |
spec | object | oui | La liaison au fournisseur, la source, le mappage des values et le pipeline d’une Recipe. Prend en charge trois types d’entrée composés par addition : avec source (source plus la surcouche valuesMapping), synthétisé (workload) et artifacts (fichiers de sortie nommés). Indépendamment de ceux-ci, une Recipe peut apporter des fichiers à la sortie partagée de la frontière dans laquelle elle est rendue, sous ‘boundary’. |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.metadata
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Au moins 1 caractère. |
version | string | oui | Versionnage sémantique strict de la recette d’implémentation (par ex. 2.1.0). Motif : ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | non | Ce qu’est cette entité et à quoi elle sert, écrit pour quelqu’un qui décide s’il va l’utiliser. Commencez par une phrase qui nomme la chose, puis ajoutez ce dont un lecteur a besoin pour la choisir et l’utiliser correctement — ce qu’elle attend de la Release qui la déploie, et tout ce que son comportement a de surprenant. Un court paragraphe est la longueur habituelle. |
maintainers | object[] | non | Liste des mainteneurs responsables de cette entité. |
license | string | non | Identifiant SPDX de la licence du logiciel que décrit cette entité, par exemple MIT ou AGPL-3.0. Il consigne les conditions de ce logiciel, pas celles de ce fichier. |
repository | string | non | L’URL du dépôt Git où se trouvent les fichiers source. |
home | string | non | L’URL de la page d’accueil, du wiki ou de la documentation de cette entité. |
keywords | string[] | non | Une liste de mots-clés descriptifs pour la découvrabilité dans l’interface utilisateur. |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.metadata.maintainers[]
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | |
email | string | non | |
url | string | non |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.spec
La liaison au fournisseur, la source, le mappage des values et le pipeline d’une Recipe. Prend en charge trois types d’entrée composés par addition : avec source (source plus la surcouche valuesMapping), synthétisé (workload) et artifacts (fichiers de sortie nommés). Indépendamment de ceux-ci, une Recipe peut apporter des fichiers à la sortie partagée de la frontière dans laquelle elle est rendue, sous ‘boundary’.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
capability | string | oui | La capacité de fournisseur explicite à laquelle cette recette se lie (par ex. ‘helm’, ‘terraform’, ‘compose’) — le type de fournisseur qui la rend. Accepte un épinglage de version facultatif, sous les trois mêmes formes que ‘implements’ : sans version (‘helm’), exacte (‘helm:1.0.0’) ou plage compatible avec la version majeure (‘helm:^1.0.0’). Le nom nu sélectionne le type de fournisseur ; l’épinglage, lorsqu’il est présent, sélectionne quelle version du plugin de rendu de fournisseur qui sert cette capacité rend cette recette — la plus haute disponible sans épinglage, la version exacte pour un épinglage exact, la plus haute de la plage pour un accent circonflexe. Un épinglage qu’aucune version de plugin servant la capacité ne satisfait interrompt le build de manière explicite. Tout ce qui se trouve en aval de la sélection du fournisseur — regroupement de la sortie, segments de chemin, compatibilité du pipeline et choix du codec — repose sur la capacité nue, de sorte que deux recettes épinglant des versions de plugin différentes de la même capacité coexistent dans un même build. |
implements | string | oui | Déclare quel type de composant du catalogue cette recette est capable d’implémenter (version exacte ‘core/api-server:1.0.0’, plage compatible avec la version majeure ‘core/api-server:^1.0.0’ ou sans version ‘core/api-server’). Le compilateur l’utilise pour vérifier les mappages du Manifest et pour suggérer des candidats dans les diagnostics et la complétion de l’éditeur ; il ne résout jamais un build. aggrega lint le lit également, pour localiser le Component dont le contrat provides déclaré sert de référence à la comparaison des clés publiées d’une Recipe. Le mappage du Manifest est le choix explicite d’implémentation de l’utilisateur, épinglé dans le fichier de verrouillage de la Release. |
source | string ou object | non | L’emplacement du code d’infrastructure. Accepte une chaîne URI ou un objet structuré ouvert dont les clés définies par le fournisseur sont exposées aux templates de la Recipe sous la forme ‘.source.*’. |
locals | map de string | non | L’état privé des Ops. Résultats de calcul internes disponibles dans les templates de cette Recipe sous la forme ‘.locals.*’. Chaque entrée est elle-même un template Go, évalué par rapport à un contexte autonome local au nœud : ‘.context.instance_id’, ‘.values’, ‘.infra’ et les entrées de ce même bloc résolues jusque-là. Les entrées se résolvent dans l’ordre où elles sont écrites, et une entrée PEUT lire une entrée sœur définie AU-DESSUS d’elle, recevant la valeur résolue de cette entrée plutôt que le texte de son template. L’ordre de l’auteur fait partie du contrat partout où une entrée en lit une autre : déplacer une définition sous l’entrée qui la lit casse le build, et le bloc n’est jamais réordonné pour qu’une référence se résolve. Une référence ‘.locals. |
provides | map de string ou number ou boolean | non | L’API publique du Développeur. Variables de sortie contractuelles disponibles pour la résolution de l’inject de l’Appelant en aval. Le compilateur évalue les templates de provides par rapport à un contexte autonome, dans n’importe quel ordre entre eux — aucune entrée de provides n’en lit une autre. Les locals du nœud se résolvent dans le préambule des locals, avant ses provides, de sorte qu’un template de provides peut lire ‘.locals’ et reçoit des valeurs résolues ; nommer une clé que le bloc locals ne déclare pas provoque un arrêt. Les Appelants résolvent les clés d’inject par rapport à ces valeurs lors de l’hydratation de l’inject. Les valeurs sont des scalaires — le pipe les transporte telles quelles et les convertit en chaînes de manière déterministe à la limite de l’injection. |
valuesMapping | string ou object | non | Contenu du mappage des values avec trois modes de rédaction par aiguillage selon la forme du contenu. Mode 1 (inline) : un scalaire chaîne de template Go (typiquement du YAML en scalaire de bloc |) produisant le format de values attendu par le fournisseur à partir du contexte Aggrega (.values, .features, .infra). Mode 2 (import de fichier) : une map YAML d’exactement une clé, $import: ./relative/path.tmpl, pointant vers un fichier de template Go local. Mode 3 (import de bibliothèque) : une map YAML d’exactement une clé, $import: <Library>#/mappings/<entry>, référençant une entrée de MappingLibrary par identité de nom nu (la version est fournie par le fichier de verrouillage propre à chaque Release ; aucun hôte de registre n’apparaît dans la référence). Dans la forme objet, $import ne doit pas correspondre à ^oci:// ; une valeur qui y correspond est refusée. |
workload | string ou object | non | Producteur de YAML de Workload avec trois modes de rédaction par aiguillage selon la forme du contenu. Mode 1 (inline) : un scalaire chaîne de template Go dont la sortie s’analyse comme ‘aggrega.ai/v1beta1 Workload’. Mode 2 (import de fichier) : une map YAML d’exactement une clé, $import: ./relative/path.yaml, pointant vers un fichier de template Go local. Mode 3 (import de bibliothèque) : une map YAML d’exactement une clé, $import: <Library>#/workloads/<entry>, référençant une entrée de WorkloadLibrary par identité de nom nu (la version est fournie par le fichier de verrouillage propre à chaque Release ; aucun hôte de registre n’apparaît dans la référence). Le Provider cible doit prendre en charge la synthèse de charges de travail ; le catalogue de la bibliothèque standard déclare workloadSchema sur ces fournisseurs comme contrat documenté. Une Recipe avec workload: liée à un fournisseur qui ne peut pas synthétiser provoque un arrêt explicite au moment du rendu. Dans la forme objet, $import ne doit pas correspondre à ^oci:// ; une valeur qui y correspond est refusée. |
artifacts | map de string ou object | non | Map du nom d’entrée vers la rédaction du contenu d’artefact. La valeur de chaque entrée porte l’un de trois modes par aiguillage selon la forme du contenu. Mode 1 (inline) : un scalaire chaîne de template Go dont la sortie est le corps de l’artefact. Mode 2 (import de fichier) : une map YAML d’exactement une clé, $import: ./relative/path.yaml, pointant vers un fichier de template Go local. Mode 3 (import de bibliothèque) : une map YAML d’exactement une clé, $import: <Library>#/artifacts/<entry>, référençant un bundle d’ArtifactLibrary par identité de nom nu (la version est fournie par le fichier de verrouillage propre à chaque Release ; aucun hôte de registre n’apparaît dans la référence). Un bundle se développe en une sortie par fichier, chacune imbriquée sous la clé de l’entrée sous la forme <key>/<filename>. La clé nomme la sortie de l’entrée : la clé d’une entrée de mode 1 ou 2 est son nom de fichier de sortie, utilisé tel qu’il est écrit, et le fichier importé d’une entrée de mode 2 fournit le contenu sans nommer la sortie, de sorte que deux entrées important des fichiers différents qui partagent un nom sont deux sorties distinctes. Les collisions entre entrées d’artefacts, fichiers de bundle, sortie de la source et synthèse de charges de travail interrompent le build lorsque le nœud est rendu. Le bloc artifacts se rédige de manière identique sur une Recipe et sur une FeatureRecipe — les trois mêmes modes, la même règle clé-sortie et le même comportement en cas de collision — c’est pourquoi cette partie de la description se lit de la même façon sur les deux types ; un exemple écrit pour l’un se transpose à l’autre sans modification. Dans la forme objet, $import ne doit pas correspondre à ^oci:// ; une valeur qui y correspond est refusée. Clés : la clé nomme la sortie de l’entrée, elle est donc limitée à un seul nom de fichier : elle commence par une lettre ou un chiffre et continue avec des lettres, des chiffres, des points, des traits d’union ou des traits de soulignement. Les points après le premier caractère conservent les extensions que portent les clés d’artefact (main.tf, template.yaml, serviceaccount.yaml). Un / ferait nommer à une clé un chemin plutôt qu’un fichier, et un . initial admettrait .., qui nomme un emplacement en dehors du répertoire de sortie — la classe du premier caractère refuse les deux. Pour un import de bibliothèque, la clé nomme le répertoire sous lequel les fichiers du bundle sont imbriqués, la même limite s’applique donc. Motif : ^[A-Za-z0-9][A-Za-z0-9._-]*$. |
omits | object[] | non | Ce qu’il faut exclure de ce que rend la source de cette Recipe — pour une source prise telle quelle qui rend quelque chose que la Release ne doit pas livrer : un document que rend un chart récupéré, comme un Secret contenant une clé que le chart génère à nouveau à chaque rendu, un service, un volume ou une config qu’un fichier compose récupéré embarque, ou une ressource que déclare un template CloudFormation récupéré. La plupart des Recipes n’en ont jamais besoin. Chaque entrée nomme une unité que rend la source par son type, son nom et, lorsque l’entrée les donne, son namespace et le sous-chart dont elle provient, chacun dans le vocabulaire du fournisseur qui rend la source — pour un chart, un document par son propre kind et son metadata.name ; pour un fichier compose, un service, un volume ou une config par sa clé sous services:, volumes: ou configs: ; pour un template CloudFormation, une ressource par son Type et son ID logique. Ce fournisseur exclut chaque unité à laquelle correspond une entrée, et ce à quoi correspond une entrée, et ce que le fournisseur refuse du fait d’une entrée, relève du contrat documenté propre à ce fournisseur. Un fournisseur qui ne peut rien exclure refuse une Recipe déclarant cette clé avant que quoi que ce soit ne soit rendu. Seul ce que rend source: est filtré — une entrée workload: ou artifacts: ne l’est jamais — la clé requiert donc source. Chaque valeur est un template, évalué par rapport au contexte par rapport auquel valuesMapping est évalué. Le when d’une entrée est évalué en premier, et une entrée dont le when rend une valeur falsy est abandonnée. Chaque entrée restée active doit exclure quelque chose : une entrée active qui ne correspond à rien de ce que la source a rendu interrompt le build, en nommant l’entrée. La source est tout de même rendue intégralement — chaque template d’un chart s’exécute tout de même, de sorte qu’un template qui échoue fait tout de même échouer le build — et seule sa sortie est exclue. Au moins 1 entrée. |
boundary | object | non | Ce que cette Recipe apporte à la sortie partagée de la frontière dans laquelle elle est rendue, plutôt qu’à la sortie de son propre composant. La plupart des Recipes n’en ont jamais besoin : il sert à un fichier que la cible lit une seule fois pour toute la frontière — une configuration de fournisseur Terraform, par exemple, que Terraform n’accepte que dans la configuration racine d’une frontière et jamais à l’intérieur du module d’un seul composant. Un fournisseur n’accepte de tels fichiers que là où son contrat déclare boundaryArtifacts, et une Recipe qui déclare ce bloc pour un fournisseur qui ne le fait pas est refusée avant tout rendu. Une FeatureRecipe ne porte aucun bloc de ce type. |
outputLabels | map de string | non | Labels déclarés par l’auteur de la Recipe, apposés sur chaque objet que produit la sortie rendue de cette recette, traduits par le fournisseur vers la surface de labels de chaque fournisseur (metadata.labels de Kubernetes pour la synthèse helm, le rendu de source et les artefacts ; labels de service Compose ; tags par ressource sur les corps d’artefacts .tf.json de Terraform). Ils empruntent le même rail que les labels de provenance fixes, mais appartiennent à l’auteur plutôt qu’au compilateur. Les namespaces aggrega.ai/ et app.kubernetes.io/ sont réservés à la provenance native de la plateforme et sont refusés au chargement. Une clé ou une valeur qui n’est pas un label valide pour le fournisseur cible relève de la responsabilité de l’auteur de la recette ; le cœur ne contrôle pas le jeu de caractères des labels au-delà de la règle des namespaces réservés. |
outputComponentLabels | string[] | non | Clés de labels d’identité du Component que cette recette promeut sur sa sortie rendue. Chaque entrée nomme une clé de label ; la valeur est prise dans les labels de l’instance de composant que rend cette recette, de sorte que le label apposé porte la valeur déclarée de ce composant plutôt qu’une valeur répétée ici. Les labels promus atteignent la même surface de labels que outputLabels, qui porte quant à lui des paires clé-valeur littérales rédigées sur place. Une clé déclarée dans les deux blocs est refusée au chargement, de sorte que chaque clé apposée a une source unique. Les namespaces aggrega.ai/ et app.kubernetes.io/ sont réservés à la provenance native de la plateforme et sont refusés au chargement ; une clé à portée telle que component.aggrega.ai/hosting se situe en dehors de ces racines réservées et peut être promue. |
pipeline | object[] | non | Liste séquentielle d’étapes de pipeline Wasm exécutées après le rendu sur l’ensemble des documents rendus, chacune renvoyant des patchs RFC 6902 et des effets de bord. |
assertions | map de string | non | Validation inter-champs au moment du build. Chaque entrée est une assertion nommée : la clé est un identifiant de règle stable qui apparaît dans les messages d’erreur ; la valeur est une chaîne de template Go avec la sémantique d’arrêt {{ fail "message" }}. Plusieurs assertions nommées par entité sont évaluées par instance dans l’ordre déclaré par l’auteur ; la première assertion en échec interrompt le build. Les assertions de Recipe sont évaluées après la liaison de la recette et après l’évaluation des provides, avant le rendu, et expriment des invariants d’implémentation du chart ou du module précis que la Recipe prend pour source. Contexte du template : .values / .infra / .uses / .features / .metadata plus .provides / .locals / .recipe. L’évaluateur utilise missingkey=error : les références à des clés non définies provoquent un arrêt avec un diagnostic no-such-key. Comme la simple référence provoque l’arrêt avant que tout repli puisse s’exécuter, un simple default ne fournit pas de repli pour un champ optionnel sur cette surface — protégez la référence avec hasKey, ou utilisez l’assistant optional, qui effectue directement la vérification de présence. Lire la clé via index n’en fournit pas non plus : index provoque un arrêt sur une clé de map que la map ne contient pas, en nommant la clé. |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.spec.omits[]
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
kind | string | oui | Le type de l’unité à exclure, dans le vocabulaire du fournisseur qui effectue le rendu de la source : pour un chart, le kind propre d’un document rendu, comme Secret ; pour un fichier compose, service, volume ou config ; pour un template CloudFormation, le Type d’une ressource, comme AWS::S3::Bucket. Il nomme un type que la source rend, et n’a aucun rapport avec le kind: que porte un source: structuré. Un template. |
name | string | oui | Le nom de l’unité à exclure, dans le vocabulaire du fournisseur qui effectue le rendu de la source : pour un chart, le metadata.name propre d’un document rendu ; pour un fichier compose, la clé de l’unité sous services:, volumes: ou configs: ; pour un template CloudFormation, l’ID logique de la ressource, sa clé sous Resources. Un template. |
namespace | string | non | Le namespace dans lequel se trouve l’unité à exclure, lorsque l’entrée ne doit correspondre qu’à une unité de ce namespace — pour un fournisseur dont la sortie a des namespaces, comme c’est le cas des documents rendus d’un chart. S’il est absent, ou s’il est rendu en chaîne vide, l’entrée correspond à une unité de son type et de son nom quel que soit son namespace. Un fichier compose et un template CloudFormation n’ont pas de namespaces, et leurs fournisseurs refusent une entrée qui en nomme un. Un template. |
subchart | string | non | Le sous-chart dont provient l’unité à exclure, lorsque l’entrée ne doit correspondre qu’à la copie que rend un sous-chart — pour une source assemblée à partir de sources imbriquées, comme l’est un chart à partir de ses sous-charts. Pour un chart, le nom propre du sous-chart, ou l’alias que lui donne la dépendance de son parent, les noms d’un sous-chart imbriqué étant joints par / à partir du plus externe : operator, ou operator/webhooks. L’entrée correspond alors à un document rendu à partir des templates/ ou des crds/ propres à ce sous-chart, et ni à un document que le chart rend lui-même ni à un document que rend un sous-chart imbriqué dans celui-ci. S’il est absent, ou s’il est rendu en chaîne vide, l’entrée correspond à une unité de son type et de son nom quelle que soit sa provenance. Un chart qui ne rend aucun sous-chart de ce nom arrête le build, en nommant l’entrée. Un fichier compose et un template CloudFormation n’ont pas de sous-charts, et leurs fournisseurs refusent une entrée qui en nomme un. Un template. |
when | string | non | Template Go inline évalué avant les autres champs de l’entrée. Lorsqu’il rend une valeur falsy, l’entrée est abandonnée : ses autres champs ne sont pas évalués, rien n’est exclu à cause d’elle, et elle n’est pas tenue de correspondre à quoi que ce soit. Un when vide ou absent conserve l’entrée. La valeur de vérité suit la convention standard pour une sortie de template de type booléen : les chaînes true/True/TRUE, tout nombre non nul et toute autre chaîne non vide sont vrais, tandis que false/False/FALSE, la chaîne vide et zéro sont faux. Un when dont le rendu échoue arrête le build. |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.spec.boundary
Ce que cette Recipe apporte à la sortie partagée de la frontière dans laquelle elle est rendue, plutôt qu’à la sortie de son propre composant. La plupart des Recipes n’en ont jamais besoin : il sert à un fichier que la cible lit une seule fois pour toute la frontière — une configuration de fournisseur Terraform, par exemple, que Terraform n’accepte que dans la configuration racine d’une frontière et jamais à l’intérieur du module d’un seul composant. Un fournisseur n’accepte de tels fichiers que là où son contrat déclare boundaryArtifacts, et une Recipe qui déclare ce bloc pour un fournisseur qui ne le fait pas est refusée avant tout rendu. Une FeatureRecipe ne porte aucun bloc de ce type.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
artifacts | map de string ou object | oui | Map du nom de fichier vers la rédaction du contenu du fichier, de forme identique aux artifacts propres de cette Recipe : les trois mêmes modes — une chaîne de template Go inline, un $import: d’un fichier de template Go local, ou un $import: d’un bundle d’ArtifactLibrary, dont les fichiers s’imbriquent sous la clé de l’entrée sous la forme <key>/<filename> — la même règle clé-nom de fichier et le même contexte de template, de sorte qu’une entrée peut lire .values, .infra, .locals et le reste exactement comme le fait une entrée artifacts. Ce qui diffère, c’est l’endroit où chaque fichier est écrit : une seule fois, dans le répertoire qui contient la sortie assemblée de la frontière, à côté des fichiers que l’assemblage propre du fournisseur y écrit, plutôt que dans le répertoire propre de ce composant. Chaque entrée est évaluée pour chaque composant que cette Recipe rend dans la frontière, et les fichiers que produisent ces évaluations sont fusionnés par nom : un même nom évalué en octets identiques par plusieurs composants, ou par plusieurs Recipes, constitue un seul fichier, tandis qu’un même nom évalué en octets différents interrompt le build en nommant le fichier et chaque contributeur, tout comme un nom que l’assemblage propre du fournisseur écrit déjà. Rien n’est apposé dans un tel fichier pour indiquer quel composant l’a écrit, car il appartient à chaque composant qui l’a déclaré. Une entrée dont le template ne rend rien n’écrit aucun fichier. Les entrées ne sont pas transmises au fournisseur, qui écrit le reste de la sortie de la frontière sans les lire. Dans la forme objet, $import ne doit pas correspondre à ^oci:// ; une valeur qui y correspond est refusée. Clés : la clé nomme le fichier, elle est donc limitée à un seul nom de fichier, selon la règle que suit une clé artifacts : elle commence par une lettre ou un chiffre et continue avec des lettres, des chiffres, des points, des traits d’union ou des traits de soulignement. Un / ferait nommer à une clé un chemin plutôt qu’un fichier, et un . initial admettrait .., qui nomme un emplacement en dehors du répertoire de sortie de la frontière — la classe du premier caractère refuse les deux. Pour un import de bibliothèque, la clé nomme le répertoire sous lequel les fichiers du bundle sont imbriqués, la même limite s’applique donc. Motif : ^[A-Za-z0-9][A-Za-z0-9._-]*$. Au moins 1 entrée. |
Les propriétés supplémentaires ne sont pas autorisées.
recipe.spec.pipeline[]
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
id | string | oui | Un identifiant programmatique pour cette étape, unique parmi les étapes de ce pipeline : un document qui déclare un même id sur deux de ses étapes est refusé lors de sa lecture. Une étape ultérieure du même pipeline lit les sorties de cette étape sous la forme .steps.<id>.outputs. Motif : ^[a-zA-Z0-9_]+$. |
plugin | string | oui | La référence à l’entité Plugin que cette étape exécute, toujours qualifiée par le type de socket propre au plugin : <pluginType>/<name> avec une version facultative, comme dans parser/yaml ou parser/yaml:1.0.0. La qualification est obligatoire et non une forme parmi d’autres — un name:version non qualifié est refusé, car deux sockets peuvent contenir un plugin du même nom et c’est la qualification qui rend l’entité résoluble. Le build résout l’entité en son artefact .wasm adressé par contenu — localisé à partir de l’identité du plugin et du registre configuré, son digest épinglé dans le fichier de verrouillage — et en charge les octets. Une simple référence à un .wasm ou à un artefact n’est pas acceptée ici. |
function | string | oui | La fonction Wasm exportée à invoquer. |
with | string | non | Template Go inline dont l’évaluation produit une map JSON/YAML qui satisfait strictement le schéma d’entrée explicite de ce plugin. |
optional | booléen | non | Lorsqu’il vaut true, un échec de cette étape (un trap du guest, un patch ciblant un document absent de l’ensemble, un patch mal formé ou un diagnostic de gravité arrêt) est rétrogradé en avertissement bien visible : l’ensemble de documents d’avant l’étape est restauré, la sortie de cette étape est écartée et le pipeline continue. Lorsqu’il vaut false ou est absent, tout échec d’étape arrête le build après la restauration de l’ensemble de documents d’avant l’étape. |
when | string | non | Template Go inline évalué au moment du parcours du pipeline. Lorsqu’il rend une valeur falsy, l’étape est sautée — un simple passage : l’ensemble de documents passe inchangé à l’étape suivante, sans apporter de patchs, d’effets de bord ni d’enregistrement d’étape. Un when vide ou absent exécute toujours l’étape. La valeur de vérité suit la convention standard pour une sortie de template de type booléen : les chaînes true/True/TRUE, tout nombre non nul et toute autre chaîne non vide sont vrais, tandis que false/False/FALSE, la chaîne vide et zéro sont faux. when et optional sont indépendants : une étape peut déclarer les deux. |
Les propriétés supplémentaires ne sont pas autorisées.