高级模式
本页讲解一个概念: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
Manifest 的 type 层将某个组件类型的每个实例绑定到一个 Recipe。它的 name 层按实例在 Aggregate 中的名称,将单个实例绑定到另一个 Recipe;在那里被指名的实例采用它,而该类型的其他所有实例保留 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 提供输入的专属 chart,而不是改变组件的 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 指向组件自身的 Recipe 所渲染的 Service。在 Aggregate 的 values 中写入 host,或在 Release 的 infra 中写入 path,都会被拒绝并指出该字段:每个支柱都是封闭的,而该字段属于另一个支柱。因环境而异的路径是由 Aggregate 声明、由每个 Release 满足的参数。