建立监听路径
将 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
。 - 排除路径:``