2.4. 构建控制器

构建控制器监控 Build 资源中的任何更新，并执行以下任务：

验证 Build 资源中是否存在引用的 Strategy 对象。
验证 Build CR 中指定的参数是否存在于引用的构建策略中。它还验证参数名称与任何保留名称冲突。
验证容器 registry 输出 secret 是否存在于 Build 资源中。
验证 Build 资源中是否存在引用的 spec.source.git.url 端点 URL。

构建运行控制器监控 Build 或 TaskRun 资源中的任何更新，并执行以下任务：

搜索任何现有 TaskRun 资源并更新其父 BuildRun 资源状态。
检索指定的服务帐户，并将它与 Build 资源中的输出 secret 一起设置。
如果 TaskRun 资源不存在，控制器会生成新的 Tekton TaskRun 资源，并设置对 TaskRun 资源的引用。
对于 TaskRun 资源中的任何后续更新，控制器会更新父 BuildRun 资源。

2.4.1. 构建验证

为了避免因为不正确的或缺少依赖项或配置设置而触发 BuildRun 资源，构建控制器会提前验证它们。如果所有验证都成功，您可以查看名为 Succeeded 的 status.reason 字段。但是，如果有任何验证失败，您必须检查 status.reason 和 status.message 字段以了解根本原因。

表 2.1. 通过构建控制器验证构建
status.reason field	描述
`BuildStrategyNotFound`	命名空间级别上引用的策略不存在。
`ClusterBuildStrategyNotFound`	集群级别上引用的策略不存在。
`SetOwnerReferenceFailed`	在 `Build` 和 `BuildRun` 资源之间设置所有者引用会失败。当您在构建中将 `spec.retention.atBuildDeletion` 字段设置为 `true` 时，会触发此状态。
`SpecSourceSecretRefNotFound`	用于向 Git 进行身份验证的 secret 不存在。
`SpecOutputSecretRefNotFound`	用于向容器 registry 进行身份验证的 secret 不存在。
`SpecBuilderSecretRefNotFound`	用于向容器 registry 进行身份验证的 secret 不存在。
`MultipleSecretRefNotFound`	缺少用于身份验证的多个 secret。
`RestrictedParametersInUse`	一个或多个定义的 `params` 与任何保留参数共存。
`UndefinedParameter`	这些参数没有在引用的策略中定义。您必须在策略的 `spec.parameters` 规格中定义这些参数。
`RemoteRepositoryUnreachable`	未找到定义的 `spec.source.git.url` 规格。此验证只用于 HTTP 和 HTTPS 协议。
`BuildNameInvalid`	`metadata.name` 字段中的构建名称无效。您必须将有效的标签值用于构建名称。
`SpecEnvNameCanNotBeBlank`	表示用户提供的环境变量的名称为空。
`SpecEnvValueCanNotBeBlank`	表示用户提供的环境变量的值为空。

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

© 2024 Red Hat, Inc.