Розширені шаблони
Ця сторінка пояснює одну ідею — сутності Manifest і FeatureRecipe як місця, що вирішують, що збирання записує поза власною сутністю Recipe компонента, — і не є робочим простором, який можна запустити. Перевизначення рецепта для окремого екземпляра показує частину, що стосується Manifest, у робочому просторі, який ви збираєте; запишіть його у власну теку командою:
aggrega scaffold --example per-instance-recipe-overrideПотім вона виводить команди, які слід виконати далі:
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlОдин екземпляр, власна сутність Recipe
Рівень type сутності Manifest прив’язує кожен екземпляр типу компонента до однієї сутності Recipe. Її рівень name прив’язує окремий екземпляр, за його іменем у сутності Aggregate, до іншої, і названий там екземпляр отримує її, тоді як кожен інший екземпляр цього типу зберігає прив’язку type. З файлу manifest.yaml прикладу:
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Перемагає найконкретніший запис:
- запис
nameдля імені екземпляра; - запис
type, що називає тип у версії екземпляра, наприкладexample/compute/greeter:1.0.0; - запис
type, що називає тип без версії; - якщо запису немає взагалі, збирання зупиняється із зазначенням незіставленого екземпляра.
Manifest — це звичайний YAML, тож значення, яке в ньому повторюється, можна записати один раз з якорем і посилатися на нього через псевдонім.
Feature, що приносить власні ресурси
FeatureRecipe може рендерити ресурси поряд із ресурсами компонента, з власного чарта, названого в source: і наповнюваного її valuesMapping, замість того щоб змінювати те, що рендерить сутність Recipe компонента. core/public-ingress зі стандартної бібліотеки реалізовано так у Kubernetes через helm/public-ingress, який рендерить Ingress для компонента, до якого його приєднано.
Шлях запиту, який обслуговує компонент, є частиною того, чим є застосунок, тому Feature отримує його у values; ім’я хоста — це назва компонента в середовищі, тому воно належить до infra, поряд із параметрами, що описують кластер. У прикладі Агент, маршрутизатор і дві висхідні моделі розробник приєднує її в сутності Aggregate і записує шлях:
features: published: type: core/public-ingress values: path: /а сутність Release задає тому самому приєднанню його хост і підтверджує, що в цільовому кластері працює ingress-контролер, без чого збирання зупиняється; з файлу release.yaml без коментарів:
published: infra: host: assistant.example.internal control_plane_present: trueFeatureRecipe називає ресурси, які рендерить, за .context.rendered_name — іменем компонента-хоста, яке повідомляє його провайдер, — тож Ingress вказує на Service, який рендерить власна сутність Recipe компонента. Поле host, записане у values сутності Aggregate, або path в infra сутності Release відхиляється із зазначенням поля: кожна опора закрита, і поле належить іншій. Шлях, що відрізняється між середовищами, — це параметр, який оголошує сутність Aggregate і заповнює кожна сутність Release.