Продвинутые шаблоны
Эта страница объясняет одну идею — сущности 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.