Перейти до вмісту
AggregaAggrega
Обрати мову: Українська
Цю сторінку перекладено машинним способом. Читати оригінал англійською.

Розширені шаблони

Ця сторінка пояснює одну ідею — сутності Manifest і FeatureRecipe як місця, що вирішують, що збирання записує поза власною сутністю Recipe компонента, — і не є робочим простором, який можна запустити. Перевизначення рецепта для окремого екземпляра показує частину, що стосується Manifest, у робочому просторі, який ви збираєте; запишіть його у власну теку командою:

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

Потім вона виводить команди, які слід виконати далі:

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega 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

Перемагає найконкретніший запис:

  1. запис name для імені екземпляра;
  2. запис type, що називає тип у версії екземпляра, наприклад example/compute/greeter:1.0.0;
  3. запис type, що називає тип без версії;
  4. якщо запису немає взагалі, збирання зупиняється із зазначенням незіставленого екземпляра.

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: true

FeatureRecipe називає ресурси, які рендерить, за .context.rendered_name — іменем компонента-хоста, яке повідомляє його провайдер, — тож Ingress вказує на Service, який рендерить власна сутність Recipe компонента. Поле host, записане у values сутності Aggregate, або path в infra сутності Release відхиляється із зазначенням поля: кожна опора закрита, і поле належить іншій. Шлях, що відрізняється між середовищами, — це параметр, який оголошує сутність Aggregate і заповнює кожна сутність Release.