Files

5.7 KiB
Raw Permalink Blame History

PagesWiki v0.7.0 のオーガナイザー本番反映

2026-11-04 00:23:30 JST、オーガナイザーの共通ナビゲーション、個人設定、ウィジェット形式のダッシュボードを本番2系統へ反映した。ダッシュボードは /v/plan/dashboard、個人設定は /-/sys/config?panel=organizer、連絡先は /v/plan/contacts。仕様と後続範囲は設計書を参照する。

配布物

  • ソースcommit:6ba30bc9f4ae4a8b53b909ebe6597eb8f52fa0ef。
  • 注釈付きGitタグ:v0.7.0。タグobject:25f59e33bf90699426e9515fc62efa262268385d。
  • ビルド run 25:job 28でテスト、3イメージのビルド・pushが成功。
  • リリース run 26:job 29で既存SHAイメージの昇格が成功。再ビルドしていない。
  • 後方互換な機能追加としてSemVerのMINORを更新。既存リリースタグは変更していない。

registry prefixは git.anya.jp/anya/。

イメージ v0.7.0 manifest digest
pageswiki-app sha256:30ebc4e568087d791f7381313a93b963e18c81b7f51a93923b3d874c8a1b90b8
pageswiki-adaptor-gateway sha256:0373dd70c0c8097ccccd61302c83b48502e47a8fd256335bb44297afd6ac6eca
pageswiki-excalidraw-viewer sha256:381f31eb6754743ee8116b11230f522e0c726345cdb12f4f21f050fb13b64105

.env.release を PAGESWIKI_IMAGE_TAG=v0.7.0 に更新し、通常の .env とregistry overlayを併用して up --no-build --no-deps でapp、app2、adaptor-gateway、excalidraw-viewerのみ再作成した。ローカルlatest互換タグも同版へ揃えた。registryのlatest、code-server、Kroki、Mermaid、ホストCLIは変更していない。

移行とバックアップ

今回の管理対象スキーマ変更は task-productivity v1からv2への更新で、個人別配置を保存する organizer_dashboard_layouts を追加する。他の管理対象コンポーネントは変更なし。

独立した旧バックアップのコピー2系統を、実際のリリースイメージで起動した。ネットワークは none、DR設定は workers_enabled=false とし、外部連携とバックグラウンド処理を無効化した。両系統のhealthと管理対象12コンポーネントのschema checkが成功した。リハーサル専用コピーとコンテナは検証後に削除した。

保全先は .deployment-backups/release-v0.7.0-20261104/。親ディレクトリは0700、保存した .env は0600。config/ に旧Compose、.env、旧 .env.release を保存し、cutover/data と cutover/data2 に停止時点の整合バックアップを保持する。

時刻 JST 操作
00:22:08 対象4サービスの停止開始
00:23:23 停止後の最終バックアップ検証完了
00:23:30 v0.7.0の再起動完了

停止開始から再起動完了まで82秒。停止後にチェックサム付きrsyncで最終同期し、差分ゼロ、DB・WAL・SHM等のバイト一致、本番ファイルとは異なるinode、filesystem syncを確認した。変更のないファイルは過去の不変バックアップをlink-destとして共有するが、本番ファイルとはハードリンク共有しない。

旧v0.6.0の3イメージをローカルタグ rollback-before-v0.7.0-20261104 で保持した。切替直前バックアップ2系統に旧v0.6.0を用いた読み取り専用schema checkを実行し、task-productivity v1を含め管理対象12コンポーネントがcurrentだった。旧世代バックアップとイメージは削除していない。今回の一時リハーサルコピー削除後の空き容量は約46 GiB。

本番はtask-productivity v2に移行済みのため、旧イメージへの交換だけを安全なrollbackとは扱わない。復旧時は書込みを止め、切替後データも別途保全し、互換性と書込み損失を確認する。バックアップ復元は自動実行しない。CardDAVデータも過去へ戻す場合は、公開前のepoch更新とクライアント再照合が必要となる。

検証結果

  • ローカルの go test ./...、go vet ./...、リリースツールのNodeテスト8件、git diff --check が成功。
  • TestProductivityChromium のデスクトップ・スマホの10ケースが成功。合成データによる配置保存、実ポインターによるドラッグ・リサイズ等を確認。
  • Giteaの全Goテスト、3イメージのビルド・公開、リリース昇格が成功。
  • 本番4サービスのソースrevision一致、再起動0回。appとExcalidrawはhealthy、app2も内部healthが成功。
  • 本番2系統の管理対象12コンポーネントはすべてcurrent。schema checkの対象外であるlegacy領域の完全性検査を意味するものではない。
  • 公開HTTPSのhealthとログイン画面は200。ダッシュボードと個人設定の匿名アクセスは303、dashboard・progress APIとCardDAV入口は401。
  • 公開HTTPSのorganizer-dashboard.js、organizer-settings.js、task-productivity.js、contacts.js、tasks.js、calendar.js、organizer.css、home.cssのSHA-256がソースと一致。
  • 切替直後の対象4サービスのログでは、panic、fatal、DB lock、job failed、scheduler claim failed、errorレベルの該当件数は0。

本番の実ユーザーデータを作成・更新するUI試験は行っていない。認証済み操作は合成データのブラウザ・API試験で検証した。外部から取り込んだカレンダー要素にはアクセスしていない。バックアップは内容を解釈しないファイルコピーとして実施した。