docs: record RSS release and verified production rollout [skip ci]
This commit is contained in:
1 parent
61ecd1ffbd
commit
4711a0efbf
1 file changed
+87
@@ -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へ検証用アクセスを行っていない。
|
||||||
Reference in new issue
Block a user