From 4711a0efbf2ab67062bb32301a090656308a91ee Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Sun, 8 Nov 2026 06:23:36 +0900 Subject: [PATCH] docs: record RSS release and verified production rollout [skip ci] --- docs/operations/releases/2026-11-08-rss.md | 87 ++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100644 docs/operations/releases/2026-11-08-rss.md diff --git a/docs/operations/releases/2026-11-08-rss.md b/docs/operations/releases/2026-11-08-rss.md new file mode 100644 index 0000000..9e77734 --- /dev/null +++ b/docs/operations/releases/2026-11-08-rss.md @@ -0,0 +1,87 @@ +# 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設計](../../design/ja/feeds.md)を参照。 + +今回の本番移行には、前段のタスク作業記録訂正監査・日次ダイジェストの送信試行記録も含む。 +管理対象スキーマの差分は、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](https://git.anya.jp/anya/pages/actions/runs/53)はv0.11.0候補の全テスト・3イメージの公開に成功。 + [release run 55](https://git.anya.jp/anya/pages/actions/runs/55)で既存イメージを再ビルドせずv0.11.0へ昇格した。 +- CI run 54は既存3テストのSQLite接続初期化が5秒でtimeout。追加したFreshRSS試験の失敗ではない。 + 該当3テストを手元で各3回成功。テスト専用tmpfsを導入し、 + [run 56](https://git.anya.jp/anya/pages/actions/runs/56)で全テスト・3イメージ公開が成功。 + server 97.912秒、store 27.685秒。テスト省略や本番のdeadline変更は行っていない。 + 詳しくは[CI運用](../gitea-images.md#テスト用一時領域)を参照。 +- 前回停止時バックアップを独立コピーし、ネットワーク遮断・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へ検証用アクセスを行っていない。