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

Schéma du contexte des modèles de chemin 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/path-template-context-v1beta1.schema.json

La liste d’autorisation des variables consommée par les modèles Go évalués par rapport à Release.spec.boundaries[].directory et Release.spec.boundaries[].subDirectory (et à la surcharge subDirectory par composant) lorsqu’Aggrega effectue le build de la Release. Les modèles de chemin utilisent missingkey=error (à la différence du régime global missingkey=zero des modèles de valeur) ainsi qu’une validation au moment de l’analyse : chaque référence à un champ dans un modèle de chemin doit figurer dans cette liste d’autorisation pour le contexte concerné (directory: ou subDirectory:) ; les champs inconnus produisent une erreur Loud Guardrail au moment de l’analyse, jamais au moment du rendu. La page sur les variables des modèles de chemin de la référence du langage explique la différence avec les modèles de valeur.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
capabilitystringnonDisponible dans directory: ET subDirectory:. La capacité de rendu que la Recipe du composant contributeur déclare dans spec.capability, sans aucun épinglage de version — par exemple ‘helm’, ‘helm-chart’ ou ‘compose’. subDirectory: vaut par défaut {{ .capability }}, ce qui place les artefacts de chaque capacité dans leur propre sous-dossier sous le répertoire de la frontière. Dans un modèle directory:, la valeur est résolue par composant, de sorte qu’une frontière dont le sous-arbre apporte plus d’une capacité s’évalue en un répertoire par capacité ; le parcours distinct par frontière qui publie .parent_boundary.directory s’exécute avant qu’un composant ne soit lié et laisse cette valeur vide.
boundary_namestringnonDisponible dans directory: ET subDirectory:. La clé de la map dans release.spec.boundaries..
parametersobjectnonDisponible dans directory: ET subDirectory:. Map typée des paramètres provenant de la Release. Les modèles de chemin reçoivent l’accès à .parameters par une exception délibérée au cycle de vie à passe unique de parameters — les modèles de valeur ne reçoivent PAS .parameters ; les valeurs propres à l’environnement parviennent aux modèles de valeur via le YAML de l’Aggregate déjà interpolé.
component_idstringnonDisponible UNIQUEMENT dans subDirectory:. L’identité du contributeur en cours de placement. Pour un composant, son ID d’instance aplati par composant (par ex. ‘backend’ ou ‘data-layer.main-db’). Pour une Feature rattachée à une frontière dont la FeatureRecipe s’exécute une seule fois pour la frontière (executionScope: boundary), l’identité de composant composée que porte, dans son étiquette aggrega.ai/component-id, chaque ressource émise par ce rattachement (par ex. ‘bfr—app—shared’ pour un rattachement ‘shared’ à la frontière ‘app’), raccourcie là où le plugin de rendu du rattachement borne les noms, de sorte que le répertoire qu’elle nomme corresponde à cette étiquette. Dépourvu de sens au niveau de la frontière et rejeté par la validation à l’analyse dans les templates directory:.
parent_boundaryobjectnonDisponible dans directory: ET subDirectory:. Les valeurs déjà résolues de la frontière parente. Rempli via un parcours en profondeur qui évalue les modèles de chaque frontière avec les valeurs résolues de sa parente ; les enfants ne voient jamais leurs propres valeurs ici. Une frontière de premier niveau n’a pas de parente, de sorte qu’une clé lue sous parent_boundary à cet endroit interrompt le build, en nommant la frontière, le champ du modèle et la clé manquante.
manifestobjectnonDisponible dans directory: ET subDirectory:. Porte les métadonnées de la Recipe résolue telles qu’évaluées par composant.

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

path-template-context.parent_boundary

Disponible dans directory: ET subDirectory:. Les valeurs déjà résolues de la frontière parente. Rempli via un parcours en profondeur qui évalue les modèles de chaque frontière avec les valeurs résolues de sa parente ; les enfants ne voient jamais leurs propres valeurs ici. Une frontière de premier niveau n’a pas de parente, de sorte qu’une clé lue sous parent_boundary à cet endroit interrompt le build, en nommant la frontière, le champ du modèle et la clé manquante.

PropriétéTypeObligatoireDescription
directorystringnonChaîne du répertoire évalué du parent.
boundary_namestringnonNom du parent (la clé de la map dans release.spec.boundaries).
parametersobjectnonLa map des paramètres de la Release — la même map que porte .parameters.
annotationsmap de stringnonLes annotations de la frontière parente une fois la cascade résolue.

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

path-template-context.manifest

Disponible dans directory: ET subDirectory:. Porte les métadonnées de la Recipe résolue telles qu’évaluées par composant.

PropriétéTypeObligatoireDescription
recipe_namestringnonLe nom de la Recipe résolue issu de la recherche par composant.

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