Git リポジトリを Workers に接続すると、既定ではリポジトリ内のどのファイルの変更でもビルドが起動します。include / exclude するパスを設定すると、特定のパスでは Workers がビルドをスキップするようにできます。モノレポ構成で、起動するビルド数を抑えたい場合に特に有効です。
include / exclude するパスは、次の手順で設定します。
- Overview で、Workers プロジェクトを選びます。
- Settings > Build > Build watch paths を開きます。既定では、プロジェクトの include パスはすべて（
[*]）、exclude パスは空（[]）です。
設定フィールドは、次の 2 通りで入力できます。
- 静的なファイルパス: include / exclude したいファイルの正確な名前を入力します（例:
docs/README.md）。 - ワイルドカード構文: ワイルドカードで複数のパスやディレクトリに一致させます。ルールの先頭または末尾に指定できます。
push イベント内の各パスに対して、ビルドウォッチパスは次の順で評価されます。
- まず exclude 条件に合うパスを無視します
- 残ったパスを include 条件と照合します
- 一致するパスがあればビルドを起動します。なければビルドをスキップします
次の場合、Workers はパス照合をスキップし、既定どおりプロジェクトをビルドします。
- push イベントのファイル変更数が 0 件のとき（空の push でビルドを起動する場合）
- push イベントのファイル変更数が 3000 件以上、またはコミット数が 20 件以上のとき
project-a/ と packages/ など、特定ディレクトリ内のすべての変更でビルドを起動したい場合
- Include paths:
project-a/*, packages/* - Exclude paths: ``
すべての変更でビルドを起動しつつ、docs/ ディレクトリなど特定ディレクトリの変更は除外したい場合
- Include paths:
* - Exclude paths:
docs/*
特定のファイル、または .md で終わるファイルなど特定のファイル種別だけでビルドを起動したい場合
- Include paths:
*.md - Exclude paths: ``