本页面由机器翻译。阅读英文原文。
词汇概览
一小组关键字在 Aggrega 的各个实体中反复出现。词汇章节不在每个实体页面上重复解释它们,而是按关键字族把讲解集中到一处。凡是接受这些关键字之一的实体,都遵循本组章节所规定的相同语义。
词汇分为四个族:拓扑三元组(provides、inject、uses),在节点之间连接显式的拓扑边,并承载编译器传递的注入契约;数据支柱(values、infra、parameters、locals),分离四种数据关注点——开发者意图、物理规格、按环境区分的调节项,以及 Recipe 的私有状态;继承与接口关键字(extends、implements),用于组合目录实体并声明一个 Recipe 实现哪个 Component;以及修饰符系统(appliesTo、appliesToAnyOf),通过标签选择器决定一个 Feature 附加到哪些节点。关于各支柱如何分离关注点的概念性说明,见 ../architecture/06-data-taxonomy-and-composition.md;拓扑解析机制见 ../architecture/07-dependency-resolution.md。
分主题参考
- 拓扑三元组:
provides、inject、uses——注入契约与显式拓扑边声明。涵盖紧凑与详细两种 inject 语法、模板读取的.context.inject/.context.uses管道结构,以及保护 Ops 免受空指针 panic 的双状态上下文。 - 数据支柱:
values、infra、parameters、locals——四种数据支柱及其归属。由开发者拥有的values和parameters、由 Ops 拥有的infra、Recipe 私有的locals,以及用于按环境变化的参数提升模式。 - 继承与接口:
extends、implements——通过extends实现的目录实体继承(Components 与 Features 共有的 YAML 外壳深度合并、扩展的 Component 从其基础整体继承的数据支柱,以及 Feature 的 schema 所经历的 JSON Schema 2020-12 组合),以及从 Recipe 到 Component 的声明implements(精确、版本范围、无版本三种形式),Manifest 的映射会依据它进行检查——implements从不选择 Recipe。 - 修饰符系统:
appliesTo与选择器——Feature 附加选择器、原生 Go 标签匹配引擎、字符串形式的选择器语法,以及以 OR 方式组合的appliesToAnyOf变体。 - 四个族之外:紧凑形式编写、跨文档引用、标签和注解、发布接口、社会契约、验证接口、输出组合、URI 语法以及版本解析。