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

错误概览

错误相关章节汇总了编译器在出错时发出的内容。信号分为两类:致命中止,它会停止编译并产生非零退出码;以及非中止警告,它会标记编写或部署方面的问题,但不会阻止构建。该目录按信号类型而非流水线步骤组织,因此遇到错误消息的读者可以直接找到对应条目。

致命中止涵盖 schema 违规、schema 组合失败(各支柱的 JSON Schema 声明拒绝所编写的负载)、缺失引用错误(Recipe 的 implements: 指向不存在的 Component,或 Release 指向的 Manifest 缺少某个已声明 Component 类型的 Recipe),以及编译器在 schema 校验之外重新校验的少数跨字段不变量。致命中止还包括远程获取失败:已固定版本的目录实体或源制品无法从其注册表或远程源获取(缺失、未认证、不可达,或摘要与锁文件不匹配)。这类失败在 aggrega pull 期间以及 aggrega build 的锁文件校验期间出现,并标记为 FETCH_ERROR。非中止警告涵盖编写上的不良迹象(未使用的 values 键、表明存在幽灵基础设施的未使用 infra 调节项)以及目标无法遵从的字段(渲染某个节点的 provider 不会处理的 Workload 字段或 aggrega.ai/ 注解)。

分主题参考

  • 致命中止:会停止编译的错误目录,按触发检查的流水线步骤组织。每个条目都列出错误的触发条件、修复方法以及出问题的编写位置。
  • 警告:编译期间发出的非中止警告,以及在核心编译器之外执行策略类规则的外部 linter 领域检查。
  • 错误转换:类别前缀(DEVELOPER_ERROR、OPS_ERROR、CATALOG_ERROR、TRANSLATION_ERROR、FETCH_ERROR、POLICY_ERROR、TRUST_ERROR)以及单行和多行输出格式。
  • 错误哨兵——每个条件携带的三个标识符(程序用 errors.Is 匹配的 Go 哨兵、条件注册时所用的代码,以及诊断信息打印的短代码),以及用于解析每个短代码的表。
  • 兼容性 — 短代码在各版本之间所作的承诺:代码永远不会被重新编号,也永远不会分配给其他条件。