如何在Tekton Trigger中指定工作区参数并通过cURL传递给流水线？

Tekton Trigger的核心是通过TriggerTemplate生成PipelineRun，要实现和CLI中-w参数一致的工作区配置，需要调整Trigger相关资源，分两种场景处理：

场景1：工作区配置固定（始终用同一个PVC） #

如果你的工作区一直使用pipelinerun-pvc这个PVC，直接把工作区配置写死在TriggerTemplate的PipelineRun模板里即可，无需在cURL请求中额外传参数。

1. 调整TriggerTemplate #

apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerTemplate
metadata:
  name: pipeline-template
spec:
  params:
    - name: repo-url
      description: 代码仓库地址
    - name: branch
      description: 分支名
  resourcetemplates:
    - apiVersion: tekton.dev/v1beta1
      kind: PipelineRun
      metadata:
        generateName: pipeline-run-
      spec:
        pipelineRef:
          name: pipeline
        params:
          - name: url
            value: $(tt.params.repo-url)
          - name: branch
            value: $(tt.params.branch)
        # 对应CLI的-w参数，直接写死工作区PVC配置
        workspaces:
          - name: pipeline-workspace
            persistentVolumeClaim:
              claimName: pipelinerun-pvc

2. 配置TriggerBinding映射请求参数 #

确保TriggerBinding能把cURL请求里的字段映射到模板参数：

apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerBinding
metadata:
  name: pipeline-binding
spec:
  params:
    - name: repo-url
      value: $(body.repository.repo-url)
    - name: branch
      value: $(body.ref)

3. 发起cURL请求 #

直接使用你原来的cURL命令即可：

curl -X POST http://localhost:8090 \
  -H 'Content-Type: application/json' \
  -d '{"ref":"main","repository":{"repo-url":"https://github.com/..."}}'

场景2：需要动态传递工作区PVC名称 #

如果不同场景要使用不同的PVC，可在TriggerTemplate中添加工作区参数，通过cURL请求动态传递。

1. 修改TriggerTemplate添加工作区参数 #

apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerTemplate
metadata:
  name: pipeline-template
spec:
  params:
    - name: repo-url
      description: 代码仓库地址
    - name: branch
      description: 分支名
    - name: workspace-pvc
      description: 工作区使用的PVC名称
      default: pipelinerun-pvc # 可选：设置默认值，避免请求不传时出错
  resourcetemplates:
    - apiVersion: tekton.dev/v1beta1
      kind: PipelineRun
      metadata:
        generateName: pipeline-run-
      spec:
        pipelineRef:
          name: pipeline
        params:
          - name: url
            value: $(tt.params.repo-url)
          - name: branch
            value: $(tt.params.branch)
        workspaces:
          - name: pipeline-workspace
            persistentVolumeClaim:
              claimName: $(tt.params.workspace-pvc) # 引用动态传入的PVC名称

2. 更新TriggerBinding映射工作区参数 #

apiVersion: triggers.tekton.dev/v1beta1
kind: TriggerBinding
metadata:
  name: pipeline-binding
spec:
  params:
    - name: repo-url
      value: $(body.repository.repo-url)
    - name: branch
      value: $(body.ref)
    - name: workspace-pvc
      value: $(body.workspace-pvc) # 从请求体中提取PVC名称

3. 发起带工作区参数的cURL请求 #

在请求体中添加workspace-pvc字段，传递目标PVC名称：

curl -X POST http://localhost:8090 \
  -H 'Content-Type: application/json' \
  -d '{"ref":"main","repository":{"repo-url":"https://github.com/..."}, "workspace-pvc":"pipelinerun-pvc"}'

关键说明 #

Tekton Trigger的工作流程是：cURL请求触发EventListener → EventListener通过TriggerBinding提取请求参数 → 用TriggerTemplate生成完整的PipelineRun。工作区的配置最终定义在PipelineRun中，因此不能直接在cURL请求里指定工作区结构，只能通过传递参数让模板生成对应配置。

内容的提问来源于stack exchange，提问作者Arthur Pro