通过 TektonConfig 配置增强功能
本指南介绍如何通过 TektonConfig 使用 spec.pipeline.options.configMaps 管理增强功能配置。
对于使用自签名或私有 CA 的 Git provider,请将 Enhancement 和 PAC controller 的 CA 信任配置与 provider 端 webhook 验证设置分开配置。有关完整的证书挂载示例,请参阅配置自定义证书。
命名空间说明:在本指南中,
<tekton-pipelines>用作Tekton命名空间的占位符。请将其替换为实际的命名空间名称。默认安装使用tekton-pipelines命名空间。
目录
前提条件步骤1. 使用spec.pipeline.options.configMaps 更新 TektonConfig2. 参数参考和默认值3. 验证 ConfigMap 更新4. 重启 controller 以应用启动时加载的设置常见问题我更新了 TektonConfig,但生效的配置没有变化。应该检查什么?前提条件
- 已安装 Tekton Operator。
TektonConfig资源存在(通常命名为config)。- 您可以在集群中编辑
TektonConfig。
步骤
1. 使用 spec.pipeline.options.configMaps 更新 TektonConfig
选项结构遵循调整子组件的可选配置项中所述的相同模式。
使用如下 TektonConfig patch:
2. 参数参考和默认值
PAC webhook 注册从 pipelines-as-code-info.data.controller-url 读取公开 webhook URL。请通过 PAC 组件选项配置该值;参阅获取 PAC Webhook URL。
要使用 webhook 自动注册,请将每个 PAC Repository spec.git_provider.type 设置为 github 或 gitlab。不支持的类型所对应的 Repository 将被跳过,原因会记录为 Repository Event 和状态注释。
如果 Git provider 无法验证自签名 PAC webhook 证书,请仅在非生产环境中设置 webhook-target-tls-verify: false。此设置无法解决 Enhancement controller 中的 x509 或 certificate signed by unknown authority 错误;请挂载 Git provider CA,并按照配置自定义证书中的说明设置 SSL_CERT_FILE/GIT_SSL_CAINFO。
将 pac-webhook-registration.enabled 设置为 false 不仅会暂停后续注册,还会删除之前由 enhancement controller 创建或更新的 Git provider webhook。将其改回 true,以便 controller 再次协调符合条件的 PAC Repository 资源,并重新创建或更新其 webhook。
对于处于活动状态的 Repository 资源,必须先完成清理,controller 才会移除所管理的 webhook 注释和 finalizer。如果凭证缺失或 provider API 暂时无法访问,请修复凭证或 provider 访问问题,controller 会重试。删除 Repository 则有所不同:provider 清理采用尽力而为策略,因此在记录清理警告后即可移除 Kubernetes finalizer。
3. 验证 ConfigMap 更新
更新 TektonConfig 后,检查所管理的 ConfigMap 是否已完成协调:
Tekton Operator 会应用来自 TektonConfig 的配置。请勿直接更新所管理的 Deployment 或 ConfigMap,因为这些更改可能会在下一次协调时被覆盖。
4. 重启 controller 以应用启动时加载的设置
pac-webhook-registration.* 设置会在 ConfigMap 更新后热加载。template-render.* 设置会在 enhancement controller 启动时加载,因此在更改 template-render.details-url-template 或 template-render.time-zone 后,请重启 tektoncd-enhancement-controller:
常见问题
我更新了 TektonConfig,但生效的配置没有变化。应该检查什么?
请按以下顺序检查:
TektonConfig是否已成功更新。- 命名空间
<tekton-pipelines>中的tektoncd-enhancement-config是否包含预期的data.config。 - Tekton Operator 是否已协调最新的
TektonConfig。 - 如果更改了任何
template-render.*设置,请确认 ConfigMap 更新后已重启tektoncd-enhancement-controller。
对于自动 webhook 注册失败,请检查 Enhancement controller 日志:
x509 或 certificate signed by unknown authority 错误表示 controller 到 Git provider 的 API 连接存在问题。在 GitLab 或 GitHub 中 webhook 传送测试失败,则表示 provider 到 PAC 的连接存在问题,应结合 pac-webhook-registration.webhook-target-tls-verify 和 PAC webhook 证书进行调查。