设置 EventListener

本文档将帮助您完成什么

本文档将帮助您配置和部署 EventListener,以接收来自外部系统(例如 GitHub、GitLab 或自定义 Webhook)的 Webhook 事件,并自动触发您的 Tekton pipelines。您将了解:

  • 如何创建和配置 EventListener 资源
  • 如何向外部系统公开 EventListener(使用 Ingress、LoadBalancer 或 NodePort)
  • 如何配置权限和安全设置
  • 如何根据您的环境选择合适的部署策略

前提条件:您应掌握 Tekton Pipelines 和 Kubernetes 概念的基本知识。如果您刚接触 EventListener 概念,建议先阅读 深入了解 EventListener 文档。

TIP

如需深入了解 EventListener 的概念、架构和原理,请参阅 深入了解 EventListener 文档。

概述

EventListener 是 Tekton Triggers 中的核心资源,负责接收和处理外部事件(例如 Webhook)。当外部系统触发事件时,EventListener 会根据配置的触发器创建 Kubernetes 资源(例如 PipelineRun)。

主要功能

EventListener 具有以下主要功能:

  • 事件监听:提供 HTTP 端点,用于接收来自外部系统的 Webhook 事件
  • 事件过滤:使用拦截器验证和过滤接收到的事件
  • 资源创建:根据触发器定义自动创建 Kubernetes 资源
  • 可扩展性:支持自定义拦截器和各种事件源
  • 安全性:内置多种安全机制,例如 Webhook 验证

配置说明

基本结构

apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: eventlistener
spec:
  serviceAccountName: triggers-default-sa
  resources:
    kubernetesResource:
      serviceType: NodePort  # Service type
      servicePort: 80       # Service port
      spec:
        template:
          spec:
            containers:
              - resources:    # Resource limits
                  requests:
                    memory: "64Mi"
                    cpu: "250m"
                  limits:
                    memory: "128Mi"
                    cpu: "500m"
  triggers:                  # Trigger configuration
    - name: trigger-1       # Trigger name
      interceptors:         # Interceptor configuration
        - ref:
            name: "cel"
          params:
            - name: "filter"
              value: "header.match('X-GitHub-Event', 'pull_request')"
      bindings:            # Trigger bindings
        - ref: pipeline-binding
      template:            # Trigger template
        ref: pipeline-template

主要字段说明

spec.resources.kubernetesResource

用于配置 EventListener 的 Kubernetes 资源:

  • serviceType:Service 类型(NodePort/ClusterIP/LoadBalancer)
  • servicePort:Service 端口
  • spec:Pod 模板配置

spec.triggers

定义一组触发器配置:

  • name:触发器名称
  • interceptors:拦截器配置列表
  • bindings:触发器绑定配置
  • template:触发器模板配置

安全配置

EventListener 支持多种安全配置:

  1. ServiceAccount:
    • 默认 ServiceAccount(triggers-default-sa):如果未指定 spec.serviceAccountName,EventListener 将自动使用命名空间中的 triggers-default-sa ServiceAccount。此 ServiceAccount 会自动获得 EventListener 在同一命名空间内处理触发器所需的命名空间范围权限。这些权限会自动绑定到 ServiceAccount 所在的命名空间。
    • 自定义 ServiceAccount:当您需要处理跨多个命名空间的触发器时(例如配置了 namespaceSelector),必须指定具有集群范围权限的自定义 ServiceAccount。请确保指定的 ServiceAccount 已配置相应权限(请参阅下方的权限指南)。
  2. 拦截器验证:使用 CEL 拦截器验证事件。
  3. TLS:支持配置 HTTPS 证书。

权限指南

默认 ServiceAccount 与自定义 ServiceAccount

  • 默认 ServiceAccount(triggers-default-sa):未指定 spec.serviceAccountName 时,EventListener 会自动使用命名空间中的 triggers-default-sa ServiceAccount。此 ServiceAccount 会自动获得 EventListener 在同一命名空间内处理触发器所需的命名空间范围权限。这些权限会自动绑定到 ServiceAccount 所在的命名空间,因此您无需手动配置 Role 或 RoleBinding。

  • 具有集群权限的自定义 ServiceAccount:当您将 namespaceSelector 配置为监听来自多个命名空间的触发器时(包括监听所有命名空间的 '*'),必须指定具有集群范围权限的自定义 ServiceAccount。triggers-default-sa ServiceAccount 仅具有命名空间范围权限,不具备访问跨命名空间资源所需的集群范围权限。

所需权限

要正确触发 pipeline 和 task,EventListener 使用的 ServiceAccount 需要具有以下权限:

权限资源描述
get, list, watchconfigmaps读取 ConfigMap
get, list, watchsecrets读取 Secret
get, list, watchserviceaccounts读取 ServiceAccount
create, get, list, watch, patch, updatedeployments管理 Deployment
create, get, list, watch, patch, updateservices管理 Service
create, get, list, watch, patch, updatepods管理 Pod
create, get, list, watch, patch, updateevents管理事件
createpipelineruns创建 PipelineRun
createtaskruns创建 TaskRun
get, list, watchclustertriggerbindings读取 ClusterTriggerBinding
get, list, watchtriggerbindings读取 TriggerBinding
get, list, watchclusterinterceptors读取 ClusterInterceptor
get, list, watchinterceptors读取 Interceptor
get, list, watchtriggers读取 Trigger
get, list, watchtriggertemplates读取 TriggerTemplate
get, list, watcheventlisteners读取 EventListener

可参考的 ClusterRole:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: eventlistener-role
rules:
- apiGroups: [""]
  resources: ["configmaps", "secrets", "serviceaccounts"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["apps"]
  resources: ["deployments"]
  verbs: ["create", "get", "list", "watch", "patch", "update"]
- apiGroups: [""]
  resources: ["services", "pods", "events"]
  verbs: ["create", "get", "list", "watch", "patch", "update"]
- apiGroups: ["tekton.dev"]
  resources: ["pipelineruns", "taskruns"]
  verbs: ["create"]
- apiGroups: ["triggers.tekton.dev"]
  resources:
    - "clustertriggerbindings"
    - "triggerbindings"
    - "clusterinterceptors"
    - "interceptors"
    - "triggers"
    - "triggertemplates"
    - "eventlisteners"
  verbs: ["get", "list", "watch"]

用户指南

EventListener 的部署需要根据环境的规模和实际网络情况进行规划,具体如下,您可以根据规划选择不同的配置方式:

EventListener 触发器配置场景

EventListener 支持三种不同的触发器配置场景,分别适用于不同的使用场景:

1. 命名空间级 EventListener

命名空间级 EventListener 通过在 EventListener spec 中显式配置 triggers 字段,绑定同一命名空间中的指定触发器。这是最简单的场景,适用于单命名空间部署。

使用场景和建议:

  • 使用场景:

    • 为单个项目或团队进行独立部署和管理
    • 需要明确的资源隔离和权限控制
    • 团队深入了解 EventListener 配置,并需要对每个触发器进行细粒度控制
    • 不同命名空间需要不同的 EventListener 配置或资源限制
    • 对性能和故障隔离有较高要求
  • 推荐使用场景:

    • 经验丰富的 DevOps 团队,或需要高度定制的场景
    • 不同项目需要不同的 EventListener 配置、资源配额或安全策略
    • 要求租户之间完全隔离的多租户环境
    • 不同命名空间需要不同的副本数量、资源限制或网络策略

配置示例:

spec:
  # serviceAccountName is optional, defaults to triggers-default-sa
  triggers:
    - name: trigger-1
      bindings:
        - ref: gitlab-push
          kind: ClusterTriggerBinding
      template:
        ref: pipeline-template
    - name: trigger-2
      bindings:
        - ref: github-pullrequest
          kind: ClusterTriggerBinding
      template:
        ref: pipeline-template

2. 项目级 EventListener

项目级 EventListener 使用 namespaceSelector 绑定多个指定命名空间中的触发器。此方式适合管理一组相关命名空间中的触发器(例如某个项目或团队)。

使用场景和建议:

  • 使用场景:

    • 多个相关项目或命名空间需要共享同一个 EventListener
    • 在项目组或部门级别统一处理事件
    • 需要在多个命名空间之间共享资源,但不涉及整个集群
    • 存在一定的性能隔离要求,但可以接受项目组内部共享资源
  • 推荐使用场景:

    • 需要在多个相关命名空间之间统一管理触发器的中型团队或项目组
    • 多个项目使用相似的配置和资源要求,需要降低运维成本
    • 需要集中管理一组相关项目的 Webhook 事件
    • 对 EventListener 有一定了解,并能够配置和管理跨命名空间权限的团队

配置示例:

spec:
  serviceAccountName: eventlistener  # Custom SA with cluster permissions
  namespaceSelector:
    matchNames:
      - project-a
      - project-b
      - project-c

3. 全局级 EventListener

全局级 EventListener 使用带通配符('*')的 namespaceSelector,绑定集群中所有命名空间的触发器。此方式适合在整个集群中集中处理事件。

使用场景和建议:

  • 使用场景:

    • 集群范围内统一处理和管理事件
    • 用户对性能隔离没有严格要求,并且可以接受资源共享
    • 一次配置即可让所有用户开箱即用,无需在每个命名空间中单独配置
    • 用户不需要深入了解 EventListener,由平台统一管理
    • 事件量相对可控的中小型集群
  • 推荐使用场景:

    • 由平台管理员统一配置和管理的平台场景
    • 集群规模较小,且所有用户都需要使用相同的 EventListener 配置
    • 简化用户操作流程,降低学习成本和配置复杂度
    • 用于统一监控和故障排查的集中式运维管理
    • 注意:在大规模集群或高并发场景中,应考虑性能影响和故障隔离

配置示例:

spec:
  serviceAccountName: eventlistener  # Custom SA with cluster permissions
  namespaceSelector:
    matchNames:
      - '*'  # Wildcard for all namespaces

对比表:

场景命名空间范围ServiceAccount配置复杂度使用场景
命名空间级单个命名空间triggers-default-sa(自动)简单单个项目/团队
项目级多个指定命名空间自定义 SA(集群权限)中等多个相关项目
全局级所有命名空间(*)自定义 SA(集群权限)复杂集群范围管理

规模

在不同的规划场景下,可以使用不同的配置来满足不同的需求。

规模触发器数量资源设置
小规模2(触发器)* 100(命名空间)* 10(流水线)= 2,000 个触发器/集群中等,超过两个副本
中等规模2(触发器)* 1,000(命名空间)* 10(流水线)= 20,000 个触发器/集群中等,超过两个副本,按命名空间部署不同的 EventListener

网络配置

可以根据环境的优先级和可用网络资源选择不同的网络配置。

网络配置协议描述
官方域名和证书https通过 ClusterIP + Ingress 配置 TLS 证书
自定义域名和证书https使用自签名证书进行 TLS。注意:工具端配置存在风险,并非所有工具/平台都支持跳过或忽略 TLS 验证。
NodePorthttp通过 NodePort + 集群节点 IP 设置可访问地址
TIP

选择合适的网络配置

  • 生产环境:使用带 HTTPS 的 LoadBalancer 或 Ingress,以确保安全性和可靠性
  • 开发/测试环境:NodePort 已足够,且更易于设置
  • 自动管理:如果希望系统自动创建 Ingress 资源,请使用通过 TektonConfig 配置的自动暴露功能
  • 手动控制:如果更倾向于手动控制 Ingress 资源,请按照以下示例手动创建

NodePort 配置示例

NodePort 适用于开发、测试,或未配置 LoadBalancer 或 Ingress controller 的环境。此方法会在集群中的每个节点上,通过高位端口(30000-32767)暴露 EventListener 服务。

前提条件

  • Kubernetes 集群中的节点可从外部系统访问
  • 至少知道一个节点的外部 IP 地址
  • 防火墙规则应允许访问 NodePort 范围(30000-32767)

配置示例

使用 NodePort Service 创建 EventListener

将以下 YAML 保存为 eventlistener-nodeport.yaml:

apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: el-demo
  namespace: tekton-triggers-demo
spec:
  # serviceAccountName is optional, defaults to triggers-default-sa
  serviceAccountName: triggers-default-sa
  resources:
    kubernetesResource:
      serviceType: NodePort  # Use NodePort service type
      servicePort: 80        # Container port
  triggers:
    - name: hello-trigger
      bindings:
        - ref: hello-binding
      template:
        ref: hello-template
kubectl apply -f eventlistener-nodeport.yaml

获取 NodePort Webhook 地址

创建 EventListener 后,需要获取 NodePort 和节点 IP,以构造 webhook URL:

# 1. Get the NodePort assigned to the EventListener service
# Replace 'el-el-demo' with your actual service name (format: el-<eventlistener-name>)
# Replace 'tekton-triggers-demo' with your namespace
export NODEPORT=$(kubectl get svc el-el-demo -n tekton-triggers-demo -o jsonpath='{.spec.ports[0].nodePort}')
echo "NodePort: $NODEPORT"

# 2. Get a node's external IP address
# This gets the first node's external IP, you can also use internal IP if nodes are not directly accessible
export NODE_IP=$(kubectl get nodes -o jsonpath='{.items[0].status.addresses[?(@.type=="ExternalIP")].address}')

# If no ExternalIP, try InternalIP
if [ -z "$NODE_IP" ]; then
  export NODE_IP=$(kubectl get nodes -o jsonpath='{.items[0].status.addresses[?(@.type=="InternalIP")].address}')
fi
echo "Node IP: $NODE_IP"

# 3. Construct the webhook URL
export WEBHOOK_URL="http://${NODE_IP}:${NODEPORT}"
echo "Webhook URL: $WEBHOOK_URL"

替代方式:获取所有节点 IP 和 NodePort

# Get NodePort
NODEPORT=$(kubectl get svc el-el-demo -n tekton-triggers-demo -o jsonpath='{.spec.ports[0].nodePort}')

# Get all node external IPs
kubectl get nodes -o jsonpath='{range .items[*]}{.status.addresses[?(@.type=="ExternalIP")].address}{"\n"}{end}'

# Or get internal IPs if external IPs are not available
kubectl get nodes -o jsonpath='{range .items[*]}{.status.addresses[?(@.type=="InternalIP")].address}{"\n"}{end}'

webhook URL 格式为:http://<node-ip>:<nodeport>

测试 NodePort Webhook

# Test the webhook endpoint
curl -v -X POST -H 'Content-Type: application/json' \
  -d '{"message":"Hello from NodePort!"}' \
  $WEBHOOK_URL

验证 EventListener 状态

# Check EventListener is ready
kubectl get eventlistener el-demo -n tekton-triggers-demo

# Check the service
kubectl get svc el-el-demo -n tekton-triggers-demo

# View EventListener Pod logs
kubectl logs -n tekton-triggers-demo -l app=el-el-demo

NodePort 的重要注意事项

  • 安全性:NodePort 使用 HTTP(而非 HTTPS),因此不适合安全性要求较高的生产环境
  • 可访问性:节点 IP 必须能够被发送 webhook 的外部系统访问
  • 高可用性:如果某个节点宕机,需要使用其他节点的 IP。建议在多个节点前配置负载均衡器
  • 端口范围:NodePort 使用 30000-32767 范围内的端口。请确保防火墙允许访问这些端口
  • 多个节点:可以使用任意节点的 IP 地址,因为所有节点上都可以访问 NodePort

适用 NodePort 的场景

  • 开发和测试:用于本地开发或测试的快速设置
  • 内部网络:webhook 发送方与集群节点位于同一内部网络中
  • 无可用 LoadBalancer:集群没有 LoadBalancer Service 或 Ingress controller
  • 成本考虑:希望避免 LoadBalancer 成本
WARNING

生产环境建议:对于生产环境,强烈建议使用带 HTTPS 的 LoadBalancer 或 Ingress,而不是 NodePort,因为 NodePort 缺少加密和适当的基于域名的路由。

从 NodePort 迁移到 Ingress

如果您最初使用 NodePort 进行测试,现在希望迁移到使用 Ingress 的生产环境:

  1. 更新 EventListener Service 类型:在 EventListener spec 中,将 serviceType 从 NodePort 更改为 ClusterIP
  2. 配置自动暴露(推荐):使用自动暴露功能自动创建 Ingress 资源
  3. 或手动创建 Ingress:按照以下示例手动创建 Ingress 资源

以下示例展示了如何配置带 Ingress 的 EventListener,以用于生产环境。

小规模 + HTTPS + ALB Ingress 配置示例

前提条件

在配置带 Ingress 的 EventListener 之前,请确保满足以下前提条件:

  1. LoadBalancer/Gateway 配置:

    • 集群中应已部署并配置 LoadBalancer 或 Gateway(例如 ALB)
    • LoadBalancer 应可从发送 webhook 的外部系统访问
    • 有关配置 Load Balancer 的更多信息,请参阅 配置 Load Balancer。
  2. 域名和证书设置:

    • 域名已正确配置,并指向 LoadBalancer
    • TLS 证书已就绪(手动创建或通过 cert-manager 创建)
    • DNS 记录已正确配置
  3. Ingress Controller:

    • Ingress controller(本示例中为 ALB)已正确部署和配置
    • Ingress controller 已准备好处理 Ingress 资源
    • 有关创建 Ingress 的更多信息,请参阅 创建 Ingress。
INFO

注意:如果使用自动暴露功能(通过 TektonConfig 配置),通常无需手动创建 Ingress 资源。系统会根据您的导出规则自动创建这些资源。本示例展示了在更倾向于手动控制或未使用自动暴露功能时,如何手动创建 Ingress。

配置示例

创建命名空间(可选)

确保存在一个命名空间,以便管理 EventListener 和其他权限;这里以 tekton-webhooks 为例。

kubectl create namespace tekton-webhooks

创建 ClusterRole 和 ServiceAccount 并设置权限

  • 默认 ServiceAccount(triggers-default-sa):未指定 spec.serviceAccountName 时,EventListener 会自动使用命名空间中的 triggers-default-sa ServiceAccount。此 ServiceAccount 会自动获得 EventListener 在同一命名空间中处理触发器所需的命名空间范围权限。权限会自动绑定到 ServiceAccount 所在的命名空间,因此无需手动配置 Role 或 RoleBinding。

  • 具有集群权限的自定义 ServiceAccount:当配置 namespaceSelector 以监听多个命名空间中的触发器(包括用于所有命名空间的 '*')时,必须指定具有集群范围权限的自定义 ServiceAccount。triggers-default-sa ServiceAccount 仅具有命名空间范围权限,不具备访问跨命名空间资源所需的集群范围权限。

WARNING

namespaceSelector 必需条件:仅当使用 namespaceSelector 监听多个命名空间中的触发器时,才需要执行以下步骤。如果 EventListener 仅处理同一命名空间中的触发器,则可以跳过这些步骤,使用默认的 triggers-default-sa ServiceAccount,该 ServiceAccount 将自动获得所需权限。

以下 YAML 用于 eventlistener-role.yaml。

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: eventlistener-role
rules:
- apiGroups: [""]
  resources: ["configmaps", "secrets", "serviceaccounts"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["apps"]
  resources: ["deployments"]
  verbs: ["create", "get", "list", "watch", "patch", "update"]
- apiGroups: [""]
  resources: ["services", "pods", "events"]
  verbs: ["create", "get", "list", "watch", "patch", "update"]
- apiGroups: ["tekton.dev"]
  resources: ["pipelineruns", "taskruns"]
  verbs: ["create"]
- apiGroups: ["triggers.tekton.dev"]
  resources:
    - "clustertriggerbindings"
    - "triggerbindings"
    - "clusterinterceptors"
    - "interceptors"
    - "triggers"
    - "triggertemplates"
    - "eventlisteners"
  verbs: ["get", "list", "watch"]
kubectl apply -f eventlistener-role.yaml

使用上述 ClusterRole 和 ServiceAccount 创建绑定。

kubectl -n tekton-webhooks create serviceaccount eventlistener
kubectl create clusterrolebinding tekton-webhooks:eventlistener:eventlistener-role --clusterrole=eventlistener-role --serviceaccount=tekton-webhooks:eventlistener

创建 EventListener

将以下 YAML 保存为 eventlistener.yaml。

INFO

ServiceAccount 选择:

  • 如果只需要处理同一命名空间中的触发器,可以省略 spec.serviceAccountName,以使用默认的 triggers-default-sa ServiceAccount,该 ServiceAccount 将自动获得所需的命名空间范围权限。
  • 由于本示例使用带有 '*' 的 namespaceSelector 来监听所有命名空间中的触发器,因此需要具有集群范围权限的自定义 ServiceAccount。因此,这里指定了 serviceAccountName: "eventlistener"。
apiVersion: triggers.tekton.dev/v1beta1
kind: EventListener
metadata:
  name: eventlistener
  namespace: tekton-webhooks
  labels:
    el.tekton.dev/namespaces: all
    el.tekton.dev/size: small
spec:
  serviceAccountName: "eventlistener" # Required: Custom SA with cluster permissions needed for namespaceSelector
  # Listen to triggers from all namespaces
  namespaceSelector:
    matchNames:
    - '*'
  # Declare Kubernetes resource, default is Deployment
  resources:
    kubernetesResource:
      serviceType: ClusterIP # ClusterIP service type
      servicePort: 80  # Service port (container port)
      replicas: 2 # Replicas
      spec: # Deployment spec
        template:
          metadata:
            labels:
              el.tekton.dev/namespaces: all
              el.tekton.dev/size: small
          spec: {}
kubectl apply -f eventlistener.yaml

创建 Ingress 和 TLS Secret

Info

需要将 <host> 设置为相应的域名和证书信息。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: eventlistener-ingress
  annotations:
    ### Note ALB does not require setting ingressClassName
    ## kubernetes.io/ingress.class: "nginx" ## Follow changes to the ingress class, and remember to add corresponding ingress annotations.
    ### The following configuration should be customized based on requirements:
    alb.ingress.kubernetes.io/listen-ports: '[{"HTTPS":443}, {"HTTP":80}]'
    alb.ingress.kubernetes.io/scheme: internet-facing
    alb.ingress.kubernetes.io/target-type: ip
spec:
  ### Note ALB does not require setting ingressClassName
  ## ingressClassName: alb ## Change according to the required ingress class
  tls:
  - hosts:
    - <host> # Domain name setting. Ensure DNS resolution is configured (or add to /etc/hosts for testing)
    secretName: <tls secret> # Name of the secret containing TLS certificate
  rules:
  - host: <host> # Domain name setting. Ensure DNS resolution is configured (or add to /etc/hosts for testing)
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: el-eventlistener 
            port:
              number: 80
WARNING

DNS 配置:使用域名配置 host 字段时,请确保:

  • DNS 记录已正确配置,可将域名解析到 Ingress controller 的 IP 地址
  • 对于本地测试,可以将域名添加到 /etc/hosts(Linux/Mac)或 C:\Windows\System32\drivers\etc\hosts(Windows)
  • 发送 webhook 的系统(GitHub、GitLab 等)必须能够解析该域名

验证域名可访问性

配置域名和 Ingress 后,请确保 webhook 域名可访问:

# Test domain accessibility (replace <host> with your actual domain)
curl -kI https://<host>

# Or test the specific webhook endpoint
curl -kI https://<host>/triggers/<eventlistener-namespace>/<eventlistener-name>
WARNING

重要:请确保基于 LoadBalancer 的 webhook 域名可从外部系统(例如 GitHub、GitLab 或其他 webhook 发送方)访问。如果域名不可访问,webhook 将失败。请检查:

  • DNS 记录配置正确且已完成传播
  • LoadBalancer 配置正确,并具有外部 IP/域名
  • 防火墙规则允许访问 LoadBalancer
  • TLS 证书有效(如果使用 HTTPS)

验证 Webhook 配置

可以使用以下 curl 测试配置是否正常。

curl -k -X POST -H 'Content-Type: application/json' -d '{"hello": "world"}' https://<host>/triggers/<eventlistener-namespace>/<eventlistener-name>

## The following is the expected return format:
$> {
  "eventListener": "eventlistener",
  "namespace": "tekton-webhooks",
  "eventListenerUID": "8a7edab2-b426-453a-9f92-xxxxxx",
  "eventID": "aefd3b5b-2b19-4a14-b411-xxxxxxx"
}

最佳实践

  1. 资源限制:

    • 为 EventListener Pod 设置适当的资源请求和限制。
    • 根据实际负载调整副本数量。
  2. 安全性:

    • 使用 HTTPS 和 Webhook Secret。
    • 配置遵循最小权限原则的 ServiceAccount。
    • 使用拦截器验证所有传入事件。
  3. 可用性:

    • 使用 LoadBalancer 或 Ingress 暴露服务。
    • 配置适当的健康检查。
    • 实施高可用部署。
  4. 监控:

    • 监控 EventListener 日志。
    • 设置适当的告警机制。
    • 跟踪事件处理性能。

常见问题

  1. 事件未触发 Pipeline

    • 检查拦截器配置。
    • 验证 Webhook 配置。
    • 查看 EventListener 日志。
  2. 权限问题

    • 确认 ServiceAccount 权限。
    • 如果使用默认的 triggers-default-sa ServiceAccount,请确认它存在于命名空间中,并且已自动授予所需权限。
    • 如果使用自定义 ServiceAccount,请检查 Role 和 RoleBinding 配置。
    • 验证命名空间访问权限。
    • 如果使用 namespaceSelector 跨命名空间监听,请确保使用具有集群范围权限的自定义 ServiceAccount。triggers-default-sa ServiceAccount 仅具有命名空间范围的权限。
  3. 性能问题

    • 调整资源限制。
    • 优化拦截器配置。
    • 考虑水平扩展。

参考链接