5.5. 过滤与管道运行匹配的事件的注解

您可以将管道运行与一组路径的更改匹配。只有在拉取请求或推送事件包含您列表的路径更改时，Pipelines as Code 才会启动管道运行。

* 通配符表示目录中的任何文件。** 通配符表示目录或目录中任何级别的子目录中的任何文件。

当拉取请求更改 pkg 目录、cli 目录或 cli 目录下的任何文件时，您可以使用以下示例匹配 pipeline-pkg-or-cli 管道运行。

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-pkg-or-cli
annotations:
  pipelinesascode.tekton.dev/on-path-changed: "[pkg/*, cli/**]"
# ...

如果拉取请求只对指定路径集合中的文件进行更改，您可以将管道运行配置为排除匹配。如果管道运行与事件匹配，但拉取请求只包含对您列出的路径中的文件的更改，Pipelines as Code 不会启动管道运行。

当拉取请求更改 docs /generated 目录或其子目录下的任何文件时，您可以使用以下示例匹配 pipeline-docs-not-generated pipeline 运行。

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-docs-not-generated
annotations:
  pipelinesascode.tekton.dev/on-path-changed: "[docs/**]"
  pipelinesascode.tekton.dev/on-path-changed-ignore: "[docs/generated/**]"
# ...

当拉取请求以 main 分支为目标时，您可以使用以下示例匹配 pipeline-main-not-docs pipeline 运行，除非更改只应用到 docs 目录或其子目录。

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-main-not-docs
annotations:
  pipelinesascode.tekton.dev/on-target-branch: "[main]"
  pipelinesascode.tekton.dev/on-event: "[pull_request]"
  pipelinesascode.tekton.dev/on-path-changed-ignore: "[docs/**]"
# ...

您可以将管道运行与一个或多个拉取请求标签匹配。Pipelines as Code 仅在拉取请求有这些标签时启动管道运行。当使用新提交更新拉取请求时，如果标签仍然存在，Pipelines as Code 会再次运行管道。

当 bug 标签或 defect 标签添加到拉取请求时，您可以使用以下示例匹配 pipeline-bug-or-defect 管道运行，以及使用这个标签的拉取请求使用新的提交更新时：

apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
  name: pipeline-bug-or-defect
annotations:
  pipelinesascode.tekton.dev/on-label: "[bug, defect]"
# ...