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

4.2 KiB
Raw Blame History

本番反映記録:タスク・時間枠・Pomodoro・Today

実施日:2026-09-25 JST(コンテナ起動時刻は2026-09-24 UTC)。

対象と結果

  • Composeサービス app / app2(pageswiki / pageswiki-ext)を更新。
  • アダプタゲートウェイ、code-server、Excalidraw、Kroki関連は再起動していない。
  • 旧イメージ:sha256:69d66a1501f88b57f8b570dad488fef2bae3e3a3183b1e5ef9b5faa69c0b54b7
  • 新イメージ:sha256:2bfab91fe4f8712a25b8e5a6cdb1494b68ccdd9433609b35ce25ae391b98bfe6
  • 旧イメージ保全タグ:pageswiki-app:rollback-before-task-today-20260925
  • app起動:04:36:10 JST、app2起動:04:36:37 JST。両コンテナの再起動回数0。

保全と手順

切り替え前に go test ./... が成功。旧イメージをタグで保全し、稼働中に docker compose build app を完了。

切り替え時に両アプリを停止してから、dataとdata2を一緒に非圧縮tarへ保存した。DB・WAL・Document Store・その他のファイルを停止中の状態で保全し、予定の内容を調査したり外部カレンダーへ手動接続したりしていない。

  • 保存先:プロジェクト直下 .deployment-backups/20260925-task-today/
  • データ:data-and-data2.tar(12,066,856,960 bytes)
  • ディレクトリ権限700、アーカイブ権限600。
  • Compose設定、Dockerfile、.dockerignoreも同じ保護ディレクトリに保存。設定の秘密を本書へ転記しない。
  • バックアップをGitとDockerビルドの対象から除外した。
  • tar終了コード正常、アーカイブ一覧を読み取れることを確認(2408 entries)。完全なリストア訓練やDB全件の整合性検査は今回実施していない。

保存後、docker compose up -d --no-deps --wait --wait-timeout 180 app app2 で更新。停止を伴う反映であり、無停止デプロイではない。

本番で確認した項目

  • ローカル3000/3001両方の /health:200。
  • https://pages.anya.jp/health と /:200。
  • 匿名の /v/plan/today:303。匿名のToday API:401。認証を迂回しない。
  • HTTPSで取得した task-today.js?v=1 のSHA-256が作業ツリーのファイルと一致。
  • 両DBで organizer_time_blocks / organizer_focus / organizer_focus_spans、時間枠のtitle列を確認。
  • タスク通知・focus終了イベントの登録を確認(既定60秒)。
  • 両インスタンスで task.activity.publish / task.focus.complete / task.reminders.deliver が反映後に各3回成功していることを、ジョブ状態だけで確認。

本番で新規のタスク・予定・集中セッションを作成する書き込み試験や、利用者へのなりすましログインは実施していない。認証済みの操作・PC/モバイル表示は、反映前の隔離Chromiumテストで確認済み。

観測した注意事項

メインのイベント取得処理で、04:36:36 JSTにSQLite 517、04:37:36 JSTにSQLITE_BUSYが記録された。スケジューラは次回処理で継続し、04:38台に上記タスクジョブが成功。04:38以降の確認区間ではclaimエラー再発・起動失敗・panicはなし。恒久的に再発しないことを保証する確認ではない。

  • 後続品質改善:ClaimDueEventのread→write昇格時の競合、busy時の限定リトライ、claim待ち時間と失敗率を検証する。今回のデプロイ中にスケジューラの実装や運用設定は変更していない。

切り戻しの判断材料

旧イメージと停止時点のデータを保持している。必要時はまず新しい書き込みの有無と旧版のスキーマ/イベント互換性を確認し、切り戻し手順を選ぶ。旧タグを pageswiki-app に戻して対象2サービスだけを再作成する方法があるが、今回リハーサルしたものではない。

データの復元は切り替え以降の更新を失うため、自動実施しない。必要な場合は現状態も保全し、利用者の確認を得て、全writer停止下でDBとDocument Storeを一緒に扱う。バックアップの削除・自動期限設定も今回行っていない。