配置 EventListener 自动暴露规则
目录
本文档可帮助您完成的操作功能概览配置入口字段参考字段到 Ingress 资源的映射请求流程图配置示例示例 1:使用自定义前缀的通配符主机示例 2:共享主机名和前缀示例 3:特定环境的规则示例 4:使用默认前缀按团队范围发布示例 5:多个外部端点和调整后的前缀示例 6:配置 TLS/HTTPS选项 A:使用预创建 Secret 手动配置 TLS选项 B:使用 cert-manager 自动管理证书选项 C:组合使用 TLS 和注解Gateway API(HTTPRoute)模式Gateway API 模式下的 HTTPS配置工作流推荐设置验证和故障排除验证 ConfigMap 内容验证 Ingress 对象检查 EventListener 地址检查 Trigger 注解故障排除提示本文档可帮助您完成的操作
本文档将帮助您通过自动暴露功能配置 EventListener 的自动外部暴露。您将了解:
- 如何配置导出规则,通过 Ingress 或 Gateway API (HTTPRoute) 自动暴露 EventListener
- 如何设置将在 UI 中显示的 webhook URL
- 如何为不同的命名空间或环境配置不同的暴露策略
- 如何验证 EventListener 是否已正确暴露
使用时机:当您希望系统自动为 EventListener 创建 Ingress 资源,从而无需手动创建和管理 Ingress 资源时,可以使用此功能。这对于需要保持 webhook URL 模式一致的生产环境尤其有用。
前提条件:您应具有配置 TektonConfig 资源所需的集群管理员权限,并且应基本了解 Kubernetes Ingress 和网络概念。两个验证命令会将其输出通过管道传递给 jq CLI。
功能概览
自动暴露控制器(内部名称为 trigger-wrapper,运行于 tektoncd-enhancement-controller Deployment 中)会读取 Tekton 系统命名空间(默认:tekton-pipelines)中的 trigger-wrapper-config ConfigMap。该 ConfigMap 中定义的 export-rules 决定哪些 EventListener 应进行外部暴露(Service、Ingress 等),并将生成的端点填充到 EventListener/Trigger 状态中。
技术说明:内部组件名称为 trigger-wrapper,但您无需记住它。您只需通过 TektonConfig 配置导出规则,系统会自动完成其余工作。
配置入口
在 Alauda Tekton 中,建议通过 TektonConfig 自定义资源管理此配置。将规则定义嵌入 spec.pipeline.options.configMaps.trigger-wrapper-config.data.config 下,例如:
Operator 会将此 spec 同步到 Tekton 系统命名空间(默认:tekton-pipelines)中的 trigger-wrapper-config ConfigMap。更新后,自动暴露控制器会刷新其缓存,并根据新规则协调资源。
注意:ConfigMap 名称 trigger-wrapper-config 是内部技术名称。您应按照上文所示,通过 TektonConfig 管理配置,无需直接操作 ConfigMap。
字段参考
export-rules 中的每个条目代表一种发布策略。重要字段包括:
-
name – 规则名称,也用于生成 Service/Ingress 名称。 避免名称冲突:共享 Ingress 名称是将规则名称规范化为有效的 DNS-1123 子域名后得到的结果(转换为小写,将
[a-z0-9-]之外的字符替换为-,并将连续的-合并)。此规范化过程是有损的,因此仅在此类字符上存在差异的规则名称会解析为同一个 Ingress,并相互覆盖——例如,a_b、a.b和A-B最终都会变为a-b。 请为每条规则指定一个本身就是不同的有效 DNS-1123 子域名的名称(小写字母、数字和-);不要依赖_、.或字母大小写来区分两条规则。 -
ingressClass(可选)– 要使用的 Ingress 控制器,例如
nginx、traefik。 -
host(可选)– Ingress 匹配的主机名。留空表示接受所有主机。重要:配置域名时,请确保 DNS 解析已正确配置(或在本地测试时添加到
/etc/hosts)。发送 Webhook 的系统必须能够解析该域名。 -
externalHosts(可选)– 作用:定义将在 UI 中显示给用户并填充到 EventListener 的
status.addresses字段中的 Webhook URL。可以将其理解为:外部系统(如 GitHub、GitLab)向 EventListener 发送 Webhook 时使用的“公共地址”。
工作方式:
- 控制器将每个
externalHostsURL 与生成的路径组合:${externalHost}/<urlPathPrefix>/<eventlistener-namespace>/<eventlistener-name> - 例如:包含单个条目
https://webhooks.example.com的externalHosts列表,加上urlPathPrefix: /triggers→ 最终 URL:https://webhooks.example.com/triggers/my-namespace/my-listener - 这些 URL 会显示在 EventListener 的
status.addresses字段中,便于复制并粘贴到 GitHub/GitLab Webhook 配置中
常见场景:
如果填写错误会怎样?
- ✅ Ingress 仍会正常工作(此字段不会影响 Ingress 创建)
- ❌ 用户将在 UI 中看到错误的 Webhook URL
- ❌ 将 URL 从
status.addresses复制到 GitHub/GitLab 将失败 - 🔧 修复方法:更新 TektonConfig 中的
externalHosts值,控制器将刷新 EventListener 状态
与
host字段的主要区别:经验法则:
- 如果可以通过
https://webhooks.example.com:8443/triggers/ns/el访问 Webhook,则将https://webhooks.example.com:8443添加到externalHosts - 控制器会自动追加路径
重要说明:
- 始终包含协议(
http://或https://) - 如果 LoadBalancer 使用非标准端口,请包含自定义端口
- 不要在
urlPathPrefix中包含路径(例如/triggers)——控制器会自动将其追加到externalHosts的末尾 - 如果不确定,请将其留空,先检查实际可访问的 URL,然后再更新配置;留空时,此规则不会向
status.addresses添加地址(设置了externalHosts的其他匹配规则仍会添加其地址)
- 控制器将每个
-
urlPathPrefix(可选)– 路径前缀;默认为
/triggers。Ingress 中渲染的最终路径为${urlPathPrefix}/${eventlistener-namespace}/${eventlistener-name}。始终以/开头,并避免使用尾部斜杠。 -
namespaceSelector.matchNames(可选)– 此规则允许的命名空间。使用
"*"可匹配所有命名空间。 -
namespaceSelector.matchLabels(可选)– 命名空间标签;该规则适用于标签匹配的命名空间中的 EventListener。
-
labelSelector(可选)– 用于筛选 EventListener 的 Kubernetes LabelSelector。
-
tls(可选)– Ingress 的 TLS 配置。每个条目指定
hosts(主机名列表)和secretName(包含证书的 TLS Secret 名称)。 -
annotations(可选)– Ingress 的其他注解。适用于 cert-manager、nginx 特定设置等。仅应用您提供的注解;控制器不再注入任何控制器特定的注解(例如
nginx.ingress.kubernetes.io/rewrite-target)。生成的 Ingress 路径使用pathType: Exact,且不进行重写,因此不依赖 nginx。其后端是 ExternalName Service,因此 Ingress 控制器必须能够路由到 ExternalName Service。 -
type(可选)– 暴露资源:
Ingress(默认)或HTTPRoute(Gateway API)。为空时,为保持向后兼容,默认为Ingress。请参阅 Gateway API(HTTPRoute)模式。 -
gateway(可选)– 使用
type: HTTPRoute时必需。引用 HTTPRoute 所附加到的父 Gateway:name(必需)、namespace(默认为 Tekton 系统命名空间),以及可选的sectionName和port。
使用
matchNames按名称选择命名空间(所有命名空间使用"*"),或使用matchLabels按命名空间标签选择;包含matchLabels的规则适用于标签与其匹配的命名空间。
字段到 Ingress 资源的映射
下表展示了导出规则字段如何映射到生成的 Ingress 资源:
映射示例:
给定以下导出规则:
DNS 配置:在 host 字段中使用域名时,请确保 DNS 记录已配置为将该域名解析到 Ingress 控制器的 IP。对于本地测试,可以将条目添加到 /etc/hosts(Linux/Mac)或 C:\Windows\System32\drivers\etc\hosts(Windows)。
生成的 Ingress 将包含:
metadata.name:test-webhooksspec.ingressClassName:nginxspec.rules[0].host:webhooks.example.comspec.rules[0].http.paths[].path:/triggers/${namespace}/${eventlistener-name}(针对每个匹配的 EventListener)spec.tls[0].hosts:包含单个条目webhooks.example.com的列表spec.tls[0].secretName:webhooks-tls-secretmetadata.annotations:仅为cert-manager.io/cluster-issuer(控制器不会添加自己的注解)
如 选项 B 中所述,将 <cluster-issuer> 替换为集群中 cert-manager ClusterIssuer 的名称。
请求流程图
externalHosts会告知外部客户端应调用哪个 URL。Ingress 根据host和确切路径${urlPathPrefix}/${namespace}/${eventlistener}匹配请求,并将请求转发到 Tekton 系统命名空间中的 ExternalName Service,该 Service 会解析到 EventListener sink Service。由于 sink 接受任何路径,后端会接收到未经更改的完整路径(不会进行重写)。
配置示例
示例 1:使用自定义前缀的通配符主机
结果:Ingress 会暴露 /hooks/default/${namespace}/${eventlistener}。由于 host 为空,因此将接受任意主机名——这非常适合由外部网关分配公共域名的场景。
示例 2:共享主机名和前缀
结果:每个 EventListener 都会显示在 https://webhooks.example.com/triggers/${namespace}/${eventlistener};后端会看到相同的路径。
示例 3:特定环境的规则
结果:
- GitLab Webhook:
https://gitlab-staging.example.com/staging/gitlab/${namespace}/${eventlistener} - GitHub Webhook:
https://github-prod.example.com/prod/github/${namespace}/${eventlistener}
示例 4:使用默认前缀按团队范围发布
结果:仅暴露 team-a 中的 EventListener,地址为 /triggers/team-a/${eventlistener}。
示例 5:多个外部端点和调整后的前缀
结果:
- Ingress 在内部提供
webhook.internal.local/internal/hooks/${namespace}/${eventlistener}。 - 在外部可以发布
https://webhooks.example.com/hooks/internal/hooks/${namespace}/${eventlistener}和https://backup.example.com/api/hooks/internal/hooks/${namespace}/${eventlistener}。 - 后端 Service 始终接收
/internal/hooks/${namespace}/${eventlistener}。
示例 6:配置 TLS/HTTPS
选项 A:使用预创建 Secret 手动配置 TLS
-
创建包含证书的 TLS Secret:
-
使用 TLS 配置导出规则:
控制器会使用指定的 Secret 自动为 Ingress 配置 TLS。
选项 B:使用 cert-manager 自动管理证书
使用 cert-manager 注解配置导出规则,并添加一个 tls 条目,用于指定证书的 Secret:
控制器会将 tls 复制到 Ingress 的 spec.tls。然后,cert-manager 会为 tls 中的 secretName 创建 Certificate,并从注解中指定的 issuer 请求证书。如果没有 tls,生成的 Ingress 将没有 spec.tls,cert-manager 也不会创建 Certificate。
将 <cluster-issuer> 替换为集群中 cert-manager ClusterIssuer 的名称。该 issuer 必须能够在没有互联网访问的情况下工作,例如使用自己的证书颁发机构进行签名的 CA issuer。使用公共 ACME 服务器(例如 Let's Encrypt)的 ACME issuer 无法从隔离集群访问该服务器,因此证书永远不会签发。
选项 C:组合使用 TLS 和注解
可以将手动 TLS 配置与其他注解结合使用:
注意:仅当规则同时设置
tls时,cert-manager 才会执行操作:它会为其中列出的secretName创建 Certificate。如果没有tls,cert-manager 注解不会生成证书。
Gateway API(HTTPRoute)模式
除了 Ingress 之外,还可以通过设置 type: HTTPRoute,使导出规则通过
Gateway API 暴露 EventListener。
对于没有 Ingress controller(或没有可用的 ingressClass)但运行 Envoy Gateway 等 Gateway 实现的集群,建议使用此模式。
现有的 Ingress 行为不变,Gateway 模式也会继续填充
status.addresses,确保 UI 和 Git webhook 注册正常工作。
前提条件:
- 已安装 Gateway API CRD 和 Gateway 实现(例如 Envoy Gateway)。controller 仅在启动时检查 HTTPRoute
v1和 ReferenceGrantv1beta1。如果此时未提供这些资源,controller 将保持 Ingress-only 模式,并在type: HTTPRoute规则所选择的 EventListener 上记录警告事件GatewayAPIUnavailable;如果 CRD 是在 controller 启动后安装的,也会发生这种情况。安装 CRD 后,重启 controller,例如删除其 Pod:kubectl delete pod -n tekton-pipelines -l app=tektoncd-enhancement-controller。 - 已存在父级
Gateway。其 listenerallowedRoutes.namespaces必须允许 Tekton 系统命名空间(默认为tekton-pipelines),因为生成的 HTTPRoute 会在该命名空间中创建。controller 不会修改 Gateway;它只读取 HTTPRoute 的Accepted和ResolvedRefs条件。 - 在此模式下,必须设置
externalHosts——它是status.addresses的来源。
示例:
controller 创建的资源:
- 在系统命名空间中,每个匹配的 EventListener 对应一个
HTTPRoute,其中包含一个path.type: Exact匹配项(${urlPathPrefix}/${namespace}/${eventlistener})、一个指向你的 Gateway 的parentRefs条目,以及一个跨命名空间的backendRefs条目,该条目直接指向 EventListener sink Service(el-<name>,端口 8080)。不使用URLRewritefilter ——sink 接受完整路径。仅当 EventListener 未设置其他servicePort,也未设置TLS_CERT和TLS_KEY环境变量时,Service 才仅具有端口 8080;设置 TLS 变量后,listener 会提供 HTTPS。 - 在 EventListener 所在的命名空间中,每个 EventListener 对应一个
ReferenceGrant,通过to.name将范围限制为该单个 sink Service,使系统命名空间中的 HTTPRoute 可以跨命名空间边界引用它(最小权限)。
模式特定的字段行为:ingressClass、tls 和 annotations 仅适用于 Ingress 模式,在 type: HTTPRoute 时会被忽略。对于 Gateway
模式下的 HTTPS,请改为在 Gateway listener 上终止 TLS ——请参阅下方的
Gateway API 模式下的 HTTPS。
验证:
只有当 HTTPRoute 已被其 Gateway 标记为 Accepted 且已
ResolvedRefs 时,才会发布 status.addresses(以及 Trigger 注解端点)。如果没有显示地址,请检查
kubectl get httproute <name> -n tekton-pipelines -o yaml 中的
status.parents[].conditions ——Accepted: False 或 ResolvedRefs: False
条件通常表示 Gateway listener 不允许系统命名空间,或 sink Service 不可访问。
Gateway API 模式下的 HTTPS
在 Gateway API 中,TLS 在 Gateway listener 上终止,而不是在
HTTPRoute 上终止——trigger-wrapper 在此模式下不会管理证书(tls
字段仅适用于 Ingress 模式)。要通过 HTTPS 提供 EventListener,请将导出规则附加到具有 HTTPS listener 的 Gateway,其 tls.certificateRefs
指向你的证书 Secret,并通过 gateway.sectionName(或 gateway.port)将规则固定到该 listener。
1. 具有 HTTPS listener 的 Gateway(由平台 / 集群管理员管理):
证书 Secret(上面的 webhooks-tls,其中包含 tls.crt / tls.key)
和 Gateway 由集群/平台管理。allowedRoutes.namespaces.from
必须允许 Tekton 系统命名空间,因为生成的 HTTPRoute 会在该命名空间中创建。
2. 通过 gateway.sectionName 将导出规则固定到该 HTTPS listener:
注意:
- 将规则的
host设置为 listener 的hostname,使 HTTPRoute 的 hostname 与 TLS SNI 匹配,并在externalHosts中使用https://scheme,使发布的status.addresses声明使用 HTTPS。 gateway.sectionName将 HTTPRoute 固定到命名 listener;当 listener 通过端口区分时,改用gateway.port(或同时使用二者)。 同时省略二者时,Gateway 可以将路由附加到任何兼容的 listener。- trigger-wrapper 仅创建 HTTPRoute(及其
ReferenceGrant);它 不会创建或修改 Gateway、listener 或证书Secret。
配置工作流
- 按照配置入口中所示的格式编写变更,并将其保存为
tektonconfig.yaml。规则是一个config字符串,因此该文件会替换所有现有 规则:将TektonConfig当前包含的每条规则都复制到其中。 - 将该文件合并到现有的
TektonConfig中:kubectl patch tektonconfig config --type merge --patch-file tektonconfig.yaml。 不要对仅包含部分TektonConfig的文件使用kubectl apply -f:kubectl apply会将该文件存储在kubectl.kubernetes.io/last-applied-configurationannotation 中,而之后对另一个部分文件执行kubectl apply -f时,会删除前一个文件设置但后一个文件未包含的字段。如果后一个文件省略这些规则,Operator 会将它们重置为随附的空列表,并删除每个已公开 EventListener 的 Ingress 或 HTTPRoute。 - 等待 Operator 传播 ConfigMap;随后,自动公开 controller 会自动协调新资源。
推荐设置
启用时机。当 EventListener 原本都需要手动编写 Ingress,Git 或 registry webhook 才能访问它们时,应启用自动公开。TektonConfig 中的导出规则会应用于规则的
namespaceSelector 和 labelSelector 所选中的每个 listener,因此每个选中的 listener 都会采用其规则中的 host、path pattern 和 TLS 设置,并且 status.addresses 中的地址会遵循一种可预测的格式。
推荐值。仅通过 TektonConfig 管理规则(请参阅
配置入口)。从单个共享规则开始,设置一个独特且有效的 DNS-1123 name、一个 host、默认的
urlPathPrefix: /triggers、externalHosts 中的 https:// URL,并通过
tls 配置 TLS(hosts 和 secretName)。Secret 可以预先在
Tekton 系统命名空间中创建,也可以在同时设置 cert-manager 的 annotations 时,通过针对该
secretName 的 Certificate 使用 cert-manager 进行管理,同时使用无需互联网访问即可工作的 issuer,例如 CA issuer。在多个团队共享的集群中,应使用 opt-in label 选择命名空间:为其中 listener 可以公开的每个命名空间添加 label(例如
kubectl label namespace <namespace> expose-webhooks=true),并将
namespaceSelector.matchLabels 设置为该 label,如下面的示例所示,这样团队的 listener 只有在其命名空间带有该 label 后才会公开。
为命名空间添加 label 需要对 Namespace 对象具有权限,通常需要集群管理员权限。自动
公开 controller 不会响应命名空间 label 的变更:添加或删除 label 后,需要等到该命名空间中的 EventListener 下一次协调时才会生效。要立即应用变更,请修改这些 EventListener 中每个对象的 metadata,例如使用
kubectl annotate eventlistener <name> -n <namespace> <key>=<value> --overwrite,
或修改规则。仅在每个命名空间都属于同一团队的集群中,使用只有一个条目的 namespaceSelector.matchNames
'*';它会公开每个命名空间中的 listener。将 ingressClass 设置为集群 Ingress controller 的 IngressClass(kubectl get ingressclass 会列出这些 IngressClass);示例中将其设置为 <ingress-class>。仅当环境或 provider 需要使用不同 host 时,才使用 namespaceSelector 和 labelSelector 添加更多规则,如
配置示例中的示例 3 所示。在没有可用 Ingress controller 的集群中,使用 type: HTTPRoute 和 gateway,并在 Gateway listener 上终止 TLS,如
Gateway API(HTTPRoute)模式中所述。
前提条件。具有编辑 TektonConfig 的集群管理员权限。需要安装与 ingressClass 匹配的 Ingress controller;或者,在 HTTPRoute 模式下,需要安装 Gateway API CRD,并且这些 CRD 必须在自动公开 controller 启动之前安装,或在安装后重启 controller(请参阅 Gateway API(HTTPRoute)模式)。此外,在该模式下还需要 Gateway 实现,以及一个父 Gateway,其 listener 允许来自 Tekton 系统命名空间的路由(Tekton 系统命名空间的默认值为 tekton-pipelines)。为 host 创建一条 DNS 记录,使其能够从发送 webhook 的系统解析,并在 Tekton 系统命名空间中创建 tls 中命名的 TLS Secret(或者使用无需互联网访问即可工作的 cert-manager issuer,例如 CA issuer,并同时配置该 tls 条目)。公开功能仅负责路由请求;请按照
Webhook Secret 身份验证中的说明,在每个 listener 上对请求进行身份验证。
要确认规则是否生效,请使用 验证和故障排除中的检查方法。要撤销某条规则,请合并一个不包含该规则的文件,如 配置工作流中所述;故障排除提示中的删除规则部分列出了会被删除的内容,以及可能遗留的共享 Ingress。
验证和故障排除
验证 ConfigMap 内容
检查 ConfigMap 是否包含预期配置:
预期输出(正常):
检查内容:
- ConfigMap 存在,并包含
config键 export-rules数组与您的 TektonConfig 规范匹配- YAML 语法有效(没有解析错误)
验证 Ingress 对象
检查是否为匹配的公开规则创建了 Ingress 资源:
重要:系统命名空间中每条公开规则都会创建一个共享 Ingress。其名称为规则的 name,并且对于每个匹配的 EventListener(${urlPathPrefix}/${namespace}/${eventlistener}),都包含一个 pathType: Exact 路径。EventListener 自身的命名空间中不会创建按 EventListener 划分的 Ingress。在 Alauda Container Platform 上,如果 ALB 仅限于某些项目的命名空间,则只有在该 ALB 服务系统命名空间所属的项目时,它才会服务此 Ingress;Operator 会为该项目添加标签 cpaas.io/project=cpaas-system。否则,Ingress 不会获得 ADDRESS。
预期输出(正常):
检查内容:
- 对于至少匹配一个 EventListener 的每条公开规则,都存在一个共享 Ingress
HOSTS字段与公开规则中指定的host匹配(空值或*表示所有 host)- Ingress 已分配
ADDRESS(可能需要几分钟) - 检查
kubectl get ingress <rule-name> -n tekton-pipelines -o yaml,确认每个匹配的 EventListener 都有一个pathType: Exact路径 - 如果没有出现 Ingress,请验证命名空间是否与规则的
namespaceSelector匹配(对于按名称选择的规则为matchNames,对于按 label 选择的规则为matchLabels),并确认 EventListener label 与labelSelector匹配
检查 EventListener 地址
验证 EventListener 状态是否包含生成的 webhook 地址。将 <el-name> 替换为您的 EventListener 名称,并将 <namespace> 替换为其部署所在的命名空间:
预期输出(正常):
检查内容:
addresses数组包含与您的externalHosts配置匹配的 URL- URL 遵循以下模式:
<externalHost>/<urlPathPrefix>/<eventlistener-namespace>/<eventlistener-name> - 如果
addresses为空或缺失,可能的原因包括:- EventListener 不匹配任何公开规则
- 匹配的规则没有
externalHosts(地址仅根据externalHosts构建) - 匹配的规则使用
type: HTTPRoute,且其路由尚未同时被其 Gateway 标记为Accepted并标记为ResolvedRefs(只有在这两个条件均为True时才会发布地址) - 匹配的规则使用 Ingress 模式,但其 ExternalName Service 或共享 Ingress 无法创建或更新(controller 日志会显示
Failed to process export rule;host中的 IP 地址就是其中一个原因,请参阅故障排除提示中的使用 IP 地址而非域名) - 配置无法加载(controller 日志会显示
Failed to load config,请参阅故障排除提示中的label 选择器配置错误)。此时 controller 不会发布新地址,并保留之前发布的地址
检查 Trigger 注解
检查存储在 Trigger 注解中的公开元数据。将 <trigger-name> 替换为您的 Trigger 名称,并将 <namespace> 替换为其部署所在的命名空间:
预期输出(正常):对于 tekton-triggers-demo 命名空间中的 Trigger my-trigger,同一命名空间中的 EventListener my-eventlistener 通过 triggerRef 引用该 Trigger(直接匹配):
检查内容:
- 注解包含 EventListener 信息数组
- 每个条目都包含
name、namespace、endpoints和relevance字段 endpoints数组与 EventListener 的status.addresses匹配relevance.score表示 EventListener 与 Trigger 的匹配程度(数值越高越好)- 如果缺少注解,可能是 Trigger 没有找到任何匹配的 EventListener
故障排除提示
-
如果规则未生效:
- 验证命名空间是否列在
matchNames中(或使用"*"表示所有命名空间);对于按 label 选择的规则,验证命名空间 label 是否与matchLabels匹配 - 检查 EventListener label 是否满足
labelSelector要求 - 检查是否有规则包含无效的
labelSelector(请参阅下一项):一个无效选择器会阻止所有规则生效
- 验证命名空间是否列在
-
label 选择器配置错误:
- 无法解析的
labelSelector会使 controller 拒绝整个配置,而不仅仅是该规则。controller 会保留现有的 Ingress、HTTPRoute 和 EventListener 地址,在修复选择器之前不会应用任何规则变更 - controller 日志会显示带有错误
invalid config: export rule[<index>] (<rule-name>): invalid labelSelector: ...的Failed to load config。读取这些日志需要对tekton-pipelines中 Pod 日志的读取权限,通常需要集群管理员权限。使用-l时,kubectl logs只会打印最后 10 行,除非设置了--tail;要读取完整日志,请使用:kubectl logs -n tekton-pipelines -l app=tektoncd-enhancement-controller --tail=-1 | grep 'Failed to load config'
- 无法解析的
-
删除规则(或切换其
type):- 当配置变更协调 EventListener 时,删除该规则生成的资源(Ingress + ExternalName Service,或 HTTPRoute + ReferenceGrant)
- 如果删除规则或切换其
type时不存在 EventListener,该规则的共享 Ingress 会被保留。其后端 ExternalName Service 已被删除,因此对其路径的请求会返回503或500。请手动删除该 Ingress:它位于 Tekton 系统命名空间中(默认值为tekton-pipelines),名称以规则命名,并按照上文对name的说明进行规范化,例如kubectl delete ingress -n tekton-pipelines <export-rule-name>。在至少存在一个 EventListener 时删除规则可以避免此问题 - 在
Ingress和HTTPRoute之间切换规则时,会清理旧模式的资源并创建新模式的资源 - 将
export-rules设置为空数组会禁用所有外部公开 - 当没有规则匹配时,EventListener
status.addresses将被清除
-
使用 IP 地址而非域名:
-
问题:Kubernetes Ingress 资源不支持将 IP 地址作为
host值。如果使用 IP 地址配置host(例如host: 192.0.2.10),Ingress 将创建失败或无法正常工作。 -
解决方案 1:将
host留空,或将其设置为"*"以接受所有 host。无论 host header 是什么,Ingress 都会匹配请求: -
解决方案 2:配置一个解析到该 IP 地址的域名,然后在
host字段中使用该域名:-
设置 DNS 解析:添加一条 A 记录,将您的域名指向该 IP 地址(例如,
webhooks.example.com→192.0.2.10) -
使用域名配置公开规则:
-
-
注意:
externalHosts可以包含 IP 地址或 URL,因为它仅用于填充 EventListenerstatus.addresses,不会影响 Ingress 创建。但是,Ingress 本身必须在host字段中使用有效的 hostname(或留空)。
-
通过 TektonConfig 维护 ConfigMap,您可以灵活控制 Tekton EventListener 如何向外部系统公开。在更新期间,请关注 controller 日志,以确认协调已成功完成。