7.7 KiB
RSSリリースとFreshRSS書き戻しの本番反映
リリース境界
注釈付きタグv0.11.0は16e572397b2b1abf096bd6bca26e2af832768b8dを指す。
RSSの内蔵reader、OPML、FreshRSSの読み取り・購読カタログまでの区切りであり、タグは移動しない。
その後の既読・star書き戻しを含む本番反映は61ecd1ffbdf46897d50c2f7eb7a2e1415f1bb456。
131a7caで機能を実装し、61ecd1fでCIのテスト一時領域だけを改善した。
2026-11-08 JSTに本番反映済み。独立pages-cliや未コミットのメール保存先調査は対象外。
機能と安全条件
FreshRSSを正本とし、source単位で明示的に許可した場合だけ既読・starの変更を送る。 許可は既定OFF。UI操作は永続キューへ入り、外部での確認後に表示へ反映する。 送信結果が不明になった場合は自動再送せず、利用者の再確認操作で外部状態を読む。 操作IDによる重複防止、source更新との競合、権限失効、source削除、共有leaseを扱う。 詳細と残件はRSS設計を参照。
今回の本番移行には、前段のタスク作業記録訂正監査・日次ダイジェストの送信試行記録も含む。 管理対象スキーマの差分は、feedsの未導入状態からv5、task-productivityのv2からv4。 ファイル正本の一括書換えは行わない。後続版のスキーマを旧版へ自動downgradeしない。
検証記録
- 手元で
go test -p 1 ./...、go vet ./...が成功。 - feeds関連のrace検査、1440px・390pxのChromium試験、JavaScript構文検査が成功。
- 合成FreshRSSでread/starの追加・解除、応答喪失、再確認、競合、設定変更・失効を検査。
- v5の移行失敗時rollback、再実行、既定OFF、source削除後の操作記録保持を検査。
- CI run 53はv0.11.0候補の全テスト・3イメージの公開に成功。 release run 55で既存イメージを再ビルドせずv0.11.0へ昇格した。
- CI run 54は既存3テストのSQLite接続初期化が5秒でtimeout。追加したFreshRSS試験の失敗ではない。 該当3テストを手元で各3回成功。テスト専用tmpfsを導入し、 run 56で全テスト・3イメージ公開が成功。 server 97.912秒、store 27.685秒。テスト省略や本番のdeadline変更は行っていない。 詳しくはCI運用を参照。
- 前回停止時バックアップを独立コピーし、ネットワーク遮断・workers無効で主/外部DBを起動。 v0.11.0候補でfeeds v4・task-productivity v4への移行、health、schema check、integrity_checkが成功。 外部インスタンスのリハーサルでは再登録を実行せず、既存DBを通常起動した。 最終イメージではコピーを旧版の状態に戻して起動し、両DBともfeeds v5・task-productivity v4まで 移行した後のhealth・schema check・SQLite integrity_checkが成功した。
外部取り込みカレンダーと実メール本文は取得・表示していない。実FreshRSSへの操作も行っていない。 DB・正本の保全はファイルコピーとバイト照合だけを用いる。実サービスへの書き戻し受入確認は残る。
保全・切替手順
保全先は.deployment-backups/release-rss-20261108/。親0700、構成コピー0600。
旧構成と停止時点のcutover/data・cutover/data2を保持する。
変更のないファイルは前回の不変バックアップとのみhardlinkを共有し、稼働元とは共有しない。
ディスク空きがDBより小さいため、今回新しく独立コピーしたpages.db(link数1を検証)だけは
停止後にchecksum付きin-place同期する。他のファイルにin-place更新を使わない。
最終checksum差分ゼロとDBのバイト一致を確認してから新しいイメージを起動する。
旧バックアップ・旧イメージは削除しない。
対象はapp・app2・adaptor-gateway・excalidraw-viewerの4サービス。
CI成功後の同一SHAの3イメージをpullし、registry overlayでup --no-build --no-depsする。
code-server・Kroki・独立CLI・ネットワーク構成は変更しない。
切戻しが必要な場合は書込みを停止し、切替後データも保全した上で互換性を判断する。
稼働中DBへ旧バックアップを自動復元しない。
本番反映結果
2026-11-08 06:20:55 JSTに停止開始、06:22:12にバックアップ最終照合・sync完了、
06:22:37に4サービスの起動確認完了。停止開始から起動確認まで102秒。
.env.releaseはsha-61ecd1ffbdf46897d50c2f7eb7a2e1415f1bb456を指定する。
本番のバージョン指定はv0.11.0タグそのものではなく、追加実装を含むこの固定SHAである。
| イメージ | manifest digest |
|---|---|
| pageswiki-app | sha256:e452a7dbadf13c89909c5ee6a685fa39342926675dec2253747534ef6ffabfb0 |
| pageswiki-adaptor-gateway | sha256:77efae4ef3651e12ebac6a15474448dd93bfa89a7072b8db8e296322a68a7956 |
| pageswiki-excalidraw-viewer | sha256:45b6399438fa1b40d54c0b6dfbcc15ca1464abb03b454e8b281d94d58c80b250 |
4コンテナのsource revision一致・running・再起動0回を確認。主/外部インスタンスのhealth正常、 両DBの管理対象13コンポーネントのschema checkはcurrent。 このschema checkだけで全データや全legacy schemaの完全性を保証するものではない。 公開HTTPSのhealth・ログインは200、匿名RSS・タスク・拡張設定画面は303、RSSのsources・action APIは401。 配信feeds.jsとfeeds.cssのSHA256は配備コミットと一致する。 起動後ログのpanic・fatal・database is locked・event job failed・schema失敗の検索パターンは0件。
最終バックアップの両ルートともchecksum付きdry-runの差分はゼロ。
旧v0.10.0イメージはrollback-before-rss-20261108タグで保持し、ローカルlatestは新イメージに揃えた。
今回作成した隔離リハーサル用の一時コピーとコンテナは片付けたが、旧バックアップは削除していない。
完了時のディスク空きは約4GiB。その後の容量整理は次節のとおり。
FreshRSSの書き戻し許可は自動有効化していない。本番ユーザーの設定・記事状態を試験のために変更せず、 外部取り込みカレンダー・実メール・実FreshRSSへ検証用アクセスを行っていない。
容量整理
2026-11-08、ユーザーの削除指示を受け、旧リリースのバックアップ8世代を削除した。
対象はrelease-v0.4.0、v0.5.0、v0.6.0、v0.7.0、v0.7.1、v0.8.0、v0.8.1、v0.9.0の各ディレクトリ。
現在の切替直前を保全したrelease-rss-20261108と、その前のrelease-v0.10.0-20261107を残した。
hardlink共有ファイルも、残したバックアップの参照は維持される。開発時の小さなソース保全やrsyncログは変更していない。
9月のrsyncログを11月のバックアップの外部転送証明とは扱わず、今回の保持世代整理として削除した。
DockerはPagesWikiの指定repositoryだけを対象に、全コンテナの使用中image ID、v0.10.0の切戻し用、 v0.11.0の手元イメージを保護した。旧43 image IDに属する102タグと関連参照をforceなしで削除。 daemon全体のprune、レジストリの削除、他サービスのイメージ/volume削除は行っていない。 本番停止は不要で、空き容量は約4GiBから約61GiBへ増えた。