跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

Aggrega 能力无关图(IR)schema

自动生成的参考文档。请勿手动编辑——请从发布的 JSON Schema 重新生成。

Schema id:https://aggrega.ai/schemas/ir-v1beta1.schema.json

由 Topology Builder 输出的、经过展平且完全解析的一维图。

顶层类型: object

属性

属性类型必需描述
apiVersionconst “aggrega.ai/v1beta1”是常量:"aggrega.ai/v1beta1"
kindconst “IR”是常量:"IR"
metadataIRMetadata是图的标识:构建该图所依据的 Aggregate。
specIRSpec是图本身:其节点、边以及按节点键控的负载。

不允许其他属性。

定义

Maintainer

属性类型必需描述
namestring是维护者的姓名。
emailstring否维护者的电子邮件地址。
urlstring否维护者的网址。

FieldProvenance

附件的 values 或 infra 载荷中某个叶子的来源。

属性类型必需描述
originstring是该叶子是显式编写的,还是由注解驱动的展开阶段提供的。
sidestring否声明该注解的编写位置;显式叶子时不存在。
annotation_keystring否提供此叶子的注解名称;显式叶子时不存在。
annotation_sourcestring否注解声明的源位置,格式为 :;显式叶子时不存在。
overridden_annotationFieldProvenance否被显式叶子取代了此叶子的注解贡献:当显式叶子覆盖了由注解提供的叶子时,即它所替换的被抑制来源。单数——始终只保留一个被抑制的贡献。

不允许其他属性。

AttachmentConnection

附件所属的连接,适用于写在组件所引出的连接上、而非组件自身附件块中的附件:即该连接所经由的 socket 以及它所在的别名。这一对值指定图中的一条边——其源是携带该附件的节点,且其 socket 和别名即为这两个值——因此使用方将该附件关联到这条边,并经由它关联到附件所呈现给的目标。

属性类型必需描述
socketstring是连接所经由的 socket:即附件所属边的 socket。
aliasstring是连接所在的别名:即附件所属边的别名。

不允许其他属性。

IRFeatureEntry

节点的一个已解析附件,承载于 feature_values_mapping 中。所有附件类别都共用这一结构——运维类 Feature、凭据类 Feature、身份类 Feature——因此没有哪个类别得到比其他类别信息损失更多的投影。凭据附件的 values 承载什么由作者决定:按引用的凭据承载指向密钥存储的指针,按值的凭据承载凭据材料本身,编译器原样承载所写的任一种形式,不解析其中任何一种。

属性类型必需描述
typestring是此附件所请求的 Catalog Feature 的 URI。
resolved_versionstring是编译期间解析出的确切语义化版本。
labelsmap of string否所附 Feature 的目录标签,按其目录实体声明的顺序原样承载——从不过滤、规范化或去除前缀,因此使用方读到的正是目录作者所写的内容。编译器不读取其中任何一项。当该 Feature 未声明标签,或其类型未解析到任何目录实体时不存在。
catalog_annotationsmap of string否所附 Feature 的目录注解——即此附件所指定的 Feature 实体的 metadata.annotations——按该实体声明的顺序原样承载,从不过滤、规范化或去除前缀,因此使用方读到的正是目录作者所写的内容,包括作者自有命名空间中的键。编译器不读取其中任何一项。它不同于 annotation_key 和 annotation_source,后两者指定并定位导致此附件产生的注解:那两个字段报告附件是如何产生的,而本字段报告它所指定实体的元数据;写在 features: 块中的附件承载这些注解,但不携带那两个字段。当该 Feature 未声明注解,或其类型未解析到任何目录实体时不存在。
bindingstring否指定此附件所填充的附件槽位;若未填充任何已声明槽位,则为 “free”。槽位在两处之一声明,由附件的编写位置决定是哪一处:节点自身附件块中的附件填充宿主 Component 在其 featuresSchema 中声明的槽位,写在连接上的附件则填充该连接的 socket 在宿主 Component 上该 socket 的 featuresSchema 中声明的槽位。两种情况都按名称配对——当 Feature 以槽位的名称附加(在组件的块上或在连接上)时,附件即填充该槽位——因此该值是已声明槽位集合中的一个确切键,绝不是从附件的键中读出的内容。socket 的槽位集合是封闭的,因为以其 socket 未声明的名称写在连接上的附件会使构建中止,所以携带连接的附件永远不会报告 free。之所以承载槽位名称而非单纯的布尔值,是因为填充了哪个槽位是答案中更有用的那一半。当无法解析宿主 Component 的已声明槽位集合时为空,这与 “free” 不同:free 是一个肯定的结论,即没有任何已声明槽位使用此名称。
valuesobject否附件的运维配置载荷。对于凭据,为作者所声明的任一形式——指向密钥存储的指针,或凭据材料本身。
infraobject否此附件的单实例物理规格。
injectobject否与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。
originstring(枚举)否区分写在 features: 块中的附件(explicit)与注解驱动展开阶段生成的合成附件(annotation),或当附件的 value/infra 叶子混合了两者时为 mixed(此时逐叶子的细节位于 provenance 映射中)。允许的值:"explicit"、"annotation"、"mixed"
annotation_keystring否触发合成附件的注解名称。当 origin 为 explicit 时不存在。
annotation_sourcestring否注解声明的源位置,格式为 :。当 origin 为 explicit 时不存在。
values_provenancemap of FieldProvenance否values 载荷的逐叶子来源,以点分叶子路径为键。
infra_provenancemap of FieldProvenance否infra 载荷的逐叶子来源,以点分叶子路径为键。
sensitive布尔值否当此附件处理作者声明为敏感的材料时为 true——即所附 Feature 在其 values、infra 或 provides 支柱中声明了敏感叶子,或者附件所填充的槽位将其承载的材料声明为敏感:宿主 Component 中同名的附件槽位,或者对于写在连接上的附件,为该连接的 socket 所声明的同名槽位。它根据合并后附件上的这些声明推导,绝不根据值的内容或名称推导。当两种声明均不存在时不设置。
sensitive_injectmap of map of string否inject 中所引用的 provides 键被所附 Feature 声明为敏感的那些投递键,采用 inject 自身的结构:先是机制,然后是投递键,以所引用的 provides 键为值。它是 inject 的子集。当附件未声明投递机制或未引用任何敏感 provides 键时不存在。
sensitive_payload_leavesstring[]否该附件的 values 与 infra 负载中所携带的、被所附加的 Feature 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示:values. 或 infra.。此处读取的负载是附件最终携带的负载,因此位于 Feature 的 schema 声明为默认值处的叶子,与作者编写的叶子一同被列出——被填充的默认值是负载携带的数据,仅从所编写的块读取的标记会让它未被列出。这是敏感性标记的逐叶单元,它回答了另外两者都无法回答的问题——sensitive 为整个附件给出一个答案,sensitive_inject 为每个 inject 投递键给出一个答案,两者都不列出单个叶子。当 Feature 的 schema 声明为敏感的某条路径覆盖某个叶子时,该叶子即出现在此:该声明指名该叶子,或指名包含它的对象,因此位于某声明所覆盖对象之下的叶子由该声明列出。匹配按点分路径逐段进行,不从路径本身的文本中读取任何内容,也不检查任何值,因此位于 db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。逐附件的答案绝不会分摊到各个叶子上,否则就会对保持可读的叶子作出错误的断言。键缺失表示该附件未列出其 Feature 声明为敏感的任何叶子。它并不断言负载不敏感,也不区分没有此类叶子可列出的附件与根本不报告这一维度的生产者——将缺失的键理解为可以明文显示或输出某个值的 guest,恰好理解反了。叶子按负载保存它们的顺序排列,values 支柱的叶子在 infra 支柱的叶子之前——与 values 和 infra 负载本身携带的顺序相同,这也使负载在相同输入的多次运行之间保持逐字节一致。当附件未携带其 Feature 声明为敏感的任何叶子时缺失。
connectionAttachmentConnection否该附件所属的连接:在节点某个连接上编写的每个附件中都存在,在节点自身附件块的每个附件中都缺失。在连接上编写的附件在其他各方面都是节点的附件之一——以其限定名称(连接的别名与槽位以点连接)为键,并从连接的 socket 所声明的槽位获取其绑定和敏感性——因此该字段用于区分两者,并将连接作为数据携带,而不是留待从键中读取。使用方通过 socket 和别名将其与图的边关联:以携带该附件的节点为源、socket 与别名与此相同的边,就是呈现该附件的连接,而该边的目标就是它所呈现给的对象。由 Feature 附件引出的连接上的附件从不携带此字段,因为此类连接不携带附件。
realizationstring否实现该附件的 FeatureRecipe,格式为 ::即 Manifest 绑定给它的那个——当 Manifest 的名称层映射了附件自身的名称时按该名称绑定,否则按其 Feature 类型绑定——也就是对相同文档的构建渲染它时所用的那个。对于在连接上编写的附件,名称层所依据的名称是其限定名称,即连接的别名与槽位以点连接。该值就是 aggrega inspect 作为附件实现打印的那对值;当目标在其渲染的内容上标记来源时,它也是该 FeatureRecipe 所渲染文档上的 aggrega.ai/recipe-uri 值,因此使用方无需在不同形式之间转换即可将附件与其渲染结果关联。它按名称和版本而非能力指名 FeatureRecipe。该字段记录 Manifest 绑定的是哪个 FeatureRecipe,在构建图时从 Manifest 和目录中读取:生成它无需获取任何内容,FeatureRecipe 仅在构建进行渲染时才被渲染。当 Manifest 未将附件绑定到目录中存在的任何 FeatureRecipe 时缺失。

不允许其他属性。

IRFeatureEntry.inject

与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。

属性类型必需描述
envmap of string否环境变量投递:键是使用方的本地变量名,值是目标的 provides 键。
filemap of string否文件挂载投递:键是使用方的本地文件路径,值是目标的 provides 键。
argmap of string否命令行参数投递:键是使用方的标志前缀,值是目标的 provides 键。

IRBoundaryFeature

投影到 IR 中的边界级 Feature 附件:Feature 类型 URI,加上边界作用域的 FeatureRecipe 进行渲染并据以解析其源的边界 infra。边界级附件不携带 values 负载。

属性类型必需描述
typestring是附加在此边界上的 Catalog Feature 的 URI。
infraobject否边界附件的物理规格;边界作用域的 FeatureRecipe 据以求值其模板和源的 infra。
sensitive_payload_leavesstring[]否该边界附件的 infra 负载中所携带的、被所附加的 Feature 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示。此处只出现 infra. 坐标,因为边界级附件不携带 values 负载。此处读取的负载是附件最终携带的负载,因此位于 Feature 的 schema 声明为默认值处的叶子,与边界编写的叶子一同被列出——被填充的默认值是负载携带的数据,仅从所编写的块读取的标记会让它未被列出。当 Feature 的 schema 声明为敏感的某条路径覆盖某个叶子时,该叶子即出现在此:该声明指名该叶子,或指名包含它的对象,因此位于某声明所覆盖对象之下的叶子由该声明列出。匹配按点分路径逐段进行,不从路径本身的文本中读取任何内容,也不检查任何值,因此位于 db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。键缺失表示该附件未列出其 Feature 声明为敏感的任何叶子,这包括所附加的 Feature 解析不到此读取方能够读取的 schema 的情况。它并不断言 infra 负载不敏感,也不区分没有此类叶子可列出的附件与根本不报告这一维度的生产者。将缺失的键理解为可以明文显示或输出某个值的使用方,恰好理解反了。叶子按负载保存它们的顺序排列,与 infra 负载本身携带的顺序相同,这也使图在相同输入的多次运行之间保持逐字节一致。当附件未携带其 Feature 声明为敏感的任何叶子时缺失。
realizationstring否实现该边界附件的 FeatureRecipe,格式为 ::即 Manifest 绑定给它的那个——当 Manifest 的名称层映射了附件自身的名称时按该名称绑定,否则按其 Feature 类型绑定——也就是对相同文档的构建渲染它时所用的那个。它与 feature_values_mapping 下附件条目的实现是同一字段,读取方式相同。当 Manifest 未将附件绑定到目录中存在的任何 FeatureRecipe 时缺失。

不允许其他属性。

CatalogMetadata

从 Catalog 实体中显式提取的企业元数据套件,向 Wasm linter 公开生命周期和所有权数据。

属性类型必需描述
maintainersMaintainer[]否目录实体列为其所有者的维护者。
licensestring否目录实体为其所描述的软件声明的 SPDX 许可证标识符。
repositorystring否目录实体指明的、存放其源文件的 Git 仓库的 URL。
homestring否目录实体的主页、wiki 或文档的 URL。
keywordsstring[]否目录实体声明的描述性关键词。

不允许其他属性。

IRNode

属性类型必需描述
descriptionstring否可选的、由开发者编写的文档,描述该组件实例在应用中的角色。从 Aggregate 透传,用于渲染和 lint 诊断。
labelsmap of string是该实体的鸭子类型标签和本体标签。
componentstring是底层 Component 的名称。
resolved_versionstring是编译期间解析出的该 Component 的确切语义化版本。
sync_waveinteger否从所在边界的 syncWave 字段继承的部署波次(默认为 0;允许负值)。在 K8s 和 Helm 上,波次决定部署顺序:它成为一个 argocd.argoproj.io/sync-wave 注解,而在 chart 已标记为 Helm hook 的资源上,它还会成为该 hook 的 helm.sh/hook-weight。在 compose 上,该值既被记录为服务标签,又通过服务之间的 depends_on 为其渲染到的文件中的服务排序。在 cloudformation 上,它为调度组装配到的栈的资源供应排序,每个波次中的资源都被声明为依赖于前一波次的资源:即资源创建的顺序,以及反过来资源删除的顺序,而绝不是就绪状态,因为栈模板无法表达资源就绪的概念。在 terraform 上,它为边界装配到的根配置中的 module 块排序,每个波次中的 module 都被声明为依赖于前一波次的 module:即引擎执行操作的顺序,而绝不是就绪状态,因为配置无法表达资源就绪的概念。该值还会随节点的构建来源信息一同传递。
boundary_pathstring否该节点所在的 Release 边界的路径:从最外层边界向内的各边界名称,以 / 连接(例如,对于放置在边界 data 内所声明的边界 inner 中的组件,路径为 ‘data/inner’)。边界名称不能包含 /,因此路径可以无歧义地拆分回各个边界。Release 路由到某个边界中的导入 Aggregate 的节点携带该边界的路径。使渲染插件能够生成感知边界的唯一标识符。
subsystem_pathstring否该节点的组件所声明于的 Aggregate 子系统的路径:从最外层子系统向内的各子系统名称,以 . 连接(例如,对于在嵌套于子系统 backend 内的子系统 storage 中声明的组件,路径为 ‘backend.storage’)。子系统名称不能包含 .,因此路径可以无歧义地拆分回各个子系统。声明顶层 components 的 Aggregate 中的组件携带合成的 default,并由 synthesized_subsystem 标记。该路径相对于声明该组件的 Aggregate:导入的 Aggregate 所贡献的节点携带其在该 Aggregate 内的路径,不含导入时使用的名称(例如,对于导入的 Aggregate 中子系统 tier 里的组件,路径为 ‘tier’),因此来自不同 Aggregates 的节点可以共享同一路径。节点的 ID(以导入名称开头)和 source_file 可以区分它们。
synthesized_subsystem布尔值否当该节点的子系统由编译器合成时为 true——即为声明顶层 components 而非具名 subsystems 的 Aggregate 创建的 default 子系统。属于派生的来源信息,从不由作者编写:它将合成的 default 与用户显式命名为 default 的子系统区分开来。与 synthesized_boundary 相互独立(节点可以在任一维度或两个维度上都是合成的)。对于每个作者编写的子系统,该字段缺省(false)。
synthesized_boundary布尔值否当该节点的边界由编译器合成时为 true——即为声明顶层 components 而非具名 boundaries 的 Release 创建的 default 边界。属于派生的来源信息,从不由作者编写:它将合成的 default 与用户显式命名为 default 的边界区分开来,并将该节点的产物平铺路由到 dist/,而不是 dist/boundaries/default/。对于每个作者编写的边界,该字段缺省(false)。
catalog_metadataCatalogMetadata否从 Catalog 实体中显式提取的企业元数据套件,向 Wasm linter 公开生命周期和所有权数据。
catalog_annotationsmap of string否由平台架构师在 Domain 2 中编写的不可变的、固有的组件特征。
release_annotationsmap of string否从 Release 中的边界层叠传递下来的物理拓扑字符串和运维实际情况。
aggregate_annotationsmap of string否从 Aggregate 中的子系统层叠传递下来的认知元数据、开发者意图和 FinOps 信息。
self_injectobject否从 Aggregate 携带而来的 Component 级自注入块;即该节点为自身声明的与内容无关的注入路由。在此 schema 层是不透明的;读取它的策略插件自行解析这些字节。
source_filestring否编写该节点的 Aggregate 文件相对于工作区的路径。根层级节点携带根 Aggregate 的路径;子 aggregate 节点携带导入的 Aggregate 的文件路径。该路径相对于工作区根目录(包含 .aggrega-config.yaml 的目录),因此在工作区位于不同绝对路径的机器上,图都保持逐字节一致。按文件过滤诊断信息的使用方在比较之前,以同一工作区根目录解析该字段。当构建图时没有工作区根目录时不存在。
usesobject否节点的 uses 块,与作者编写的完全一致:每个插槽名称映射到目标实例名称列表,或以别名为键的连接条目映射,顺序与作者声明的顺序相同。这是所写的块,与 edges 中解析后的连接是不同的事实:作者填写的插槽即使没有产生连接也会出现在这里,因此读者可以区分作者填写的插槽和能够到达目标的插槽。当节点未编写 uses 块时缺省。在此 schema 层是不透明的;读取它的策略插件自行解析其字节。
sensitive_payload_leavesstring[]否该节点的 values 和 infra 负载所携带的、其 Component 声明为敏感的叶子,每个都以该数据所占据的、带支柱前缀的点分路径表示:values. 或 infra.。它指明的是节点自身的数据——即 values_mapping 和 infra_mapping 为该节点携带的内容——与附件条目上的标记是不同的主体,后者指明的是附件依据其 Feature 的声明所携带的数据。二者无法相互推导:节点的 Component 与附件的 Feature 声明的是不同的 schema,而且不附加任何内容的节点仍然携带 values。此处读取的负载是这两个映射所携带的负载,因此位于 Component 的 schema 声明为默认值处的叶子,会与作者编写的叶子一同被列出——填充的默认值是图所携带的数据,仅从所写块读取的标记会使其未被列出。当 Component 的 schema 声明为敏感的某个路径覆盖某个叶子时,该叶子即会出现:该声明指明该叶子,或指明包含它的对象,因此声明所覆盖对象之下的叶子由该声明列出。匹配按点分路径逐段进行,不从路径自身的文本中读取任何内容,也不检查任何值,因此位于 db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。键缺省表示该节点没有列出其 Component 声明为敏感的叶子,这包括节点的 Component 解析不到此读取方可读的 schema 的情况。它并不断言节点的负载不敏感,也不区分没有此类叶子可列出的节点与根本不报告此维度的生产方。将缺省的键理解为允许以明文显示或输出某个值的使用方,恰恰理解反了。叶子按负载持有它们的顺序到达,values 支柱的在 infra 支柱的之前,这与这些负载本身携带的顺序相同,也正是它使图在相同输入的多次运行之间保持逐字节一致。当节点未携带其 Component 声明为敏感的叶子时缺省。

不允许其他属性。

IREdge

属性类型必需描述
sourcestring是消费方节点的 ID,即连接的起点。
targetstring是连接所到达节点的 ID。
socketstring否此边所属的 usesSchema 类别(例如 ‘databases’、‘tools’)。
aliasstring否开发者为此连接定义的别名(例如 ‘primary_db’)。
socket_declarationstring(枚举)是套接字的来源:当拥有该套接字的目录实体在 usesSchema 中列出它时(即消费方 Component,或对于由 Feature 编写的边而言为发起方 Feature),值为 declared;当 Aggregate 作者命名了目录未声明的套接字时,值为 ad-hoc。这是第三个维度,与边的编写来源无关:它说明套接字从何而来,而不是谁绘制了这条边,因此一条由 Release 编写、指向已声明套接字的边,与一条由 Aggregate 编写、指向临时套接字的边,在这两个维度上各自独立地不同。已声明的套接字带有其 usesSchema 条目,包括约束该边可到达哪些目标的选择器;临时套接字没有目录条目,因此也没有选择器,所以该边可承载的内容仅由目标声明的 provides 限定。该字段始终存在,因此消费方无需将缺失值解读为 declared,策略也可以要求每条边都是 declared。它不同于附件的绑定标记,后者针对另一主体回答同类问题。允许的值:"declared"、"ad-hoc"
origin_featurestring否如果此边由某个 Feature 自主声明(包括标记为 feature.aggrega.ai/kind: secret 的凭据 Features),则此字段标识该 Feature 的类型 URI。使 Wasm 插件能够隔离自身的拓扑。
origin_feature_instancestring否声明此边的 Feature 的单附件实例名称。按实例定位边界作用域 FeatureRecipe 的已解析 provides,用于区分同一边界上同一 Feature 类型的两个附件。
origin_release布尔值否当此边由某个 Release 将已声明但未绑定的套接字连接到现有组件而创建时为 true。它标记的是边的编写来源,而非配置:对于开发者声明、Release 仅为其提供 infra 的边,仍属于 Aggregate 来源(origin_release 未设置;其 Release infra 出现在该边的 infra 映射中)。设置了 origin_feature => Feature 来源;origin_release 为 true => Release 来源;两者皆无 => Aggregate 来源。
valuesobject否此边已解析的单连接开发者值(来自 Aggregate 边),在解析时按源套接字(消费方组件上的套接字,即该边的源)声明的 valueSchema 进行校验,并投射到消费方节点渲染上下文的 .context.uses..values 处。作者省略的键由该套接字声明的默认值填充;作者编写的值优先。
infraobject否此边已解析的单连接 infra,由 Release 边条目提供,在解析时按源套接字(消费方组件上的套接字,即该边的源)声明的 infraSchema 进行校验,并投射到 .context.uses..infra 处。作者省略的键由该套接字声明的默认值填充;作者编写的值优先。
injectobject否与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。
sensitive_payload_leavesstring[]否该边的 values 和 infra 所携带的、被它们所针对的 socket 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示:values. 或 infra.。所读取的声明是消费方组件(即该边的源)上、该边所接入的 socket 之下的逐连接契约:其 valueSchema 管辖 values,其 infraSchema 管辖 infra,这也正是两个负载据以校验的同一契约。目标的声明不起任何作用:目标发布的内容与消费方为该连接编写的配置是不同的数据。它与节点上的标记是同一个字段,读取方式也相同,但对象不同:节点的标记依据其 Component 的 schema 列出节点自身的数据,而此标记依据 socket 的契约列出连接的配置,因此两者都无法从对方恢复出来。此处读取的负载是该边所携带的负载,因此位于 socket 契约声明为默认值处的叶子,与作者编写的叶子一同被列出。当契约声明为敏感的某条路径覆盖某个叶子时,该叶子即出现在此:该声明指名该叶子,或指名包含它的对象。匹配按点分路径逐段进行,不从路径本身的文本中读取任何内容,也不检查任何值,因此位于 db 的声明覆盖 db.password,而不会触及名为 db_password 的同级叶子。从图中隐去已声明为敏感的值的界面,会在该边的 values 和 infra 中隐去这些叶子,也会在消费方节点针对同一连接的 uses 条目中隐去它们,因为该条目按作者编写的原样携带这些值。键缺失表示该边未列出其 socket 契约声明为敏感的任何叶子,这包括 socket 未声明此读取方能够读取的契约的情况。它并不断言该配置不敏感,将缺失的键理解为可以明文显示或输出某个值的使用方,恰好理解反了。叶子按负载保存它们的顺序排列,values 支柱的叶子在 infra 支柱的叶子之前,这使图在相同输入的多次运行之间保持逐字节一致。当边未携带其 socket 契约声明为敏感的任何叶子时缺失。

不允许其他属性。

IREdge.inject

与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。

属性类型必需描述
envmap of string否环境变量投递:键是使用方的本地变量名,值是目标的 provides 键。
filemap of string否文件挂载投递:键是使用方的本地文件路径,值是目标的 provides 键。
argmap of string否命令行参数投递:键是使用方的标志前缀,值是目标的 provides 键。

IRMetadata

图的标识:构建该图所依据的 Aggregate。

属性类型必需描述
aggregate_namestring是该 Aggregate 的 metadata.name。

不允许其他属性。

IRProvenance

用于诊断和审计的可追溯性元数据。

属性类型必需描述
schema_versionstring是该图所遵循的 IR schema 版本——aggrega.ai/v1beta1,与图的 apiVersion 所携带的值相同。
compiler_versionstring是强制性合规标记。通过版本标识构建此图的 aggrega 二进制文件。
aggregate_versionstring是编译期间所用根 Aggregate 意图的确切语义版本。
manifest_versionstring是编译期间所用 Manifest 锁文件的确切语义版本。
release_versionstring是编译期间所用 Release 路由文件的确切语义版本。

允许其他属性。

IRSpec

图本身:其节点、边以及按节点键控的负载。

属性类型必需描述
nodesmap of IRNode是图中所有节点的字典,以其绝对 ID 为键。纯拓扑。键:一个或多个字母、数字、下划线、点或连字符。模式:^[a-zA-Z0-9_.-]+$。
edgesIREdge[]是节点之间显式的逻辑网络路径和依赖关系。
values_mappingobject是不透明透传认知载荷的唯一可信来源,按节点 ID 映射。
infra_mappingobject是从 Release 注入的物理规格载荷,按节点 ID 映射。
feature_values_mappingmap of map of IRFeatureEntry是节点 ID 到其所附 Feature 配置的规范化映射。一个桶承载节点上的所有附件,无论其产出什么——运维 Features、凭据 Features、身份 Features——以作者为每个附件指定的实例名称为键。写在节点某个连接上的附件以其限定名称为键,即连接别名与槽位以点连接,并在其自身的 connection 字段中指明所属连接。键:一个或多个字母、数字、下划线、点或连字符。模式:^[a-zA-Z0-9_.-]+$。
boundary_featuresmap of map of IRBoundaryFeature否每个边界的 Feature 附件,先按边界路径、再按实例名称为键。仅当图中存在边界级 Feature 附件时才出现。键:一个或多个字母、数字、下划线、点、斜杠或连字符。模式:^[a-zA-Z0-9_./-]+$。
provenanceIRProvenance是用于诊断和审计的可追溯性元数据。

不允许其他属性。

IRGraph

属性类型必需描述
apiVersionconst “aggrega.ai/v1beta1”是常量:"aggrega.ai/v1beta1"
kindconst “IR”是常量:"IR"
metadataIRMetadata是图的标识:构建该图所依据的 Aggregate。
specIRSpec是图本身:其节点、边以及按节点键控的负载。

不允许其他属性。