7.3 KiB
PagesWiki v0.6.0 のCardDAV本番反映とバックアップ整理
2026-11-02 09:04:17 JST、個人CardDAV、連絡先の履歴確認・復元、アドレス帳一括exportを本番2系統へ反映した。拡張機能は organizer.contacts 0.2.0。利用入口は /v/plan/contacts、CardDAVは /_/api/v1/carddav/。接続手順と限定対応範囲はCardDAV運用資料を参照する。
配布物
- ソースcommit:
19e12f96a840bdeba2b378644918e333d2e688fe。 - 注釈付きGitタグ:
v0.6.0。タグobject:93816c53d68449c7a604bbfed8c750362ed6a83e。 - ビルド run 23:再実行job 26でテスト・3イメージのビルド・push・後処理がすべて成功。
- リリース昇格 run 24:job 27が成功。ビルド済みのSHAタグを再ビルドせず昇格した。
- 後方互換なAPI・機能追加に対してSemVerのMINORを更新した。既存タグは変更していない。
registry prefixは git.anya.jp/anya/。本番のapp、app2、adaptor-gateway、excalidraw-viewerは同じソースrevisionで稼働する。code-server、Kroki、Mermaidは再作成していない。CLIソースの変更はなく、ホストCLIの置換もしていない。
| イメージ | v0.6.0 manifest digest |
|---|---|
| pageswiki-app | sha256:21eefdbe838433db9b6abb20cd8467861e4e87ca894c8db90cd9292d69d0f868 |
| pageswiki-adaptor-gateway | sha256:61ab1563ed1188ee710924d491670b148f7b9cb100ca74515fd94d270cb7a0af |
| pageswiki-excalidraw-viewer | sha256:e3a9fa82eee4f4f55a2eb271c142d2e069176b6acb3422899e9b6594d573b33c |
Git無視対象 .env.release は PAGESWIKI_IMAGE_TAG=v0.6.0。通常の .env とregistry overlayを併用し、up --no-build --no-deps で対象4サービスのみ更新した。ローカルlatest互換タグはv0.6.0へ揃えた。registryのlatestは変更していない。
バックアップの整理
ユーザーの削除指示を受け、次の旧世代だけを削除した。すべて .deployment-backups/ 直下の通常ディレクトリであることと、対象path・filesystemを確認してから削除した。
prod-ux-20261101/release-v0.2.0-20261101/release-v0.2.1-20261101/release-v0.3.0-20261101/
v0.4.0・v0.5.0切替前バックアップ、小規模な開発保全、rsync.log・rsync2.log、稼働データ、旧イメージは保持した。Docker全体のpruneは実行していない。
空き容量は作業開始時の約7.5 GBから、旧世代削除直後に約65 GBへ増加した。新しい復旧点とイメージを保管し、今回のリハーサル専用コピーを削除した後は約59 GBとなった。過去世代間で共有されるハードリンクがあるため、各ディレクトリの見かけの容量の合計と回収量は一致しない。
移行と保全
保全先は .deployment-backups/release-v0.6.0-20261102/。親ディレクトリは0700、保存した .env は0600。config/ に旧Compose、旧 .env.release、.env、旧ホストCLIを保持する。cutover/data と cutover/data2 が切替直前の整合バックアップである。
事前の読み取り専用チェックでは、本番2系統ともcontactsだけがv1からv2への更新待ちで、他の管理対象はcurrentだった。変更前のバックアップから独立したコピー2系統を作り、検証済みSHAイメージを --network none、DR設定の workers_enabled=false で起動した。両系統のhealthと管理対象12コンポーネントのschema checkが成功した。このコピーは本番に使用せず、検証コンテナ停止・削除後に破棄した。
本番切替前には、稼働イメージがv0.5.0であること、Composeと .env が保全時から変わっていないこと、新イメージのrevision、空き容量を確認した。
| 時刻 JST | 操作 |
|---|---|
| 09:03:41 | 対象4サービスの停止開始 |
| 09:04:11 | 停止確認後の最終バックアップ検証完了 |
| 09:04:17 | v0.6.0の再起動完了 |
停止開始から再起動完了までは約36秒。最終同期はチェックサム比較を使い、DB・WAL・SHM等のバイト一致、稼働ファイルと異なるinode、filesystem syncを確認した。変更のないファイルは過去の不変バックアップをrsyncのlink-destとして共有するが、本番ファイルとはハードリンク共有しない。in-place更新も使用しない。
旧v0.5.0イメージには各ローカルrepositoryで rollback-before-v0.6.0-20261102 を付けて保持した。切替直前バックアップ2系統に対する旧版の読み取り専用schema checkでは、contacts v1を含む管理対象12コンポーネントがcurrentだった。これは復旧起動全体の実地試験ではない。
本番はcontacts v2へ移行済みであり、旧イメージへの交換だけを安全なrollbackとは扱わない。復旧時は書込みを停止して切替後データも保全し、互換性・書込み損失を確認する。バックアップ復元を自動実行しない。CardDAVのDBを過去へ戻す復旧では、公開前のepoch更新とクライアント再照合も必要になる。
検証結果
- リリース前の全Goテストをローカルで再実行して成功。リリースツールのNodeテストも成功。
- Giteaの全テスト、3イメージのビルド・公開、リリース昇格が成功。
- 本番4サービスのソースrevision一致、再起動0回。healthcheckを持つappとExcalidrawはhealthy、app2もコンテナ内healthが200。
- 両本番DBはcontacts v2を含む管理対象12コンポーネントすべてcurrent。
- 公開HTTPSの
/healthとログイン入口は200。連絡先画面の匿名アクセスは303、CardDAVと連絡先の一覧・一括export APIは401、well-known discoveryは307。 - 公開HTTPSで配信されたcontacts.js、contact-history.js、task-dav-settings.js、contacts.css、dav-settings.cssのSHA-256がリリースソースと一致。
- 初期観察では4サービスのログにpanic、fatal、DB lock、job failed、scheduler claim failed、errorレベルの該当なし。
認証済みの実ユーザーで本番連絡先を作成・更新する試験は行っていない。CardDAVの往復同期とWeb操作は前段の合成データ試験で確認した。外部取り込みカレンダーの内容は開いておらず、保全は内容を解釈しないファイルコピーである。
CI再実行
初回job 25は既存の TestCityAutoPlanSameSpotNameInDifferentStreets で initialize SQLite connection: context deadline exceeded となった。configFixtureのDB接続初期化段階であり、Cityのassertionに入る前の失敗だった。
同じテストをローカルで20回反復して成功。同一commit・同一テスト条件のままCIを1回再実行し、job 26で全工程が成功した。テストの削除・スキップや、DBの期限延長はしていない。
v0.5.0のCIでも別テストのSQLite初期化時に同種の症状が出ている。後続のCI改善では、テスト一時領域のI/O計測、tmpfs利用の評価、パッケージ並列度、BuildKitキャッシュを検討する。このログだけでストレージを原因と断定しない。