commit にしか残っていない原本画像は、誰にも拾われなかった:ブランチごと消える前に非公開 R2 へ退避する
この記事について
記事の見出し画像の原本(raw)は、毎日の退避ジョブで非公開の R2 へ逃がしている。ところが、そのジョブが拾うのは「チェックアウトの未追跡ファイル」だけだった。commit の中にしか存在しない raw は、ブランチを消せば gc で失われるまで、誰にも拾われない。2026-09-26(Issue #3500)に分かった穴と、塞ぐために作った scripts/ops/rescue_raw_from_commit.sh の設計を記録する。
何が拾われていなかったか
退避ジョブ raw_masters_push_drip.sh の対象は、未追跡の raw に限られていた。いったん commit に入った画像は未追跡ではなくなるので、対象から外れる。
| 置き場所 | 退避ジョブが拾うか |
|---|---|
| チェックアウトの未追跡 raw | 拾う |
| commit にだけ残る raw(未 push・削除済みブランチ) | 拾わない |
実例は2件あった。
- 再取得できないコミュニティノートのスクリーンショット原本
- 記事の見出し画像1枚
どちらも、ある機のローカルブランチにしか存在しなかった。ブランチを消して gc が走れば、戻す手段がない。
設計:3段で動かす
rescue_raw_from_commit.sh は、引数に commit とパス絞り込み(部分一致・複数指定は OR)を取り、3段で動く。
- 一覧モード(既定): 指定 commit の
/raw/配下にある png / jpg / jpeg / webp を列挙する。manifest に登録済みのものは、原本が既に R2 にあるので除く - 取り出し: origin/main から使い捨ての worktree を切り、画像だけをそこへ置く
--applyのときだけ退避: 非公開 R2 へ push する。SHA とサイズを照合し、manifest の差分を PR にする
# 一覧だけ(何も書かない)
bash scripts/ops/rescue_raw_from_commit.sh <commit> [パス絞り込み...]
# 退避して PR まで
bash scripts/ops/rescue_raw_from_commit.sh <commit> [パス絞り込み...] --apply
実行は、そのブランチを持っている機で行う。commit がローカルにしか無いからである。
取り出さないものを決めた
取り出すのは画像だけにした。prompts.json と sources.json は除外している。サイドカー JSON の中身が実物と食い違っていると、画像パイプラインの検証が、公開済みの記事へ挿絵を二重に差し込みに行くためである。
もう一つの制約は、main リポに1バイトも書かないこと。取り出しは使い捨ての worktree の中で完結させ、作業後に worktree も作業ブランチも残さない。
先に守る:退避を後回しにするとき
退避をすぐ打てない場合は、先に参照を1本作る。
git branch rescue/raw-<名前> <commit>
参照があれば gc で commit は消えない。退避スクリプトを実行するまでの時間稼ぎとして使う。
テスト:止まることを確かめる
回帰テスト scripts/test_rescue_raw_from_commit.sh は、使い捨ての bare origin と偽リポジトリを作り、R2 への退避をスタブに差し替えて5件を見る。ネットワーク・R2・gh は使わない。
| # | 見るもの |
|---|---|
| 1 | 一覧モードは、登録済みを除外し、未登録の raw 画像だけを出す(prompts.json は対象外) |
| 2 | パス絞り込みが効く |
| 3 | 存在しない commit では非0で止まる |
| 4 | --apply が成功したとき、取り出したバイトが原本と一致し、コミットされるのは manifest だけ。worktree も作業ブランチも残らない |
| 5 | --apply で退避が失敗したとき、非0で止まり、何も push しない |
5番は「動くこと」ではなく「止まること」の確認である。退避に失敗したまま manifest だけが更新されると、R2 に無い原本が「退避済み」と記録されてしまう。
現時点のステータス
- 実装済み: 一覧・取り出し・退避・PR 化の3段、回帰テスト5件
- 運用上の制約: 原本を持っている機で実行する必要がある