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

Modèles avancés

Cette page explique une idée, le Manifest et la FeatureRecipe en tant qu’endroits qui décident de ce qu’un build écrit au-delà de la Recipe propre d’un composant, et n’est pas un workspace exécutable. Remplacement de recette par instance montre la moitié relative au Manifest dans un workspace dont vous effectuez le build ; écrivez-le dans un dossier à vous avec :

Terminal window
aggrega scaffold --example per-instance-recipe-override

Elle affiche ensuite les prochaines commandes à exécuter :

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Une instance, une Recipe à elle

Le niveau type du Manifest lie chaque instance d’un type de composant à une seule Recipe. Son niveau name lie une seule instance, par son nom dans l’Aggregate, à une autre, et l’instance qui y est nommée la prend, tandis que toute autre instance du type conserve la liaison type. Extrait du manifest.yaml de l’exemple :

spec:
mappings:
components:
type:
example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0
name:
greeter-special: compose/greeter-green:1.0.0

L’entrée la plus spécifique l’emporte :

  1. l’entrée name pour le nom de l’instance ;
  2. l’entrée type qui nomme le type à la version de l’instance, comme example/compute/greeter:1.0.0 ;
  3. l’entrée type qui nomme le type sans version ;
  4. en l’absence de toute entrée, le build s’arrête en nommant l’instance non associée.

Un Manifest est du YAML ordinaire, donc une valeur qu’il répète peut être écrite une seule fois avec une ancre et référencée avec un alias.

Une Feature qui apporte ses propres ressources

Une FeatureRecipe peut rendre des ressources à côté de celles du composant, à partir d’un chart qui lui est propre, nommé par source: et alimenté par son valuesMapping, plutôt que de modifier ce que rend la Recipe du composant. Le core/public-ingress de la bibliothèque standard est réalisé de cette façon sur Kubernetes, par helm/public-ingress, qui rend un Ingress pour le composant auquel il est rattaché.

Le chemin de requête que sert un composant fait partie de ce qu’est l’application, la Feature le reçoit donc dans values ; le nom d’hôte est le nom que l’environnement donne au composant, il relève donc de infra, à côté des réglages qui décrivent le cluster. Dans Un agent, un routeur et deux modèles en amont, le développeur la rattache dans l’Aggregate et écrit le chemin :

features:
published:
type: core/public-ingress
values:
path: /

et la Release donne au même rattachement son hôte, et affirme qu’un contrôleur d’ingress s’exécute dans le cluster cible, affirmation sans laquelle le build s’arrête, extrait de release.yaml sans ses commentaires :

published:
infra:
host: assistant.example.internal
control_plane_present: true

La FeatureRecipe nomme les ressources qu’elle rend d’après .context.rendered_name, le nom du composant hôte tel que son fournisseur le rapporte, de sorte que l’Ingress pointe vers le Service que rend la Recipe propre du composant. Un host écrit dans les values de l’Aggregate, ou un path dans l’infra de la Release, est refusé en nommant le champ : chaque pilier est fermé, et le champ appartient à l’autre. Un chemin qui diffère entre environnements est un paramètre que déclare l’Aggregate et que remplit chaque Release.