Files
pages/docs/operations/deployments/2026-09-27-task-unification.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

54 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 本番反映:タスク所属統一と上書き同期
2026-09-27、`organizer.tasks 0.11.0`。[設計と次段階TODO](../../design/ja/task-dav-project-unification.md)。利用者が端末側の未送信変更を保全したことを確認し、本番反映の依頼を受けて実施。
## 反映対象
- app/app2のみ更新。他の連携アダプタ等は更新していない。
- 既定リストはプロジェクトなしに限定し、通常Webプロジェクトも個別のCalDAVリストとして公開。既存MKCALENDARリストのURLは維持。
- 条件なしPUT/DELETEはトークン別設定なしで受理。版履歴とDB transactionは維持。明示ETagの不一致は412。
- 競合通知・採否選択は未実装で、次段階TODO。
## ビルド・保全
- 旧image:`sha256:86dfde6d962227cf1e653e3ad5b955847a124f570079fb04a06ae0e5a8373ce5`
- 旧image保全tag:`pageswiki-app:rollback-before-task-unification-20260927`
- 新image:`sha256:2f0400639d6a6263292431bba160d2ede457743db6361c8b4ad677395eb5eaf1`
- 稼働中に`docker compose build app app2`を完了後、両appを停止。DBと存在するWAL/SHMを`.deployment-backups/20260927-task-unification/`のdata/data2へコピーし、`cmp`で一致を確認。ディレクトリ700、ファイル600。
- コピーサイズ5.8 GiB。正本全体のバックアップではなく、停止時DBの保全。今回の移行は索引・移行メタデータの変更であり、タスク本文・版を変更しない。
- `docker compose up -d --no-deps app app2`で反映。
- 作業後ディスク空き約24 GiB、使用率97%。旧image/過去backupは削除していない。容量整理は別途必要。
## 起動・確認
- app:2026-09-27 **12:18:23 JST**に新imageで起動。running、healthy、再起動0。
- app2:同日 **12:18:48 JST**に新imageで起動。running、再起動0(個別Docker healthcheckなし)。
- 公開`https://pages.anya.jp/health`、app2の正しいHostでのhealthは200。
- 未認証の共通CalDAV OPTIONS、新しいプロジェクトリストURI、app2のCalDAVは401。認証を迂回しない。
- 両コンテナの`internal/store/task_dav.go`、`internal/server/task_dav.go`、`internal/extensions/registry.go`のSHA-256はローカルと一致。
- 移行後のルーティング対応漏れ・不一致はいずれのDBも0。
本文を取得しない集計結果:
| 項目 | app 更新前 → 更新後 | app2 更新前 → 更新後 |
| --- | --- | --- |
| プロジェクト数 | 3 → 3 | 0 → 0 |
| CalDAVリスト対応数 | 1 → 3 | 0 → 0 |
| タスク数 | 5 → 5 | 0 → 0 |
| リビジョン数 | 25 → 25 | 0 → 0 |
| 旧hrefの移行記録数(更新後) | 4 | 0 |
外部取り込みカレンダー・本番タスクの本文や資格情報は取得せず、認証済みDAVを実データへ発行していない。書き込み動作は前段の隔離テストで検証済み。Tasks.org Desktop実機の再探索・同期は利用者確認待ち。
## 観測した警告・後続作業
主インスタンスで`event scheduler claim failed: database is locked`が確認時点で5件(03:18:47、03:19:47、03:20:47 UTCの観測)発生。副インスタンスでは未検出。ジョブ実行失敗・fatal・render errorは確認範囲で0。更新後に開始されたジョブの状態集計は主24件・副21件がsucceededで、処理停止は確認していない。**警告を解消したとは扱わない。**
TODO:`Store.ClaimDueEvent`のdeferred transactionでSELECT後にUPDATEする箇所の書き込み競合を調査する。writer取得・原子的claim・上限付きretryを比較し、二重claimしない隔離並行試験とともに別変更で是正する。今回の移行と因果関係があるとは断定しない。
## 再同期と切戻しの注意
端末でリストを再探索し、通常Webプロジェクトの新しいリストを同期対象へ追加する。既定リストPagesWiki Tasksは「プロジェクトなし」のみ。古いURLへの未送信書き込みで409 `task_collection_relocated`になった場合は、新しい所属リストを確認して保全済みの変更を反映する。アカウント削除やローカルデータ消去は行っていない。
旧版へ戻すと通常プロジェクトが既定リストへ再混在するため、緊急切戻しはまずタスク拡張を停止して判断する。旧DBコピーを無断で戻して反映後の新しい編集を消さない。