Перейти к содержимому
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.