Dependabot が依存のセキュリティ更新の PR を 3 本出していた。vite と js-yaml と、もう 1 つ。どれも package-lock.json を書き換えるだけで、CI は緑。merge ボタンを 3 回押して、本番の main は直った。
ただ、このリポジトリは dev で開発し、dev → main の PR で本番に出す 2 ブランチ運用だ。3 本の行き先は main で、dev には何も起きていない。次に dev で作業する人は、直る前の lockfile の上でテストを回し、プレビューを見る。dev 側で別の依存を上げれば、次のリリースの PR で同じ package-lock.json がぶつかるかもしれない。
Dependabot の target-branch で dev に向けられるのは version updates だけで、公式のリファレンスは「security updates always use the default branch」と書いている。Renovate から Dependabot に寄せたときの経緯は前の記事に書いた。
セキュリティ更新でも hotfix でも、「main に何か入ったら、手で dev に merge しておく」を覚えておく運用は、覚えていた人が休んだ日に破れる。そこで main への push をきっかけに、main を dev へ自動で同期する GitHub Actions を足した。書いてみると、難しいのは同期することではなく、同期しないときの決め方だった。
先に決めたのは「何もしない」3 通り
bot が dev に直接 push する以上、気を利かせてほしくない。決めたのは次の表だ。同期するのは 3 行目だけで、残りの 3 行が何もしない場合にあたる。
| main を dev に merge した結果 | 同期の動き | 終わり方 |
|---|---|---|
| 衝突する | dev を動かさない。衝突したファイルのパスを出す | 失敗 |
| merge しても dev の中身が変わらない | push しない | 成功 |
| 中身が変わる | merge commit を 1 つ作り、force なしで dev に push | 成功 |
| push の直前に dev が先へ進んでいた | push が拒否され、dev はそのまま | 失敗(再実行で直る) |
衝突を自動で解かないのは、lockfile の衝突こそ解き方に判断が要るからだ。「main 側を採る」と決め打ちすれば、dev で上げた依存が黙って消える。bot には失敗だけさせて、人が手で merge する。そのぶん、失敗した run の通知が唯一の合図になるので、通知が自分に届く設定かは先に確かめておく。
force push をしないのも同じ理由だ。同期の commit は、取得した時点の dev を親にして作る。そのあいだに誰かが dev へ push していれば、Git が non-fast-forward で拒否してくれる。他人の commit を上書きする可能性を、仕組みの側で消せる。
「同期が要るか」を、履歴の前後で判定しない
表の 2 行目が、いちばん踏みやすい。
素直に考えると「main が dev より先に進んでいれば同期が要る」だ。git merge-base --is-ancestor origin/main origin/dev で、main が dev の祖先かどうかを見ればよさそうに見える。
ところが dev → main を merge commit で出していると、リリースのたびに main には「dev を merge した commit」が 1 つ増え、dev はその commit を持っていない。中身は dev とまったく同じなのに、祖先の判定は毎回「main が先に進んでいる」と答える。dev に未リリースの作業があれば fast-forward では済まず merge commit が要るので、うちの同期は常に merge commit を作る。この組み合わせだと、リリースのたびに中身の無い同期の commit が dev に積まれ、それが次のリリースで main に入り、また同期が走る。ほぼ毎日リリースするリポジトリなら、ほぼ毎日、何もしない commit が 1 つ増える。
なので、判定は履歴ではなく中身で行う。main を dev に merge した結果の tree(ファイル一式のスナップショット)が、dev のいまの tree と同じなら、何もしない。実際の履歴の、普通のリリース直後の状態で次の 3 行を流すと、1 行目は 1(祖先ではない)を返し、2 行目と 3 行目は同じ値になった。
git merge-base --is-ancestor origin/main origin/dev; echo $?
git merge-tree --write-tree origin/dev origin/main
git rev-parse 'origin/dev^{tree}'
この 2 つの tree を見比べる方法なら、「main が dev の祖先」の場合も「main にだけあるのはリリースの merge commit」の場合も、1 つの条件で扱える。手元のリポジトリでも、この 3 行で dev に main の中身が欠けていないかをいま確かめられる。
同期のスクリプトと workflow
git merge-tree --write-tree(Git 2.38 以降)は、作業ツリーも index も触らずに merge の結果の tree を作る。だから git merge --abort のような後始末が要らず、衝突は終了コード 1 で分かる。公式のマニュアルは、衝突の判定にはファイルの一覧ではなく終了コードを使うよう書いている。次のスクリプトを .github/scripts/sync-main-to-dev.sh に置く。
#!/usr/bin/env bash
# origin の main を dev に merge して push する。force はしない
set -euo pipefail
git fetch origin \
'+refs/heads/main:refs/remotes/origin/main' \
'+refs/heads/dev:refs/remotes/origin/dev'
dev=$(git rev-parse origin/dev)
main=$(git rev-parse origin/main)
# 作業ツリーを使わずに merge の結果の tree を作る。衝突なら exit 1
status=0
result=$(git merge-tree --write-tree --name-only --no-messages "$dev" "$main") || status=$?
if [ "$status" -eq 1 ]; then
echo "main と dev が衝突したので同期しない。衝突したファイル:" >&2
printf '%s\n' "$result" | tail -n +2 >&2
exit 1
elif [ "$status" -ne 0 ]; then
exit "$status"
fi
# merge しても dev の中身が変わらないなら、何もしない
if [ "$result" = "$(git rev-parse "$dev^{tree}")" ]; then
echo "dev の内容は変わらないので push しない"
exit 0
fi
commit=$(git commit-tree "$result" -p "$dev" -p "$main" -m 'chore: main を dev に同期')
git push origin "$commit:refs/heads/dev"
echo "dev に同期した: $commit"
name: Sync main to dev
on:
push:
branches: [main]
workflow_dispatch:
concurrency:
group: sync-main-to-dev
cancel-in-progress: false
permissions:
contents: write
jobs:
sync:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v7
with:
fetch-depth: 0
- run: |
git config user.name "github-actions[bot]"
git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
- run: bash .github/scripts/sync-main-to-dev.sh
fetch-depth: 0 で履歴を全部取るのは、merge の基点を見つけるためだ。concurrency は同期を 1 本ずつ走らせる。待ちが重なると古い待ちは新しいほうに置き換えられるが、どの run も最新の main を取り直すので困らない。
表の 4 行を一時ディレクトリの bare リポジトリで bash 3.2 と 5 の両方で流すと表どおりに動き、4 行目の push は ! [rejected] … -> dev (fetch first) と出て拒否された。
同期の commit では CI が走らない
GITHUB_TOKEN で起きたイベントは、workflow_dispatch などの例外を除いて新しい workflow の run を作らない。公式 docs によれば、workflow が workflow を呼び続ける事故を防ぐための仕様だ。同期の push で dev の CI は起動しない。
うちはこれを受け入れた。CI はもともと PR でしか動かしておらず、同期で dev に入った中身は、次の dev → main の PR の CI がまとめて確かめる。同期の直後に dev で必ず CI を回したいなら、GitHub App のトークンで push するなど、別の手が要る。
dev 側の保護設定にも当たりうる。「PR を経ないと push できない」保護を dev に掛けていると、この直接 push は通らない。うちの dev は保護ブランチだが PR 必須ではないので通った。また、GITHUB_TOKEN の permissions には workflow ファイルを書き換える権限の項目が無い。main にだけある変更に .github/workflows/ が含まれると push が拒否される見込みで、ここはまだ踏んでいない。拒否されたら手で同期する。
初回の run と、自分でやるときの境目
この workflow は、リリースの PR に乗って main に入った。その merge の push で最初の同期が走り、冒頭の 3 本ぶんの package-lock.json の変更を、merge commit 1 つで dev に運んだ。dev で進んでいた作業には触れていない。
スクリプトと workflow は上のものを置けば動く。ただ、リポジトリごとに決めることが残る。
| 決めること | 自分でできるか | うちで決めたこと・残っていること |
|---|---|---|
| 同期しない条件(衝突・中身が同じ・dev が先行) | できる。表の 4 行をそのまま使う | 失敗の通知が届く人を先に決めた |
| dev → main を merge commit で出しているか | 確かめるだけ | 祖先の判定をやめ、tree で比べた |
| dev の保護設定 | 設定の確認で済む | PR 必須だと bot の push は通らない |
| 同期の後の CI | 運用の判断が要る | dev では回さず、次のリリース PR の CI に任せた |
.github/workflows/ が main にだけ入ったとき | 権限の設計が要る | まだ踏んでいない。拒否されたら手で同期する |
上 3 行は設定と確認で終わる。下 2 行は、CI をどこで回すか、bot にどこまで権限を渡すかの判断になる。
まとめ
- Dependabot のセキュリティ更新と hotfix は main に届く。dev → main の運用では、main から dev への戻り道を別に作る
- 同期が要るかは、履歴の前後ではなく、merge した結果の tree が dev と同じかで判定する。祖先の判定だと、リリースのたびに要ると言い出す
- 衝突したら dev を動かさずに失敗させ、force なしで push する。
GITHUB_TOKENの push では CI が走らないので、検証をどこに任せるかを決めておく
自動化した同期で、いちばん大事な機能は「やらない」だった。衝突しても、中身が同じでも、dev が先に進んでいても、bot は何もせずに帰ってくる。
playpark では、dev → main のようなブランチ運用で、hotfix やセキュリティ更新の戻し漏れを止める GitHub Actions の設計と導入を引き受けています。同期の後の CI をどこで回すか、bot の権限をどこまで渡すかの判断まで一緒に詰めます。
相談するときは、ブランチの構成(main と dev の関係、PR 必須の保護の有無)、本番への出し方(merge commit か squash か)、main にだけ入る変更がどこから来ているか(Dependabot・hotfix など)を書いてもらえると、最初の返信から具体的な案で話せます。



