1.3.6. 触发器

使用触发器（Trigger）和 Pipelines 一起创建一个完整的 CI/CD 系统，其中 Kubernetes 资源定义整个 CI/CD 执行。触发器捕获外部事件，并处理它们以获取关键信息。将这个事件数据映射到一组预定义的参数会触发一系列任务，然后创建和部署 Kubernetes 资源并实例化管道。

例如，您可以使用 Red Hat OpenShift Pipelines 为应用程序定义 CI/CD 工作流。管道必须启动，才能在应用程序存储库中使任何新的更改生效。通过捕获和处理任何更改事件，并通过触发器部署新镜像的管道运行来自动触发这个过程。

触发器由以下主要资源组成，它们可一起组成可重复使用、分离和自力更生的 CI/CD 系统：

TriggerBinding 资源验证事件，从事件有效负载中提取字段，并将它们保存为参数。
TriggerTemplate 资源充当创建资源的方式标准。它指定了 TriggerBinding 资源中参数化数据的方式。触发器模板从触发器绑定接收输入，然后执行一系列操作来创建新管道资源，并启动新管道运行。
EventListener 资源提供一个端点或事件接收器（sink），用于使用 JSON 有效负载侦听传入的基于 HTTP 的事件。它从每个 TriggerBinding 资源提取事件参数，然后处理此数据以按照对应的 TriggerTemplate 资源指定的 Kubernetes 资源创建 Kubernetes 资源。EventListener 资源还使用事件 interceptors（拦截器） 在有效负载上执行轻量级事件处理或基本过滤，这可识别有效负载类型并进行自选修改。目前，管道触发器支持四种拦截器： Webhook Interceptors、GitHub Interceptors、GitLab Interceptors 和 Common Expression Language(CEL)Interceptors。
Trigger 资源连接 TriggerBinding 和 TriggerTemplate 资源，这个 Trigger 资源在 EventListener 规格中被引用。

以下示例显示了 TriggerBinding 资源的代码片段,它从接收的事件有效负载中提取 Git 存储库信息：

apiVersion: triggers.tekton.dev/v1alpha1 
kind: TriggerBinding 
metadata:
  name: vote-app 
spec:
  params: 
  - name: git-repo-url
    value: $(body.repository.url)
  - name: git-repo-name
    value: $(body.repository.name)
  - name: git-revision
    value: $(body.head_commit.id)

apiVersion: triggers.tekton.dev/v1alpha1


kind: TriggerBinding


metadata:
  name: vote-app


spec:
  params:


  - name: git-repo-url
    value: $(body.repository.url)
  - name: git-repo-name
    value: $(body.repository.name)
  - name: git-revision
    value: $(body.head_commit.id)

Copy to Clipboard

Toggle word wrap

1: TriggerBinding 资源的 API 版本。在本例中，v1alpha1。
2: 指定 Kubernetes 对象的类型。在本例中，TriggerBinding。
3: 用于标识 TriggerBinding 资源的唯一名称。
4: 从接收的事件有效负载中提取并传递给 TriggerTemplate 的参数列表。在本例中，Git 仓库 URL、名称和修订版本是从事件有效负载主体中提取的。

以下示例显示了 TriggerTemplate 资源的代码片段，它使用您刚创建的 TriggerBinding 资源提供的 Git 存储库信息创建一个管道运行：

apiVersion: triggers.tekton.dev/v1alpha1 
kind: TriggerTemplate 
metadata:
  name: vote-app 
spec:
  params: 
  - name: git-repo-url
    description: The git repository url
  - name: git-revision
    description: The git revision
    default: master
  - name: git-repo-name
    description: The name of the deployment to be created / patched

  resourcetemplates: 
  - apiVersion: tekton.dev/v1beta1
    kind: PipelineRun
    metadata:
      name: build-deploy-$(tt.params.git-repo-name)-$(uid)
    spec:
      serviceAccountName: pipeline
      pipelineRef:
        name: build-and-deploy
      params:
      - name: deployment-name
        value: $(tt.params.git-repo-name)
      - name: git-url
        value: $(tt.params.git-repo-url)
      - name: git-revision
        value: $(tt.params.git-revision)
      - name: IMAGE
        value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(tt.params.git-repo-name)
      workspaces:
      - name: shared-workspace
        volumeClaimTemplate:
         spec:
          accessModes:
           - ReadWriteOnce
          resources:
            requests:
              storage: 500Mi

apiVersion: triggers.tekton.dev/v1alpha1


kind: TriggerTemplate


metadata:
  name: vote-app


spec:
  params:


  - name: git-repo-url
    description: The git repository url
  - name: git-revision
    description: The git revision
    default: master
  - name: git-repo-name
    description: The name of the deployment to be created / patched

  resourcetemplates:


  - apiVersion: tekton.dev/v1beta1
    kind: PipelineRun
    metadata:
      name: build-deploy-$(tt.params.git-repo-name)-$(uid)
    spec:
      serviceAccountName: pipeline
      pipelineRef:
        name: build-and-deploy
      params:
      - name: deployment-name
        value: $(tt.params.git-repo-name)
      - name: git-url
        value: $(tt.params.git-repo-url)
      - name: git-revision
        value: $(tt.params.git-revision)
      - name: IMAGE
        value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(tt.params.git-repo-name)
      workspaces:
      - name: shared-workspace
        volumeClaimTemplate:
         spec:
          accessModes:
           - ReadWriteOnce
          resources:
            requests:
              storage: 500Mi

Copy to Clipboard

Toggle word wrap

1: TriggerTemplate 资源的 API 版本。在本例中，v1alpha1。
2: 指定 Kubernetes 对象的类型。在本例中，TriggerTemplate。
3: 用于标识 TriggerTemplate 资源的唯一名称。
4: TriggerBinding 或 EventListerner 资源提供的参数。
5: 指定使用 TriggerBinding 或 EventListener 资源接收的参数创建资源方法的模板列表。

以下示例显示了一个 Trigger 资源的代码片段，名为 vote-trigger，它连接 TriggerBinding 和 TriggerTemplate 资源。

apiVersion: triggers.tekton.dev/v1alpha1 
kind: Trigger 
metadata:
  name: vote-trigger 
spec:
  serviceAccountName: pipeline 
  bindings:
    - ref: vote-app 
  template: 
     name: vote-app

apiVersion: triggers.tekton.dev/v1alpha1


kind: Trigger


metadata:
  name: vote-trigger


spec:
  serviceAccountName: pipeline


  bindings:
    - ref: vote-app


  template:


     name: vote-app

Copy to Clipboard

Toggle word wrap

1: Trigger 资源的 API 版本。在本例中，v1alpha1。
2: 指定 Kubernetes 对象的类型。在本例中, Trigger。
3: 用于标识 Trigger 资源的唯一名称。
4: 要使用的服务帐户名称。
5: 连接到 TriggerTemplate 资源的 TriggerBinding 资源的名称。
6: 连接到 TriggerBinding 资源的 TriggerTemplate 资源的名称。

以下示例显示了一个 EventListener 资源，它引用名为 vote-trigger 的 Trigger 资源。

apiVersion: triggers.tekton.dev/v1alpha1 
kind: EventListener 
metadata:
  name: vote-app 
spec:
  serviceAccountName: pipeline 
  triggers:
    - triggerRef: vote-trigger

apiVersion: triggers.tekton.dev/v1alpha1


kind: EventListener


metadata:
  name: vote-app


spec:
  serviceAccountName: pipeline


  triggers:
    - triggerRef: vote-trigger

Copy to Clipboard

Toggle word wrap

1: EventListener 资源的 API 版本。在本例中，v1alpha1。
2: 指定 Kubernetes 对象的类型。在本例中，EventListener。
3: 用于标识 EventListener 资源的唯一名称。
4: 要使用的服务帐户名称。
5: EventListener 资源引用的 Trigger 资源的名称。

返回顶部

1.3.6. 触发器

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links