
Book を push して 36 時間放置したら何が起きたか——「自動リカバリ」が落ちる現場の話
続きの話
数日前、Zenn の Book を push したのに 8 時間 404 が返ってきた話を書いた。
そのとき、私は published: true を維持し、revert はしなかった。
理由は単純で、過去に短時間で revert すると Zenn 側のデプロイ処理が
「キャンセル → 永久未反映」になる失敗モードを踏んだことがあるからだ。
その続編を書く。
8 時間 → 12 時間 → 24 時間 → 32 時間。
私は 6 時間ごとに API を叩き、URL を curl で確認し、journalctl で
push の successful exit を確認した。
結論を先に書く。自動リカバリは、ある条件下では落ちる。
何を「自動リカバリ」と呼んでいたか
私の運用では、毎日 17:30 に systemd timer が daily_content.sh を起動し、
その中で /tmp/zenn-content リポジトリに対して再 push を仕掛けるロジックがある。
最初の push で反映されなかった場合、翌日の 17:30 に同じ内容が再 push されることで、
Zenn 側の「未処理キュー」を再度突つく挙動を期待していた。
実際、過去の Book 3(4/26 公開)では、push 後 ~24h で反映が走ったため、
「24h 以内なら待てば反映する」というのが私の中での経験則になっていた。
今回はその経験則が外れた。
32 時間後の状況
https://zenn.dev/techquant/books/tq-raspi-server-ops-202605 → 404
https://zenn.dev/api/books/tq-raspi-server-ops-202605 → 403(閲覧権限がありません)
https://zenn.dev/api/users/techquant/books?count=10 → 自分の Book リストから漏れている
ローカル zenn-repo/books/tq-raspi-server-ops-202605/config.yaml の published: true は維持
/tmp/zenn-content 側も published: true・最新 commit が 17:30 の再 push 分
つまり、Zenn 内部のデプロイキューに新しいジョブが積まれていない可能性が高い。
GitHub の commit は届いている、でも Zenn 側はそれを「変更なし」と判定して、
デプロイ処理をスキップしているのではないか、という仮説。
唯一残った手段
API での状態問い合わせができない(403 が返るので publish state が見えない)以上、
ダッシュボード(https://zenn.dev/dashboard/deploys)で
デプロイキューを目視確認し、必要なら手動で Retry を打つ、これしか手が残っていない。
「自動化」と「手動による最終手段の温存」の境界を、もう一段、明確にする必要がある。
学び
自動リカバリのループは、対象側がそれを「変更」と認識しない限り意味がない
API が 403 を返す状態(=未公開)では、API ベースの観測ループ自体が機能しない
手動 Retry の動線(ダッシュボード URL を即座に取り出せる状態)を、ジョブの成功時にも記録しておくべき
3 はメタな学びで、私の通知スクリプトに success 通知の中にも
「もし反映されなければここを開け」という URL を埋めるようにした。
重要事項: 本記事は、AIとRaspberry Piを用いた自動売買システムの周辺自動化(記事公開・Zenn Book デプロイ等)における運用上の知見を共有するものであり、特定の金融商品の売買を推奨するものではありません。筆者は金融商品取引法に基づく投資助言・代理業の登録を受けておらず、本記事は投資助言に該当するサービスではありません。