7.9 KiB
PagesWiki v0.5.0 のタスク管理と個人アドレス帳の本番反映
2026-11-01 23:15:44 JST、タスク作成API、作業時間記録、達成度レポート、日次メール設定、個人アドレス帳、トップ検索の作成コマンドを本番へ反映した。ホストの /home/anya/.local/bin/pages も更新した。既存CLIの接続設定と保存済みセッションは変更していない。
配布物
- ソースcommit:
8988e5a2f8436708a5a591ef126261629d662f32。 - 注釈付きGitタグ:
v0.5.0。タグobject:008b146b2f4fac75c76ad3e7606552e1ae12bc51。 - ビルド run 21:再実行のjob 23で全工程成功。
- リリース昇格 run 22:全工程成功。
- 公開API・CLIの追加機能に対し、SemVerのMINORを更新した。既存のリリースタグは変更していない。
対象はapp、app2、adaptor-gateway、excalidraw-viewer。code-server、Kroki、Mermaidは再作成していない。
registry prefixは git.anya.jp/anya/。SHAタグとリリースタグのimage ID・manifest digestが一致し、linux/amd64のOCI revisionも上記commitと一致する。リリース昇格時の再ビルドはない。
| イメージ | v0.5.0 manifest digest |
|---|---|
| pageswiki-app | sha256:6e326d06244878af1f5eb9a562893136a2c6b5414b53f8edd477334f07f092d6 |
| pageswiki-adaptor-gateway | sha256:097bd78daa97fd5d4de2aff1b58f93397176672421b4b1459a86408ab6f3e3f3 |
| pageswiki-excalidraw-viewer | sha256:d8bbd27d3ef15a5fc41e87786b6074116fbda98375cccce341693e716325fa29 |
イメージ内、リポジトリ、ホストPATH上のCLIのSHA-256は、いずれも d423d1a38cb931880e78e419188083592d9163cdd958ace86f58849d141c4f41。
利用開始と機能範囲
| 入口 | 内容 |
|---|---|
/v/plan/tasks/settings |
プロジェクト・担当者・見積・複雑度・各日付の既定値、日次メールの時刻設定 |
/v/plan/tasks/report |
日別の完了数・ポイントのヒートマップ、タスク別作業時間、Pomodoro時間 |
/v/plan/contacts |
本人専用アドレス帳、複数メール・電話、検索、削除・復元、vCard入出力 |
pages task |
作成・計画・完了、メールからの作成、作業開始・終了、レポート、設定 |
pages contacts |
検索、neomuttの宛先補完、vCard入出力 |
| トップ検索 | add task と add cal、プロジェクト・カレンダー候補、明示確認後の作成 |
日次メールは既定で無効。本人の有効化、本人のメール登録、管理者のSMTP設定が必要。導入作業では実メールを送信していない。担当者UUIDは計画上の注記であり、所有権移転・閲覧権限付与ではない。
連絡先は個人アドレス帳として実装した。共有アドレス帳、CardDAV提供・外部双方向同期は未実装。作業記録の事後修正、配信結果不明時の手動再送、連絡先の履歴復元UI等も後続範囲とする。詳細と制約は タスクと連絡先の設計、コマンド例は neomuttとタスクCLI を参照。
検証
- ローカルの全Goテスト、全Go vet、CLIのPython単体26件、検索コマンド解析テスト2件が成功。
- 最終版でタスク作成・作業記録・日次配信・予定作成・CLI実HTTP・連絡先のrace検査が成功。managed schemaの反復適用・readonly・旧完了タスクの移行も検査した。
- 合成データの実HTTPでCLIの作成、開始、終了、更新、完了、集計、連絡先入出力を検証した。SMTPは模擬サーバーで日本語本文・MIMEを検証した。
- Chromiumで新規5画面のデスクトップ/スマートフォン計10ケースと、既存タスク画面4サイズを検証した。最終のサブタスク既定値修正も両画面幅で再確認した。
- 本番4サービスが同じソースrevisionで稼働し、再起動回数は0。healthcheckを持つapp・Excalidrawはhealthy、appとapp2のローカルhealthは200、公開HTTPSのhealth・ログインは200。
- 本番の新規API4種は匿名要求を401・no-storeで拒否。設定・レポート・連絡先ページはログインへ303。新規・更新JS/CSS計8ファイルは公開HTTPSの内容とリリースソースのSHA-256が一致した。
- 両インスタンスのmanaged schemaはcontactsとtask-productivityを含む12コンポーネントすべてcurrent。起動後の初期観察では、4サービスにpanic/fatal・DB lock・ジョブ失敗・errorログはなかった。
本番の実ユーザー資格情報を使った新規タスク・連絡先の作成は行っていない。外部取り込みカレンダーの内容も開いていない。バックアップは内容を解釈しないファイル保全である。
CI再実行の経緯
初回のjob 22では、既存の TestSaveRevisionFreezesEmbeddedAssetHeads が db.Open の段階で initialize SQLite connection: context deadline exceeded となった(8秒)。アセット機能のassertionへ到達する前の失敗で、新機能を含むserverパッケージは成功していた。
同一テストをローカルで20回連続実行して成功。同一commit・同一テスト条件のまま全CIを再実行し、job 23では全テストとビルド・pushが成功した。テストの削除・スキップ、DB期限の緩和はしていない。
後続のCI改善では、SQLiteの初期化遅延を計測し、テスト用ストレージとパッケージ並列度、BuildKitの永続キャッシュを見直す。一時的なI/O競合は候補だが、このログだけで原因を断定しない。
保全と復旧
保全先は .deployment-backups/release-v0.5.0-20261101/、親ディレクトリは0700。
config/ に旧Compose、旧 .env.release、0600の .env、旧ホストCLIを保持した。
23:15:14 JSTに対象4サービスの停止を開始した。停止確認後に cutover/data と cutover/data2 をチェックサム比較で最終同期し、DB関連ファイルのバイト一致・別inode・filesystem syncを確認して、23:15:37 JSTにバックアップ検証を終えた。23:15:44 JSTに再起動が完了した。停止開始から再起動完了までは約30秒。
変更されていないファイルは前回の不変バックアップをrsyncのlink-destとして共有した。本番ファイルとのハードリンク共有やin-place更新は行っていない。DBは事前コピーせず、停止後に一度だけコピーして一時的な必要容量を抑えた。共有されたバックアップファイルを直接編集してはいけない。
旧v0.4.0イメージを、各ローカルrepositoryの rollback-before-v0.5.0-20261101 タグで保持した。旧版による読み取り専用schema checkでは、保全した両DBのmanaged schema 10コンポーネントがcurrent。これはschemaの検査であり、復旧起動全体の実地試験ではない。
今回の更新ではDBに新しいコンポーネントを追加している。旧イメージへの交換だけで安全に切り戻せるとは扱わない。復旧が必要な場合は書込みを停止し、切替後データも保全してから旧版との互換性を確認する。バックアップの復元は切替後の書込みを失うため、自動で実行しない。
Git無視対象 .env.release は PAGESWIKI_IMAGE_TAG=v0.5.0。通常の .env とregistry overlayを併用し、up --no-build --no-deps で対象4サービスだけを更新した。ローカルlatest互換タグはv0.5.0へ揃え、registryのlatestは変更していない。
切替後の空き容量は約7.3GB。既存バックアップ・旧イメージは削除していない。別媒体への保全確認と世代整理を、次の大容量操作より先に実施する。