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

5.0 KiB
Raw Permalink Blame History

本番反映:タスクCalDAV/CLI連携

実施日:2026-09-26 JST。organizer.tasks 0.8.0。 状態:2026-09-26 00:24 JST、本番反映完了。

対象

Compose app / app2(pageswiki / pageswiki-ext)。 タスク専用VTODOコレクション、専用資格情報UI/API、条件付き更新・アーカイブ同期。 アダプタなど他サービスの再作成は行わない。

事前確認

  • 稼働中イメージのソース・静的ファイル・テンプレートとローカルをSHA-256比較。差分は今回のタスクCalDAV関連15ファイルのみ。go.mod、go.sum、Dockerfile変更なし。
  • 全Goテスト成功。最初の実行はサンドボックスのlisten制限で中断し、権限を切り替えた再実行で成功。
  • vdirsyncer/Todomanの実CLI同期試験、Chromiumの1440/1024/390/320px試験を隔離fixtureで再実行し成功。
  • 本番ユーザーの代理ログイン、タスク作成、外部取り込みカレンダーの内容参照は実施しない。

イメージとバックアップ

  • 旧イメージ:sha256:911c5d4c425dd759bbdcb15b4a559e4160af09e1d92c7f604bbb057520c94acd
  • 旧イメージ保全タグ:pageswiki-app:rollback-before-task-caldav-20260926
  • 最終イメージ:sha256:02bb3d66973501804c6cbe3cd5b4ce7f644b148403eae98f88e5d9c837c667e3
  • 初回反映イメージ(下記修正前):sha256:0e838cfcf410b1d5dcdff9b8985b301be3e6478ba0c434c18d4b7cb6a9c5cc39
  • 停止時バックアップ:.deployment-backups/20260926-task-caldav/data-and-data2.tar
  • 保存ディレクトリ700、tarと設定コピー600。バックアップ失敗時は旧コンテナを再起動する手順。
  • 00:20:29 JSTバックアップ完了。12,081,100,800 bytes、2,426 entries。tar作成と一覧読み取りの終了コード0。復元訓練は未実施。
  • バックアップ後の空き約49GB、使用率93%。既存バックアップは削除していない。保持期間・容量管理は残課題。

本番確認で発見・修正した問題

初回起動後、共通NormalizePathがCalDAV collectionの末尾スラッシュを除去し、ServeMuxが付け直す301循環を確認した。初回CLI fixtureは認証とmuxのみを通っており、この共通middlewareを検証できていなかった。

/_/api/v1/caldav/配下では末尾スラッシュを保持するよう修正。通常Wiki Pathの正規化は変更しない。GET/OPTIONS/PROPFIND/REPORTの回帰テストを追加し、実CLI試験も本番と同じServer.handler()全体を通す方式へ変更した。これにより既存予定CalDAVのcollectionも循環しなくなる。

修正後、全Goテストと実CLI試験を再実行して成功。再ビルド・再反映し、appは00:23:42、app2は00:24:09 JSTに起動。コードのみの再反映でデータ復元は行っていない。

切り戻しの注意

起動時にorganizer_dav_resourcesとorganizer_dav_credentialsを追加し、既存タスクのDAV索引を登録する。 CLI由来の同期ID・リソース名・ICSメタデータは正本TaskRecordのcaldavに保存する。 旧バイナリで新形式のタスクを更新するとこのフィールドが失われうるため、利用開始後はforward-fixを優先する。 緊急時はまずorganizer.tasks無効化で当該機能を停止する。旧イメージへの切り戻し時はこの互換性制約を考慮する。 DBとCASを復元する場合は反映後の更新が失われるため、自動復元せず、現状の追加バックアップと確認を経て全writer停止下で行う。

事後確認

  • 両インスタンスが最終イメージでrunning、再起動回数0。appはDocker healthがhealthy。app2には独立healthcheckがないためHTTPで確認。
  • ローカル3000/3001とhttps://pages.anya.jp/healthは200。
  • 本番HTTPSのタスクDAV home/collectionは未認証401。PROPFINDも401、WWW-Authenticate: Basic realm="PagesWiki task CalDAV", charset="UTF-8"。循環リダイレクト解消。
  • 資格情報管理APIは未認証401、タスク画面はログインへの303。
  • 新JSとCSSのHTTPS配信SHA-256はローカルと一致。両コンテナのDAVコード・テンプレート・正規化修正も一致。
  • 両DBはread-onlyでsqlite_masterのみを調べ、追加する2テーブルの存在を確認。外部カレンダー内容は参照していない。
  • app2にHost: pages.anya.jpを渡した際の404は配置外ホストのため。実際の配置先wiki.extpages.anya.jpではhealth 200、DAVと資格情報API 401、タスク画面303を確認。
  • 00:25:10 JST時点の再起動後ログ集計では、両側ともfatal/panic、DB locked、失敗ジョブ、renderエラーは0件。これは当該観測区間の結果で、過去に記録したスケジューラの競合課題を解決したという意味ではない。
  • 本番のユーザー代理ログインや資格情報発行、タスク変更は行わない。認証後の操作は隔離した本番同等handlerの実CLI fixtureで確認。