Files

7.3 KiB
Raw Permalink Blame History

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キャッシュを検討する。このログだけでストレージを原因と断定しない。