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

5.1 KiB
Raw Blame History

本番反映:日別計画・親子タスク・Wikiメモ

実施日:2026-09-25 07:07 JST。organizer.tasks 0.7.0。

対象と反映内容

Compose app / app2(pageswiki / pageswiki-ext)へ反映。

  • 持ち越し・明日・任意の日付の計画、期限を変えない再割当て。
  • 親子順のcursorページング、フィルタ対象外の親の補足、別日付の子の展開。
  • 行内のWikiメモ閲覧・編集、プロジェクト配下への原子的な新規作成とUUID紐づけ。
  • 日別画面から作成するカレンダー時間枠の初期日付。
  • CSS v8、task-inline v3、tasks v6、task-planning v3。

アダプタゲートウェイ・code-server等の他サービスは再作成していない。

事前確認・テスト

稼働イメージとコードをハッシュ比較し、今回の差分がタスク関連バックエンド・UI・拡張バージョンであることを確認。go.mod、go.sum、Dockerfile、migrationは変更なし。

  • 全Goテスト成功。
  • Chromium fixture(1440/1024/390/320px)の実操作テスト成功。
  • 外部取り込みカレンダーへのアクセス、本番ユーザへの代理ログイン、本番タスク/メモのテスト作成は行っていない。

バックアップと反映

  • 旧イメージ:sha256:e5a7b7877f7c8f8701d0152468b4ee818f9fcb181509f7d223d2c00678c80925
  • 保全タグ:pageswiki-app:rollback-before-task-daily-notes-20260925
  • 新イメージ:sha256:911c5d4c425dd759bbdcb15b4a559e4160af09e1d92c7f604bbb057520c94acd

稼働中に新イメージをビルド。2アプリを停止後、data/data2を同一停止時点でtarへ保存した。

  • 保存先:.deployment-backups/20260925-task-daily-notes/
  • data-and-data2.tar:12,068,106,240 bytes、2,426 entries。
  • ディレクトリ700、アーカイブと保存したCompose設定等は600。
  • tar作成終了コード0、一覧読み取り終了コード0を確認。復元訓練は未実施。
  • 07:06:50 JSTバックアップ完了。バックアップ後のディスク空きは約60GB、使用率92%。既存バックアップの削除はしていない。

docker compose up -d --no-deps --wait --wait-timeout 180 app app2 により更新。appは07:07:02、app2は07:07:30 JST起動。停止を伴うデプロイであり無停止ではない。

反映後確認

  • 両アプリrunning、再起動回数0。appのDocker healthはhealthy、app2はhealthcheck未設定につきHTTPで確認。
  • ローカル3000/3001と本番HTTPSの /health は200、HTTPSトップページも200。
  • 未認証の今日・明日・持ち越し・日別画面は303、日別一覧APIとWikiメモAPIは401。
  • HTTPS配信のCSS・3つのJavaScriptが作業ツリーのSHA-256と一致。
  • 両コンテナの変更対象バックエンド・テンプレートのSHA-256も作業ツリーと一致。
  • 認証済みの編集・新規作成操作は合成fixtureで確認。本番では疎通・配信・アクセス制限を確認し、利用者データの変更を伴う試験はしていない。

スケジューラの要フォロー事項

app側で07:07:29および07:09:29 JSTに event scheduler claim failed: database is locked (SQLITE_BUSY) を確認。app2では同時区間の該当なし。07:09:55 JST時点では両側の通知配信ジョブが複数回succeededとなり、キュー処理の継続を確認。重大な初期化エラー・panic・renderエラー・失敗ジョブのログは確認区間で0。

今回 ClaimDueEvent 自体は変更していない。この処理はdeferred transactionでSELECT後にUPDATEする既存実装であり、並行writerとのロック競合対策を次の品質改善候補として残す。デプロイ作業に含めて未検証のスケジューラ改修や設定変更は行っていない。単発の起動時だけとは断定しない。

  • claim処理の競合を隔離fixtureで再現し、原子的claim/writer予約/限定retryを比較する。本文・外部カレンダーを参照せず、二重実行防止とforeground応答を検証する。

最終確認07:10:47 JST:2度目のロック以降もappで2件(最終07:10:29)、app2で3件(最終07:10:31)の通知配信ジョブが成功。HTTPS healthは200。ロックの再発対策は残件だが、スケジューラが停止した状態ではない。

切り戻しの注意

DBスキーマ変更はないが、プロジェクト正本へ notes_subpath が追加される。旧バイナリでプロジェクト設定を保存するとこの項目を落とすため、利用開始後はforward-fixを優先する。作成済みメモは通常のWiki Pageで、タスクのpage_uuid紐づけを利用する。

旧イメージは保全済み。データ復元は反映後の更新を失うため自動では実施しない。必要時は現状も保存し、全writer停止下でDBとDocument Storeを同じバックアップ時点へ戻すことについて確認を得る。

残確認:実機Safari/iPhoneでの入力・操作。バックアップ保持期間と空き容量の管理は別途検討する。