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行も、カンマでつないだ形でした。

直し方(ぼくの場合)

  1. Settings → Build → Build watch paths の鉛筆を押す
  2. Include paths の欄に、パスを1つ打って Enter を押す
  3. 残りのパスも、1つずつ打って Enter を押す
  4. 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