できない.dev

Vercel が git push してもデプロイされない

Vercel が git push でデプロイされないなら、Project Settings → Git の連携と Production Branch を直す。
Skipped と出るなら Ignored Build Step を見直す。

公開: 更新:

要約

git push で Vercel デプロイが走らないのは、多くの場合 Git 連携の問題か Ignored Build Step の skip が原因である。
Project Settings → Git で連携と Production Branch を、Deployments タブで Skipped 表示を確認すれば、どの段階で止まっているかが分かる。

解決策

1. 連携と branch 設定を確認

Project → Settings → Git で以下を確認する(公式 Git Deployments(新しいタブで開く) 参照)。

  • Connected Repository が正しい
  • Production Branch が push 先のブランチ名と一致
  • Connected branches に Preview したいブランチが含まれる

2. Deployments タブで状態を見る

Deployments タブで Skipped が表示されていれば、Ignored Build Step による skip である。
ジョブ自体が現れないなら、webhook が届いていない。
後者は Vercel App の再連携で直ることが多い。

3. Ignored Build Step を見直す

# Ignored Build Step の例(変更があれば exit 1 でビルド継続)
git diff HEAD^ HEAD --quiet ./ && exit 0 || exit 1

exit 0 を返すとビルドを skip し、exit 1 を返すと続行する。
意図と逆になっていないか確認する。

4. monorepo の Root Directory を確認

monorepo の場合、対応 Project の Root Directory 配下に変更が無いとビルドされない。
Turborepo の affected 検出と組み合わせるとさらに堅い。

npx turbo-ignore @your/app

5. GitHub 側の App 権限を再確認

GitHub → Settings → Integrations → Vercel App → Configure → Repository access を開き、All repositories か、Selected repositories で対象リポジトリにチェックが入っているかを確認する。
詳細は公式の Vercel for GitHub(新しいタブで開く)に書かれている。

よくある原因

  1. Git 連携が切れている。
    GitHub Org の設定で、Vercel App のリポジトリアクセスが外れている。
  2. Production Branch が一致していない。
    main に push したのに、Settings は master のままになっている。
  3. Ignored Build Step で skip されている。
    git diff でビルド不要と判定して exit 0 を返し、サイレントに skip している。
  4. 変更が monorepo の Root Directory の外にある。
    apps/foo の Project に対して、apps/bar だけを変更した push をしている。
  5. Vercel App の権限が漏れている。
    GitHub 側で Selected repositories を使っていて、対象のリポジトリが含まれていない。