Cloudflare 中文文档
Pages
编辑这个页面
跳转官方原文档
Set theme to dark (⇧+D)

建立监听路径

将 git 仓库连接到 Pages 时,默认情况下,对仓库中任何文件的修改都会触发 Pages 的编译。你可以配置 Pages 包含或排除特定路径,以指定 Pages 是否应该跳过特定路径的构建。如果你使用的是 monorepo 项目结构,并希望限制启动的构建数量,这一点会特别有用。

​​ 配置路径

要配置包含和排除哪些路径,请转至 Pages 项目>设置>构建和部署>构建监视路径。Pages 默认会将项目的包含路径设置为全部([*]),将排除路径设置为无 ([])。

配置字段有两种填写方式:

  • 静态文件路径:输入你要包含或排除的文件的准确名称(例如,docs/README.md)。
  • 通配符语法:使用通配符匹配多个路径目录。你可以在规则的开头或结尾指定通配符。

对于推送事件中的每个路径,将按以下方式评估构建观察路径:

  • 首先忽略满足排除条件的路径
  • 根据包括的条件检查任何剩余路径
  • 如果找到匹配的路径,就会触发构建。否则跳过构建

如果出现以下情况,页面将绕过推送事件的路径匹配,默认为构建项目:

  • 推送事件不包含文件更改,以防用户推送一个空的推送事件来触发构建。
  • 推送事件包含 3000 多处文件更改或 20 多处提交

​​ 示例

​​ 示例 1

如果你想根据一组目录中的所有更改触发构建,例如 project-a/packages/ 文件夹中的所有更改

  • 包含路径:project-a/*, packages/*
  • 排除路径:``

​​ 示例 2

如果你想触发对任何更改的构建,但又想排除对特定目录的更改,如 docs/ 目录中的所有更改

  • 包含路径: *
  • 排除路径: docs/*

​​ 示例 3

如果要触发特定文件或特定文件类型的构建,例如所有以 .md 结尾的文件。

  • 包含路径:*.md
  • 排除路径:``