commit にしか残っていない原本画像は、誰にも拾われなかった:ブランチごと消える前に非公開 R2 へ退避する

  • #画像パイプライン
  • #R2
  • #git
  • #運用
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段で動く。

  1. 一覧モード(既定): 指定 commit の /raw/ 配下にある png / jpg / jpeg / webp を列挙する。manifest に登録済みのものは、原本が既に R2 にあるので除く
  2. 取り出し: origin/main から使い捨ての worktree を切り、画像だけをそこへ置く
  3. --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件
  • 運用上の制約: 原本を持っている機で実行する必要がある