Cloudflare Pages の Build watch paths にカンマでつないで貼ったら、保存のあと欄が空になった
Build watch paths の欄は、カンマでつないだ1行ではなく、パス(ファイルやフォルダの場所の書き方)を1つずつ打って Enter で区切る欄でした(2026年10月6日の画面では)。
時点: 2026年10月6日 18時台・Cloudflare Pages(Free のプラン)・GitHub とつないだプロジェクト2つ・Settings → Build → Build watch paths の画面。公式の説明は2026年10月7日に読みました(ページの更新日は2026年4月21日)。
症状
Cloudflare Pages の Free のプランは、build(サイトを組み立てて公開し直す処理)が1か月 500回までです。回数を減らすために、サイトに関係するファイルが変わった push(手元の変更を GitHub に送ること)だけを build する設定(Build watch paths)を、2つのプロジェクトに入れました。
ぼくがしたのは、Include paths の欄に、パスをカンマでつないだ1行を貼って、Save を押すことです。1つ目のプロジェクトは5つ(site/* ほか)、2つ目は4つ。貼った1行は、作業役の AI(Claude Code)が出した手順のとおりでした。
Save のあとの画面の写しでは、2つとも Build watch paths の欄が空でした。入れる前は「Include paths: *」と出ていた所です。エラーの文が出たかは、記録に残っていません。
原因
確かめたこと: この欄は、パスを1つずつ打って Enter で区切る欄でした。そう入れ直して Save すると、欄に5つと4つが出ました。
見立て: カンマでつないだ1行は、1つとして確定しないまま Save されて、何も入らなかったと見ていますが、確かめていません。見立ての根拠は、入れる前の画面で「*」が枠で囲まれた1つとして出ていたことです。欄が本当に空で保存されたのか、画面が値を出していなかっただけなのかも、確かめていません。
公式の説明(Build watch paths)の例では、Include paths が project-a/*, packages/* と、カンマでつないで書かれています。画面の欄にどう入れるか(1つずつ Enter で区切ること)は、書いてありませんでした。ぼくが貼った1行も、カンマでつないだ形でした。
直し方(ぼくの場合)
- Settings → Build → Build watch paths の鉛筆を押す
- Include paths の欄に、パスを1つ打って Enter を押す
- 残りのパスも、1つずつ打って Enter を押す
- Save を押す
2つのプロジェクトとも、この手順で入れ直しました。
確かめ方
この日の順番です(2026年10月6日・ぼくの作業の記録から)。
| 時刻 | 起きたこと |
|---|---|
| 18時19分 | 設定を入れる前の最後の push |
| 18時23分 | 作業役の AI が、カンマでつないだ1行を貼る手順を出した |
| 18時44分 | Save のあとの写しで、2つとも欄が空と分かった |
| 18時53分 | 入れ直したあとの写しで、欄に5つと4つが出ているのを見た |
| 18時56分 | 次の push。サイトのプロジェクトは build されず、もう1つは build された |
18時56分の push は、サイトのプロジェクトの5つのパスに当たらないファイルだけの push でした。GitHub の、その push に付く Cloudflare Pages の印で、上の表のとおりに分かれました。欄に5つが入っていれば、こう分かれます。ただ、欄が空のときに build がどうなるかは公式の説明に書いていないので、見送られたことだけでは、5つが効いたのか、欄が空だったのかは見分けられません。サイトのプロジェクトの5つは、入れ直したあとの写しで確かめました。そのあと、サイトのファイルを含む push では build され、本番のページが変わりました(たとえば2026年10月11日)。
上の表のとおり、欄が空だった間に push したのは0回でした。公式の説明では、push の中のファイルが Include paths のどれにも当たらないとき、build は見送られます。欄が空のままなら、どの push も build されなかったおそれがありました。空のまま push はしていないので、確かめてはいません。
出所
- Cloudflare Docs「Build watch paths」(2026年10月7日に読んだ・更新日 2026年4月21日)。画面の欄に1つずつ Enter で入れることは、書いていなかった
- Cloudflare Docs「Limits」(2026年10月7日に読んだ・更新日 2026年9月5日)。Free は1か月 500 build
- ぼくの作業の記録(2026年10月6日)
この工場の続きはXで実況しています → @hitoriaifactory