Files
pages/docs/design/ja/operations.md
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

3.6 KiB
Raw Permalink Blame History

18. 性能・保全・外部ストレージ・HA/DR

状態:単一writerのSQLite運用、限定付きジョブ・cache、バックアップ手段あり。HAと外部保存は別途設計・検証が必要。

現状と性能優先順位

複数インスタンスがあっても、同じDBを共有するHAではありません。各SQLiteとDocument Storeのauthorityを区別します。コンテンツを読む要求に、全履歴走査、全文body hydration、巨大archive展開、外部接続待ちを持ち込まないことが最優先です。

課題 次の修正方向 完了を判定する試験
全Path集計 directory索引・局所query・cursor 大階層で候補数とDB時間が限定される
全City取得 shallow projection・遅延Page取得 小範囲表示で全体を読まない
歴史RevisionのFTS current-only、安全なplain text索引 更新・削除・日本語検索・権限失効
大容量restore immutable参照再利用・stream heapがpayloadサイズに比例しない
decoder process隔離・重み付き予算 timeout/cancel/メモリ上限で確実に終了
失効とcache generation+要求時認可 古い一覧からprivate内容を復活させない

上限を増やす前にquery planと現実的なデータ量を測ります。公開ページの匿名cacheと認証ユーザーの認可cacheを同一にしません。

保全

DBだけでなくDocument Store、設定、復旧に必要な鍵を区別してバックアップします。稼働SQLiteを単純copyせず、online backup等の整合した手段を使います。Documentの固定hash検証、参照整合性、戻し手順をfixtureまたは別環境で確認します。

削除・復元は現行権限、全Path binding、依存参照、保持期限を確認します。バックアップ復元による過去権限復活には運用上の失効再適用が必要です。秘密を一般のWiki設計書やログへ複製しません。

外部ストレージ案

Document backendはStat/Open/ReadAt/PutIfAbsent/Verify/DeleteUnreferencedを持ち、SHA-256 identityを維持します。S3 key・ETag・URLをDocument identityとみなしません。multipart、短命URL、Range、GC、read-after-write確認を試験します。

WebDAV/SSHFSの可変ファイルとimmutable CASは別です。最初はread-only connector/import、マウントは専用sidecar等の運用責務としWeb要求でmountしません。SSH host key、outbound制限、secret管理が前提です。

ファイル監査

MWDB/Karton等の接続はpending/clean/suspicious/malicious/error/expiredの状態と、engine・版・hash・時刻・由来を持つ非同期処理を案とします。監査必須の範囲ではcleanがない間のviewer/download/adapterを閉じます。scannerへ機密本文を送る操作には別の送信方針が必要です。

DRとHAの順序

コントローラDRは署名manifest journal、鍵の保全、sequence、昇格epoch、旧leaderのfencingから設計します。記事DBとDocumentの複製は別の責務です。Campus manifestは記事バックアップではありません。

LB/HAにはsession失効共有、job lease、cache invalidation、uploadのnode非依存、WebSocket drain、proxy origin検証を要します。SQLiteをネットワーク共有して複数writerで動かす構成は採りません。fenced single-writer+replicaか、適切なmetadata backendを先に選びます。

RPO/RTOは目標値をユーザーと決め、復旧訓練の実測で保証範囲を定めます。現在の構成に無根拠な無停止・無損失を約束しません。