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

Aggrega 缓存槽元数据 schema

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

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

写入每个源制品缓存槽、与 blob.tgz 并列存放的 metadata.yaml 文件。它记录 {kind, url, version, digest, mediatype, pulled_at} 身份元组,使缓存检查和构建时完整性校验有单一的规范记录。其传输形态是封闭的(additionalProperties: false),六个字段均为必需。Schema 演进准则:新增可选字段属于 SemVer-MINOR(增量变更);删除字段或收紧约束属于 SemVer-MAJOR。

顶层类型: object

属性

属性类型必需描述
kindenum是生成此缓存槽的源类型。与 lockfile 中 source_artifacts[].kind 枚举一致;每个构建时使用方都读取匹配的 kind 来选择正确的加载器。允许的值:"helm-oci-chart"、"helm-https-chart"、"compose-https-fragment"、"git-repository"、"terraform-module-oci"
urlstring是编写时的 URL,即 Recipe 的 spec.source.url 中所写的身份 URL。对于 helm-https-chart,这是与编写时完全一致的仓库根地址(repo-root 形式)或直接的 .tgz 地址(direct 形式)。对于 git-repository,是可克隆的仓库 URL。对于 helm-oci-chart,是 registry 引用。对于 compose-https-fragment,是该片段的 HTTPS URL。repo-root 形式的 helm 源解析出的制品位置会作为来源信息单独记录在 resolved_url: 下。
resolved_urlstring否仅作来源信息:拉取时编写的 URL 所解析到的具体制品位置。对于 repo-root 形式的 helm 源,这是仓库索引将 chart+version 解析得到的直接 .tgz URL。仅为诊断而记录,不属于任何完整性契约。当解析出的位置与编写的 URL 相同时省略。
versionstring是解析器在拉取时固定的具体版本。对于 helm-* 类型,是 chart 版本。对于 git-repository,是编写的引用所解析到的 commit。记录为单个路径段,因为它用于构建此元数据所在的缓存槽,所以不包含 /、\ 和 ..。模式:^([^/\\.]|\.[^/\\.])*\.?$。
digeststring是缓存的 .tar.gz 归档的内容摘要,格式为 sha256:。构建时校验会计算 blob.tgz 的 SHA-256,与此字段以及 lockfile 条目的 digest 进行比较,任一不一致时中止构建并报告内容摘要不匹配。模式:^sha256:[a-f0-9]{64}$。
mediatypestring是registry 声明的规范媒体类型(对于没有 registry 元数据的类型,则为该类型的默认值)。记录用于诊断来源信息。
pulled_atstring是记录拉取时墙上时钟的 RFC 3339 时间戳。仅作诊断来源信息,不属于任何完整性契约。读取元数据时,pattern 会将该值限定为 RFC 3339 格式。模式:^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$。

不允许其他属性。