Files
pages/docs/operations/deployments/2026-09-26-chroncal-compatibility.md
T
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.5 KiB
Raw Blame History

本番修正:chroncalのタスクCalDAV互換性

2026-09-26 JST。organizer.tasks 0.8.1。01:00 JSTにapp/app2へ反映済み、事後確認完了。

原因

chroncal 0.10.0はaccount endpointの末尾slashを除去してprincipal探索する。 タスクhomeのslashなし経路はServeMuxの301に入り、Go HTTPクライアントがPROPFINDをGETへ変えて再送し、home GETが405になった。 前回の修正はslash付き経路の正規化循環のみを防ぎ、逆方向の301を防げていなかった。

修正

  • slashなしhomeも明示登録し、home/collectionをslash有無どちらでも直接処理する。返却hrefは従来canonical URIを維持。
  • chroncal/go-webdavのcalendar-data/comp(name=VCALENDAR)/allprop+allcompを全件取得として受理。部分選択・expand・time-range制約は従来通り拒否。
  • getlastmodifiedを返す。
  • chroncalは新規PUTでIf-None-Matchを送らないため、完全な新規identityへの無条件作成のみ許可。既存上書きとアーカイブ復活は無条件では不可。transaction内のhref/UID一意性、ETag/CAS、認可は維持。
  • sync-collectionは引き続き未対応。chroncalの405→calendar-queryフォールバックで同期する。差分対応の偽装はしない。

検証

  • chroncal 0.10.0実行ファイルで、探索・初回取得・作成・完了・Web側変更取得・削除→アーカイブ・無変更再同期を確認。
  • CLI試験は一時HOME/XDGディレクトリ・DB・fixture資格情報に限定し、ユーザーの既存chroncal設定やOS keyringを参照しない。
  • vdirsyncer/Todoman回帰、slash有無のPROPFIND、部分投影拒否、同時新規作成・無条件上書き拒否を検証。
  • 全Goテスト成功。git diff --check成功。
  • 本番ユーザーのタスクや外部カレンダー本文は取得しない。原因確認時の本番ログは探索メソッドとPathのみを参照。

反映

  • 対象:app / app2のみ。他のサービスは再作成しない。
  • 旧:sha256:02bb3d66973501804c6cbe3cd5b4ce7f644b148403eae98f88e5d9c837c667e3
  • 保全:pageswiki-app:rollback-before-chroncal-fix-20260926
  • 新:sha256:261e24eb1834454a9a47f70ee135269d465b3a4696048890afc492a332e32809
  • コードのみの修正。DBスキーマ・データ形式は0.8.0と同じ。直前の0.8.0反映時バックアップを保持し、追加フルバックアップやデータ復元は行わない。
  • 旧イメージへ切り戻すとchroncalの互換不具合は再発するが、0.8.0とのデータ互換性は変わらない。

事後確認

  • appは01:00:32 JST、app2は01:00:57 JSTに新イメージで起動。両方running、再起動回数0。appのDocker healthはhealthy、独立healthcheckのないapp2は正しいHostで/healthの200を確認。
  • 公開HTTPSでtask home/default collectionそれぞれslash有無のPROPFINDが、リダイレクトなしの401を返すことを確認。認証前の応答として正常であり、実アカウントの内容は取得していない。
  • app2もHost: wiki.extpages.anya.jpでslashなしhomeのPROPFINDが401、リダイレクトなし。
  • 起動後の確認時点では、両コンテナともfatal/DB locked/event job failed/render errorのログ件数は0。過去の障害全般の解消を意味するものではない。
  • 認証付きの探索と変更操作は前述の隔離fixtureで検証。本番資格情報の再発行やクライアント設定の削除は不要。