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 :
aggrega scaffold --example per-instance-recipe-overrideElle affiche ensuite les prochaines commandes à exécuter :
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlUne 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.0L’entrée la plus spécifique l’emporte :
- l’entrée
namepour le nom de l’instance ; - l’entrée
typequi nomme le type à la version de l’instance, commeexample/compute/greeter:1.0.0; - l’entrée
typequi nomme le type sans version ; - 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: trueLa 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.