跳转到内容
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

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

最具体的条目优先:

  1. 对应实例名称的 name 条目;
  2. 以实例的版本指明该类型的 type 条目,例如 example/compute/greeter:1.0.0;
  3. 不带版本指明该类型的 type 条目;
  4. 若完全没有条目,构建将中止并指出未映射的实例。

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

FeatureRecipe 按照 .context.rendered_name(即宿主组件的提供者所报告的该组件名称)为其渲染的资源命名,因此 Ingress 指向组件自身的 Recipe 所渲染的 Service。在 Aggregate 的 values 中写入 host,或在 Release 的 infra 中写入 path,都会被拒绝并指出该字段:每个支柱都是封闭的,而该字段属于另一个支柱。因环境而异的路径是由 Aggregate 声明、由每个 Release 满足的参数。