Files
pages/docs/operations/releases/2026-11-06-mail-subject-path.md
T

5.4 KiB
Raw Blame History

日本語メール件名とWiki Pathの修正

PagesWiki v0.8.1とpages-cli v0.3.1はメールの表示名とPathの識別子を分離する。v0.8.0は件名全体をURLへ含め、CLIは300 UTF-8 bytesを超える件名を取り込み前に拒否していた。短い日本語Pathそのものは合成HTTP試験で取得可能だが、実メールの失敗入力は取得していないため、報告されたすべての失敗が同じ原因とは断定しない。

動作

  • Wiki Pathの末尾は mail-request_id。接続先・本人・Message-IDから生成済みのUUIDを利用し、件名の文字コード・記号・長さに依存しない。Message-IDそのものをURLへ露出しない。Message-IDなしは原文SHA-256から識別する。
  • MIME Subjectを復号後、先頭の [list 123]・[list:123]・[list#123] を除去する。Re:/Fw:/Fwd:は維持し、その後の連番も除去する。連番を含まない [重要] や途中の括弧はそのまま。
  • 自動件名は300 UTF-8 bytes以内に文字境界で省略し「…」を付ける。元のSubjectはWiki本文へ保持する。明示的な --title は連番除去・省略をせず、上限を超えたら拒否する。
  • 既存ページのPath・タスク名を一括更新しない。既存receiptを使った同一要求の再送は元のページを返す。旧版で保存済みのメールを新しい本文・件名で再作成すると412となるため、通信失敗分は保持済み要求の task retry を使う。

個人設定の既定Wiki親Pathと保存先ACLは従来通り。APIフィールド・receipt hash形式・DBスキーマは変更しない。

ソースと確認

サーバーの対象コミットは 3262f8800547e8ea343fe290153d4abc84ebd0d0、CLIは 541c2bd069b5507281b0dde2810243447c098e71。サーバーのCLI結合テスト用コピーも同じソースへ更新した。

CLI単体42件、全Goテスト、go vetを実施した。合成メールの日本語SubjectからWikiを作成し、関連メモAPIからPathを取得して本文をHTTP取得する結合テストが成功した。既存の日本語PathのHTTP取得・URLエンコードと再送時の非移動も検証した。

CLI v0.3.1はmain CI run 38、タグCI run 40で成功。公開添付5ファイルを匿名ダウンロードし、4生成物のSHA-256を照合した。公開ELFでUTF-8/ISO-2022-JPのSubject、ML連番除去、元件名保持、Message-IDによる同一識別子、通常のログイン・メール取り込み・連絡先スモークを確認した。

リリースと本番反映

サーバーCI run 39の全工程が成功し、run 41で検証済みSHAイメージをv0.8.1へ昇格した。ソースrevisionとリリースイメージの一致を確認した。公開タグの付け替えは行っていない。

イメージ v0.8.1 manifest digest
pageswiki-app sha256:44aa267d010568e6dd83354839d976429dc979ed283888009457bffcc2d37119
pageswiki-adaptor-gateway sha256:5ccf30103cf4f01a49de0d80289736cbca9cde6f0e34661a39652b3468843533
pageswiki-excalidraw-viewer sha256:33b44cc2c061c3b66ce8e1124b9e25c43584aec508669564c9f4a260e1c53454

2026-11-06 09:15:57 JSTに対象4サービスの停止を開始、09:17:03に最終バックアップ照合完了、09:17:09にv0.8.1起動完了。停止から起動まで72秒。.env.release を更新し、registry overlayの対象4サービスだけを up --no-build --no-deps した。code-serverやKroki等は変更していない。

.deployment-backups/release-v0.8.1-20261106/ に構成と cutover/data・cutover/data2 を保持する。停止後のchecksum付き同期と差分ゼロ、DB・WAL・SHMのバイト一致と稼働元と異なるinodeを確認した。変更のないファイルは前回の不変バックアップとのみlink-destで共有する。旧イメージは rollback-before-v0.8.1-20261106 を付けて保持した。既存バックアップは削除しない。

このホストの /home/anya/.local/bin/pages を公開ELFのv0.3.1へ原子的に置換し、バイト一致・versionを確認した。旧CLIは保全先configの pages-before-v0.3.1 に保持する。利用者の資格情報・セッション・個人設定は変更していない。独立CLIリポジトリも対象コミットとタグへ同期した。

両系統の管理対象12コンポーネントは切替前後ともcurrent。全コンテナのrevision一致、起動正常・再起動0回、appとExcalidrawのhealthy、app2内部health、初期ログのエラーパターン0件を確認した。公開HTTPSのhealth・ログインは200、匿名のタスク・個人設定は303、preferences API・CardDAVは401。配信されたtasks.js・task-productivity.js・tasks.cssはリリースとSHA-256一致。これはlegacy領域を含む全データ完全性検査ではない。

実メール本文・外部取り込みカレンダーは検証に使用していない。本番には合成メールやタスクを追加せず、認証済み操作は一時DBで確認した。保全は内容を解釈しないファイルコピー。完了時の空き容量は約26 GiB。切戻しは書込みを停止し現状も保全して実施し、バックアップを自動復元しない。