From b23e63d4c69ced6e53358a49822cf50d3296c8a2 Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Sun, 8 Nov 2026 14:57:15 +0900 Subject: [PATCH] docs: record v0.12.0 production release [skip ci] --- .../releases/2026-11-08-rss-folders.md | 76 +++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 docs/operations/releases/2026-11-08-rss-folders.md diff --git a/docs/operations/releases/2026-11-08-rss-folders.md b/docs/operations/releases/2026-11-08-rss-folders.md new file mode 100644 index 0000000..89a4537 --- /dev/null +++ b/docs/operations/releases/2026-11-08-rss-folders.md @@ -0,0 +1,76 @@ +# RSSフォルダと取り込み操作のリリース + +## 対象 + +v0.12.0は`f4869c7c8bd2fd48523eec2e1868d3d0750bbdf7`。 +2026-11-08 14:55 JSTに本番検証を完了し、注釈付きGitタグとイメージを公開した。 +既存v0.11.0タグは移動していない。 +独立pages-cliと未コミットのメール保存先調査は含めない。 + +- [ビルドCI run 64](https://git.anya.jp/anya/pages/actions/runs/64): success。 +- [リリースCI run 65](https://git.anya.jp/anya/pages/actions/runs/65): success。 +- [Gitea Release v0.12.0](https://git.anya.jp/anya/pages/releases/tag/v0.12.0)。 + +本番`.env.release`は同コミットの`sha-`タグに固定している。 +`v0.12.0`は再ビルドせず同一manifestを昇格し、3イメージすべてのdigestとrevisionを照合済み。 + +## 変更 + +- FreshRSSの分類フォルダ・購読元をツリー表示し、空フォルダ・未分類・開閉状態保存に対応。 +- 記事・購読元・分類を背景で原子的に更新し、一部失敗時は前回cacheを保持。 +- 既読・star書戻しの操作履歴、結果不明の再確認、JSON記録保存。 +- ショートカットヘルプを`?`・`Esc`・閉じるボタンで閉じ、元の記事とstatus表示を保持。 +- Wiki・タスク追加を本文上のdialogへ整理し、個人設定のWiki親Pathを初期表示。 +- `{YYYY}`・`{MM}`・`{DD}`・`{Subject}`を親Pathで使用可能。日付はドメインのタイムゾーン。 +- 件名を安全な単一Path要素へ整形し、保存先プレビューと公開範囲確認を表示。 +- `sharing.x`の有効・無効に従うRSS記事のX共有。件名と原文URLを別タブのintentへ渡す。 +- 個人設定からRSS原文・本文リンクを別タブまたは大きなiframeプレビューで開く方式を選択。 + +個人設定は`/-/sys/config?panel=organizer`。Wiki親Pathはメール取り込みと共通。 +リンクの開き方は既定で別タブとし、設定変更はRSS画面の再読込後に反映する。 +iframeはsandbox付きで、外部サイトの埋め込み禁止は回避しない。表示できない場合は別タブへ開く。 +本番利用者の既定値やFreshRSS書戻し許可を自動変更しない。 +詳細は[RSS設計](../../design/ja/feeds.md)を参照。 + +## 移行と保全 + +今回の本番schema差分はfeeds v5→v6。`feed_sources.remote_folders`の列追加であり、 +既存記事・購読設定・送信待ちreceipt・source versionを変更しない。 +Wiki親Pathとリンク表示モードは既存preferences JSONを使うため追加DDLはない。 +旧版がv6を理解するとは仮定せず、単なる旧イメージへの切戻しを自動実行しない。 + +保全先は`.deployment-backups/release-rss-folders-20261108/`。 +旧構成を`config/`、停止時点のデータを`cutover/data`・`cutover/data2`に保存した。 +14:53:29 JSTに停止を開始し、14:54:38 JSTにchecksum付き同期・差分ゼロ・DBの一致を確認した。 +事前コピーだけでは整合バックアップと扱っていない。 +稼働元とはinodeを共有せず、既存の不変バックアップとのみ変更のないファイルを共有する。 +旧イメージは`rollback-before-rss-folders-20261108`タグで保全した。 + +## 検証 + +手元のGo全体テスト・go vet、RSS関連のrace検査、1440px/390pxのChromium試験を実施。 +分類の空・未分類・移動・同名ID、失敗時cache保持、schema v6のrollback・再実行を検査した。 +親Pathの日付境界・日本語件名・階層逸脱防止・不正トークン拒否を検査した。 +リンクプレビューは別originのローカルfixtureを実際に読み込み、sandboxと復帰を検査した。 +実FreshRSS・Xへの投稿・外部カレンダー・実メール本文を検証のために取得・操作していない。 + +停止済みの前回バックアップから独立コピーを作り、両DBの移行前integrity_checkはok。 +配備イメージをネットワーク遮断・workers無効で実際に起動し、両DBでfeeds v6への移行、 +ヘルス、管理対象13コンポーネントのschema check、移行後integrity_checkのokを確認した。 +schema check単体ではlegacy領域を網羅しないため、起動・SQLite検査と組み合わせた。 + +本番切替後は以下を確認した。 + +- app・app2・adaptor-gateway・excalidraw-viewerが対象revisionで稼働、restart countは0。 +- 両アプリの`/health`、schema checkが正常。feeds v6、task-productivity v4。 +- HTTPSの`/health`とログインは200、匿名のRSS・タスク・設定画面は303、RSS APIは401。 +- 配信中の`feeds.js`・`feeds.css`・`task-productivity.js`のSHA-256がリポジトリと一致。 +- 起動後ログのpanic・fatal・DB locked・event job failed・schema errorは各0件。 + +## 配布イメージのdigest + +| イメージ(`git.anya.jp/anya/`、タグ`v0.12.0`) | manifest digest | +| --- | --- | +| pageswiki-app | `sha256:46251f9b869e47d456def4d285c3f076e0d375f2a11d69121885fca08997e6a7` | +| pageswiki-adaptor-gateway | `sha256:ee98889018f8389a655126c6a5d1046640be22cae169d97c4b27a7efa08f86c6` | +| pageswiki-excalidraw-viewer | `sha256:e7a577a8f178f625f6b13da93b046afda57c5c4c67e5e3b86cab0daf5c5f14ee` |