Astro + Cloudflare Workers でをする Claude Code ——launch-site——をました。終えてみると、5つのを踏んでいました。にいない、の、「それですか」という。でたにます。

---

1つめ: Workers Builds にトリガー API はない

最初、こうていました——Workers Builds のを REST API で、push 後にがする、と。

Cloudflare の API リファレンスをました。ませんでした。GitHub Actionsならあります。には「Connect to Git」があります。でも「をする」RESTはしません。

flowchart LR
    A["期待\nPOST /workers/builds/trigger"] -->|そんな API ない| B["404"]
    C["実際の仕組み"] --> D["Git push を検知"]
    D --> E["Cloudflare が自動でビルド"]
    C --> F["ダッシュボードで手動トリガー\n(UI のみ)"]

Workers Builds は「push で」というでていて、からををにいないようです。

回避策は **git push をとして**ことでした。は Astroをしてする。は Cloudflare が。それ以上のはました——というか、ませんでした。API がと時点でをたので、むしろになりました。

---

2つめ: headless Chromium は Cloudflare ダッシュボードに弾かれる

Workers Builds をには、まず Gitとのをでしなければなりません。に「をさせよう」と playwright-cli をしました。

dash.cloudflare.com にしたら、こうなりました。

Just a moment...
Performing security verification...

Cloudflareが、headless Chromium のをました。でのがを噴く——なかなかです。

headlessをて --headed でしても、がなければでます。

突破口は browser session transplant——使いからをです。をしてから --headed でしたら、をして済みのにしました。

のはこうです。既存のを storageState として、次回時に。

# ブラウザの cookie を storageState として書き出す
~/.config/bin/pw-import-session --browser arc \
  --domain dash.cloudflare.com --domain .cloudflare.com \
  --out "${XDG_STATE_HOME:-$HOME/.local/state}/playwright-cli/state/cloudflare.json" \
  --load-session cloudflare

// Playwright 起動時に storageState を読み込む
const context = await browser.newContext({
  storageState: `${process.env.XDG_STATE_HOME ?? `${process.env.HOME}/.local/state`}/playwright-cli/state/cloudflare.json`,
});

一度を、どのにもます。まわりは「で一度きちんと」と、あとがになります。

---

3つめ: bunx wrangler がファントムバージョンを引く

Wrangler は Cloudflare Workers の CLI です。は bunx wrangler deploy をいました。これがのをました。

$ bunx wrangler --version
 ⛅️ wrangler 4.14.0 ...

は 4.14.0。でも実際にいたのはの node_modules/.bin/wrangler ではなく、bunx がにした別でした。package.json に "wrangler": "^3.x" をして、bunx がから 4.x をきます。

bunx は npx の Bunで、package.json のにません。に済みのを優先するはずですが、によっては node_modules/.bin/wrangler すらします。

はで、**node_modules/.bin/wrangler を直接**か、bun run で package.json の scriptsにします。

# NG: ファントムバージョンを引く可能性がある
bunx wrangler deploy

# OK: package.json に固定したバージョンが確実に動く
./node_modules/.bin/wrangler deploy

あるいは wrangler を devDependencies にして bun install を必ず先に。bunx の「さ」にと、がます。で時にがいると、するまでがかかります。

---

4つめ: playwright-cli の三か所

Playwright でを始めたら、三か所でました。したなので一つずつます。

ひとつ: goto の戻りタイミング

page.goto(url) は load後に resolve します。SPA は load が来ても JS のがいません。の「Git に」が DOM に前に次のへ、がず。

// NG: ボタンが DOM に現れる前に進んでしまう
await page.goto('https://dash.cloudflare.com/...');
await page.click('[data-testid="connect-git"]');

// OK: 目標要素の出現を待つ
await page.goto('https://dash.cloudflare.com/...');
await page.waitForSelector('[data-testid="connect-git"]', { state: 'visible' });
await page.click('[data-testid="connect-git"]');

waitForSelector でのを。これだけです。goto のを「」とことがです。

ふたつ: SPA のナビゲーションタイムアウト

の途中、Cloudflare が GitHub OAuth にします。OAuth後に Cloudflareにまで、waitForNavigation がデフォルト 30でました。

timeout を 120までてしました。OAuth のはのがな場合もあるので、は「の」をにしました。はを持ってしたほうがです。

みっつ: window.confirm が自動キャンセルされる

GitHubの最後、「本当にしますか」が window.confirm で出ます。Playwright はでネイティブを自動 dismiss します——つまり「キャンセル」を。

// ダイアログを自動承認する
page.on('dialog', async (dialog) => {
  await dialog.accept();
});

これをないと、したつもりが永遠にされます。dialog イベントのハンドラは、がなでは——そうづけました。

---

5つめ: Git アカウントセレクターのサイレント失敗

GitHubで「どのでするか」をがあります。はでをしようとしました。

問題は、しただけではされないことです。

でを → 「次へ」 → 次のへ。ここまではます。しかし「次へ」の内部でのがおり、その前に進むとが null のまま後続の API がます。には何も。もありません。ただ null でます。

page.waitForResponse でネットワークのをことでしました。

// アカウント選択後、保存 API のレスポンスを待つ
const [response] = await Promise.all([
  page.waitForResponse((resp) =>
    resp.url().includes('/api/accounts') && resp.status() === 200
  ),
  page.selectOption('#account-selector', orgAccountId),
]);

に何もままがは、でのに一番がかかりました。「のに」を、まずを——これがでことです。

---

やってみて分かったこと

5つ、5つました。

をとき、「API がある」でしないほうがです。Workers Builds のように、に API がもあります。push = とと、はむしろになりました。

は、「」を。goto のはのではなく、はがなければ、はで。はにしてにます。

みてのは、と、どこがいるのかがで分かる——という一点でした。