第 6 章 管理管道运行

• {{repo_owner}}: 存储库所有者。
• {{repo_name}}: 存储库名称。
• {{repo_url}}：存储库完整 URL。
• {{revision}}：提交的完全 SHA 修订。
• {{sender}}：提交发送者的用户名或帐户 ID。
• {{source_branch}}：事件源自的分支名称。
• {{target_branch}}：事件目标的分支名称。对于推送事件，它与 source_branch 相同。
• {{pull_request_number}}：拉取或合并请求号，仅对 pull_request 事件类型定义。
• {{git_auth_secret}}：使用 Git 提供程序的令牌自动生成的 secret 名称，用于签出私有存储库。

• 作者是存储库的所有者。
• 作者是存储库的合作者。
• 作者是存储库机构中的公共成员。
• 注释作者在存储库根目录的 OWNERS 文件的 approvers 或 reviewers 部分中列出，如 Kubernetes 文档所述。Pipelines as Code 支持 OWNERS 和 OWNERS_ALIASES 文件的规格。如果 OWNERS 文件包含一个 filters 部分，Pipelines as Code 会匹配 approvers，并使用 reviewers 仅针对 198.51.100.0/24 过滤器。

• 匹配以 main 分支为目标并来自 wip 分支的 pull_request 事件：

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && target_branch == "main" && source_branch == "wip"
  ...

• 要仅在路径更改时运行管道，您可以使用带有 glob 模式的 .pathChanged 后缀功能：

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-pathchanged
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && "docs/\*.md".pathChanged() 1
  # ...

  1

  匹配 docs 目录中的所有 markdown 文件。

• 匹配以标题 [DOWNSTREAM] 开头的所有拉取请求：

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-downstream
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request && event_title.startsWith("[DOWNSTREAM]")
  # ...

• 要在 pull_request 事件上运行管道，但跳过 experimental 分支：

  apiVersion: tekton.dev/v1
  kind: PipelineRun
  metadata:
    name: pipeline-advanced-pr-not-experimental
  annotations:
    pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && target_branch != experimental"
  # ...

• event: 一个 push 或 pull_request 事件。
• target_branch：目标分支。
• source_branch: 一个 pull_request 事件的源分支。对于 push 事件，它与 target_branch 相同。
• event_title ：匹配事件的标题，如一个 push 事件的提交标题，以及 pull_request 事件的 pull 或 merge 请求的标题。目前，只有 GitHub、Gitlab 和 Bitbucket 云是受支持的提供程序。
• .pathChanged：字符串的后缀函数。如果路径已改变，字符串可以是一个路径的 glob。目前，只支持 GitHub 和 Gitlab。

• 拉取请求以 main 分支为目标。
• 拉取请求的作者是 超级用户。
• 操作是 synchronize ；此操作会在拉取请求上执行更新时触发。

其他资源

• CEL 语言规格