# 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へ検証用アクセスを行っていない。 ## 容量整理 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へ増えた。