Files
pages/docs/operations/releases/2026-11-08-task-capture-recovery.md
T

5.7 KiB
Raw Blame History

PagesWiki v0.14.1とpages-cli v0.4.2

削除済みタスクの受付記録が残り、変更した下書きの再送で412になっていた問題を修正します。 削除済みなら410、受付記録に対応するタスクと削除記録が両方欠落していれば409 capture_missing で停止します。 存続中のタスクを異内容のcaptureで上書きすることは許可しません。

2026-11-08 19:42:51 JSTに本番配備後の確認を完了しました。 DBスキーマ変更・既存データの削除・実タスクの再取り込みは行っていません。 Gecko等の未コミット変更は含みません。

再取り込み

サーバーをv0.14.1、利用するCLIをv0.4.2に更新してから実行します。 別インスタンスへ接続している場合は、その接続先サーバーの更新も必要です。

pages --version
pages task retry REQUEST_UUID --recreate-deleted

保持した下書きから、新UUIDのタスクを作成します。旧UUIDの削除記録とDAV識別子予約を残し、 通常の再送で古いタスクが復活するのを防ぎます。再取り込み用IDは決定的で、応答消失や並行再送でも重複作成しません。 既存Wikiが保存先にあれば本文・リビジョンは変更せず、新タスクから関連付けます。 ページがなければ保留本文から作ります。移動済みページの自動探索や旧作業記録の復元ではありません。

通信失敗時はCLIが表示する新IDで pages task retry NEW_REQUEST_UUID を実行します。 セッションファイルや受付記録を手動で消さないでください。 詳細は実装契約と CLIのNeoMutt手順を参照してください。

リリースと検証

対象 タグ commit CI
PagesWiki v0.14.1 4049acf76e36c12b8f3c506de5eaf1e920ac7e86 build 72、release 75 success
pages-cli v0.4.2 e27c023d66a61b73d3fe47e982daa6f34213c41f build 73、release 74 success
  • 正確なリリースソースで go test ./...。server/storeのgo vet、削除・再取り込み・並行再送のrace検査が成功。
  • CLIの52単体テスト、サーバーとCLIのHTTP結合テストが成功。Wiki本文・版の保全、他所有者拒否、readonly、kill switch、入力上限、保存途中のロールバックを検証。
  • 公開されたCLIの4配布ファイルをSHA256SUMSで照合し、Pythonソースとcommitを照合。
  • 配布Linux ELFでバージョン、メール取り込み、下書き差し替え、削除済み再取り込み、認証・ファイル権限のスモークテストとTLS関連6テストが成功。
  • Linux ELFはglibc 2.36以降。macOS/Windowsの未検証バイナリは配布していません。

本番切り替えと復旧点

app・app2・adaptor-gateway・excalidraw-viewerを同じv0.14.1へ更新しました。 .env.release の選択は PAGESWIKI_IMAGE_TAG=v0.14.1 です。

  • 19:40:36 JSTに停止開始。
  • 19:42:17 JSTに、停止時点のdata/data2についてchecksum同期、再走査の差分ゼロ、DBファイル一致を確認。
  • 19:42:23 JSTに新版の起動と両アプリのhealth応答を確認。
  • 設定と停止時データは .deployment-backups/release-v0.14.1-20261108/ の config/ と cutover/data、cutover/data2 に保存。DBのinodeは稼働元と独立しています。
  • 旧3イメージを rollback-before-v0.14.1-20261108 タグで保持。旧バックアップも残しています。

v0.14.0への切り戻しはイメージ選択のみで行い、DBを過去へ戻しません。 その場合は再取り込みAPIが利用できなくなるため、CLIの再取り込み操作を止めてください。 v0.14.0より前への切り戻しは削除記録の扱いが異なり、v0.14.0の注意点が引き続き適用されます。

配備後確認

  • 4サービスのrevisionが対象commitと一致、running、再起動回数0。
  • app/app2のhealth正常。管理対象13スキーマはcurrent。これはlegacy領域を含む全移行検証ではありませんが、今回の変更にスキーマ移行はありません。
  • 両DBの quick_check はok。
  • 外部HTTPSのhealth・ログイン画面200。匿名のタスク/ダッシュボード/RSS画面303、タスクAPI401。匿名DELETEとcapture POSTも401。
  • tasks.js、tasks.css、organizer-dashboard.js、feeds.js、feed-gecko.jsのSHA-256がリリースcommitと一致。
  • 起動直後のfatal/panic、DB lock、schema/migration failure、event job failureは両アプリとも0件。
  • 実際のメール本文・利用者の保留下書きを使った再取り込みは実施していません。

配布イメージ

SHAタグから再ビルドせず昇格。本番で取得したdigestとCI結果は一致しています。

イメージ(git.anya.jp/anya/、タグv0.14.1) manifest digest
pageswiki-app sha256:11488fb958db12ec5a25aa265fc8179a31ab5728800f47605759822a44eb81e6
pageswiki-adaptor-gateway sha256:ca17704eb5e88a4e73827ff2a5fafda7c4bb7d9be3987b5a83a3a5ae0c780098
pageswiki-excalidraw-viewer sha256:a2b692c3864b8c4f13412e746fcea7cd9a2c03d49e0d5ead252432f37930c4c4