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

Schéma de la base d’infrastructure d’Aggrega (FeatureRecipe)

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/featurerecipe-v1beta1.schema.json

Définitions rédigées par Ops qui associent une Feature abstraite du catalogue à une implémentation concrète et versionnée pour une capacité de fournisseur. Strictement 1:1 avec un fournisseur physique et une fonctionnalité du catalogue.

Consultez la référence de rédaction de la FeatureRecipe pour des conseils rédigés sur l’écriture des entités FeatureRecipe ; cette page documente le schéma structurel que décrit cette référence.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
apiVersionconst “aggrega.ai/v1beta1”ouiConstante : "aggrega.ai/v1beta1"
kindconst “FeatureRecipe”ouiConstante : "FeatureRecipe"
metadataobjectoui
specobjectouiLa liaison à la capacité de fournisseur, le mappage, le pipeline et le mappage d’injection d’une FeatureRecipe. Porte les trois mêmes types d’entrée qu’une Recipe (avec source, synthétisé, artifacts) plus l’injectMapping propre à la FeatureRecipe ; une FeatureRecipe de pur câblage qui ne déclare que capability et implements est valide et ne rend rien.

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

featurerecipe.metadata

PropriétéTypeObligatoireDescription
namestringouiAu moins 1 caractère.
versionstringouiVersionnage sémantique strict de la FeatureRecipe (par ex. 1.2.5). 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-]+)*))?$.
descriptionstringnonCe 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.
maintainersobject[]nonListe des mainteneurs responsables de cette entité.
licensestringnonIdentifiant 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.
repositorystringnonL’URL du dépôt Git où se trouvent les fichiers source.
homestringnonL’URL de la page d’accueil, du wiki ou de la documentation de cette entité.
keywordsstring[]nonUne 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.

featurerecipe.metadata.maintainers[]
PropriétéTypeObligatoireDescription
namestringoui
emailstringnon
urlstringnon

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

featurerecipe.spec

La liaison à la capacité de fournisseur, le mappage, le pipeline et le mappage d’injection d’une FeatureRecipe. Porte les trois mêmes types d’entrée qu’une Recipe (avec source, synthétisé, artifacts) plus l’injectMapping propre à la FeatureRecipe ; une FeatureRecipe de pur câblage qui ne déclare que capability et implements est valide et ne rend rien.

PropriétéTypeObligatoireDescription
capabilitystringouiLa capacité de fournisseur explicite à laquelle cette recette se lie (par ex. ‘helm’, ‘terraform’, ‘compose’) — le type de fournisseur qui la rend.
implementsstringouiDéclare quel type de Feature du catalogue cette recette est capable d’implémenter (y compris les Features d’identifiants portant le label feature.aggrega.ai/kind: secret ; version exacte, plage compatible avec la version majeure ’^’ ou sans version). 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. Le mappage du Manifest est le choix explicite d’implémentation de l’utilisateur, épinglé dans le fichier de verrouillage de la Release.
localsmap de stringnonL’état privé des Ops. Résultats de calcul internes disponibles uniquement dans les templates de cette FeatureRecipe sous la forme ‘.locals.*’. Chaque entrée est elle-même un template Go, évalué par rapport à un contexte autonome : ‘.context.instance_id’ (le COMPOSANT HÔTE pour lequel ce rattachement est résolu, ce que cette référence désigne sur chaque surface de template), ‘.attachment_name’ (l’instance de rattachement en cours de résolution, et le seul moyen d’atteindre ce nom depuis un local), les ‘.values’ et ‘.infra’ propres au rattachement, 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.’ à une entrée que ce bloc définit PLUS BAS provoque un arrêt qui nomme le défaut d’ordre ; une référence nommant une clé que le bloc ne déclare pas du tout provoque un arrêt qui nomme la clé. Les deux vérifications lisent le chemin vers lequel une référence SE RÉSOUT plutôt que les caractères saisis, et couvrent donc également la forme directe, une lecture dans un bloc ’{{ with .locals }}’, une lecture via une variable liée directement à ‘.locals’, et une clé lue sur le bloc entre parenthèses, ‘(.locals).’ ou ’($.locals).’. Une écriture qu’elles ne couvrent pas : une référence dont le texte du template ne décide pas le chemin — atteinte via une fonction, comme ‘index .locals’ ou ‘(default dict .locals).’, ou via un bloc ‘with’ ou une liaison de variable dont le pipeline en applique une, puisque ce que produit un tel pipeline est décidé à l’évaluation et non par son texte. Elle n’est pas analysée, et une clé absente atteinte de cette manière ne provoque pas d’arrêt : elle rend le texte littéral '' plutôt que rien du tout. La seule exception est ‘index’ lui-même : sur chaque surface de template, il provoque un arrêt, en nommant la clé, lorsque la map qu’il lit ne contient pas la clé demandée, de sorte qu’une clé absente atteinte via ‘index .locals’ provoque un arrêt. Les locals de cette FeatureRecipe se résolvent AVANT ses provides, de sorte qu’un template de provides peut lire ‘.locals’ et reçoit des valeurs résolues, tandis qu’un template de provides nommant une clé que ce bloc ne déclare pas provoque un arrêt. Les règles sont les mêmes que celles que suit le bloc locals d’une Recipe. Lorsque executionScope vaut boundary, le bloc est évalué une fois pour le rattachement à la frontière, par rapport au contexte de template de portée boundary plutôt qu’à celui d’un composant, et chaque composant atteint par le rattachement lit ces entrées résolues, y compris les ‘.locals’ que lit son injectMapping. Sert à exporter des réalités physiques (par ex. conteneurs cibles, chemins JSON) pour les plugins Wasm en aval. Jamais exposé aux appelants — utilisez provides pour l’API publique.
providesmap de stringnonL’API publique du Développeur. Variables de sortie contractuelles disponibles pour la résolution de l’inject de l’Appelant en aval. Lorsque executionScope vaut boundary, les provides sont évalués une fois pour le rattachement à la frontière, par rapport au contexte de template de portée boundary, et chaque composant atteint par le rattachement lit cette évaluation unique à ‘.features..provides’, tout comme une connexion que porte le rattachement ; le contrat provides que déclare la Feature implémentée est vérifié une fois, sur cette évaluation, en nommant le rattachement à la frontière.
sourcestring ou objectnonChemin facultatif vers du code d’infrastructure. Accepte une chaîne URI ou un objet structuré ouvert. S’il est fourni avec valuesMapping, le compilateur le rend, et les documents rendus rejoignent la sortie de la FeatureRecipe avant l’exécution des étapes de son pipeline.
valuesMappingstring ou objectnonContenu 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 produisant le format de values attendu par le fournisseur. 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.
workloadstring ou objectnonProducteur 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 FeatureRecipe avec workload: liée à un fournisseur qui ne peut pas synthétiser provoque un arrêt explicite au moment du rendu. Une charge de travail synthétisée d’une FeatureRecipe émet ses manifestes natifs du fournisseur dans le répertoire de sortie de la fonctionnalité. Dans la forme objet, $import ne doit pas correspondre à ^oci:// ; une valeur qui y correspond est refusée.
artifactsmap de string ou objectnonMap 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 ressources auxiliaires qu’émet une FeatureRecipe générant des ressources (ConfigMap, ServiceMonitor, NetworkPolicy, CRD ExternalSecret, etc.) ont la forme d’artefacts ; artifacts: est le principal mécanisme de génération de ressources. 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._-]*$.
omitsobject[]nonCe qu’il faut exclure de ce que rend la source de cette FeatureRecipe — 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 FeatureRecipes 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 FeatureRecipe 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. La clé se rédige de manière identique sur une Recipe et sur une FeatureRecipe. Au moins 1 entrée.
injectMappingstringnonTemplate Go inline facultatif évalué pendant la phase d’interception pré-rendu, une fois pour chaque composant atteint par le rattachement, par rapport au contexte de template de ce composant : il lit ‘.context’ et ‘.features’ du composant ainsi que ‘.attachment_name’, ‘.values’, ‘.infra’ et ‘.locals’ du rattachement, quoi qu’indique executionScope, et une référence à ‘.boundary’, que le contexte d’aucun composant ne porte, interrompt le build. Produit un dictionnaire JSON/YAML que le compilateur Go fusionne nativement en profondeur par-dessus le pipe mémoire ‘.context.inject’ de l’Appelant. Sert à la mutation côté Appelant, sans Wasm, des variables d’environnement et des contrats de livraison.
pipelineobject[]nonListe 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.
executionScopestring (enum)nonIndique si la Génération de ressources de cette FeatureRecipe s’exécute par composant (la valeur par défaut) ou une fois par rattachement à une frontière. Les FeatureRecipes de portée boundary sont dédupliquées par (boundary_path, instance de FeatureRecipe) et chaque template sauf l’injectMapping lit un contexte de template de portée boundary : les piliers .boundary.* au lieu des piliers .context.* par composant, dont toute référence interrompt le build. L’injectMapping s’exécute une fois pour chaque composant atteint par le rattachement quel que soit executionScope, il lit donc le contexte de ce composant et jamais .boundary. Valeurs autorisées : "component", "boundary" Par défaut : "component"
readsCallerRenderFactsbooléennonDéclare que les templates de cette FeatureRecipe lisent ce qu’ont rendu les Components qui se connectent à celui auquel elle est rattachée : les faits de rendu que le fournisseur de chacun de ces appelants rapporte sur sa propre sortie. Lorsque la valeur est true et que la FeatureRecipe effectue le rendu par composant, chacun de ses rattachements est rendu après que chaque Component du build a été rendu, au lieu de juste après le Component auquel elle est rattachée, de sorte que le rendu de chaque appelant est terminé avant que le rattachement soit évalué. Lorsque la valeur est false ou absente, l’entrée d’aucun appelant sur ‘.context.used_by’ ne porte de faits de rendu, le rattachement est rendu juste après son Component sauf si readsTargetRenderFacts vaut true, et le build s’interrompt sur un template écrit inline dans cette FeatureRecipe qui lit les faits de rendu d’un appelant sous ‘.context.used_by’. Par défaut : false
readsTargetRenderFactsbooléennonDéclare que les templates de cette FeatureRecipe lisent ce qu’ont rendu les Components auxquels est câblé celui auquel elle est rattachée : les faits de rendu que le fournisseur de chacune de ces cibles rapporte sur sa propre sortie, sur chaque entrée de ‘.context.uses’. Lorsque la valeur est true et que la FeatureRecipe effectue le rendu par composant, chacun de ses rattachements est rendu après que chaque Component du build a été rendu, au lieu de juste après le Component auquel elle est rattachée, de sorte que le rendu de chaque cible est terminé avant que le rattachement soit évalué. C’est le même rendu différé que provoque readsCallerRenderFacts, de sorte que définir l’une ou l’autre clé, ou les deux, fait que le rattachement est rendu à ce moment-là. Lorsque la valeur est false ou absente, aucune entrée de ‘.context.uses’ ne porte de faits de rendu, le rattachement est rendu juste après son Component sauf si readsCallerRenderFacts vaut true, et le build s’interrompt sur un template écrit inline dans cette FeatureRecipe qui lit les faits de rendu d’une cible sous ‘.context.uses’. Par défaut : false
assertionsmap de stringnonValidation 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 FeatureRecipe 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 FeatureRecipe 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.

featurerecipe.spec.omits[]
PropriétéTypeObligatoireDescription
kindstringouiLe 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.
namestringouiLe 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.
namespacestringnonLe 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.
subchartstringnonLe 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.
whenstringnonTemplate 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.

featurerecipe.spec.pipeline[]
PropriétéTypeObligatoireDescription
idstringouiUn 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_]+$.
pluginstringouiLa 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.
functionstringouiLa fonction Wasm exportée à invoquer.
withstringnonTemplate Go inline dont l’évaluation produit une map JSON/YAML qui satisfait strictement le schéma d’entrée explicite de ce plugin.
optionalbooléennonLorsqu’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.
whenstringnonTemplate 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.