Files
pages/docs/operations/deployments/2026-11-06-v0.8.0.md
T

3.3 KiB

PagesWiki v0.8.0 本番反映

2026-11-06 08:48:35 JST、本番のapp・app2・adaptor-gateway・excalidraw-viewerをv0.8.0へ更新した。このホストの /home/anya/.local/bin/pages も公開ELFのpages-cli v0.3.0へ更新した。機能・配布物はリリース記録を参照する。

保全と切替

.deployment-backups/release-v0.8.0-20261106/ に構成とデータを保全した。configには旧 .env、.env.release、Compose、旧CLIの pages-before-v0.3.0 がある。親ディレクトリ0700、構成コピー0600。data・data2は内容を解釈しないファイルコピーで、外部取り込みカレンダー要素にはアクセスしていない。

最終 cutover/data・cutover/data2 は対象サービス停止後にchecksum付きrsyncで確定し、差分ゼロ、DB・WAL・SHMのバイト一致と稼働元と異なるinodeを確認した。未変更ファイルは前回の不変バックアップとのみlink-destで共有する。稼働元へのハードリンクは作らない。既存バックアップは削除していない。

時刻 JST 操作
08:47:23 対象4サービス停止開始
08:48:29 最終バックアップ検証完了
08:48:35 v0.8.0起動完了

停止開始から起動完了まで72秒。リリースイメージとSHAイメージのID・source revision一致を確認してから、.env.release をv0.8.0へ変更し、registry overlayの up --no-build --no-deps で対象4サービスだけ更新した。旧v0.7.1イメージは rollback-before-v0.8.0-20261106 を付けて保持し、ローカルlatestを新リリースへ揃えた。registry latest、code-server、Kroki等は変更しない。

DBスキーマ変更はない。新イメージをネットワークなし・読み取り専用で起動するschema checkを切替前に両データ系統へ実施した。切戻し時は書込みを停止して現状も保全し、新CLIのWiki保存を停止する。旧版で個人設定を保存するとwiki_prefixが失われ得る。バックアップの自動復元は行っていない。

検証

  • 対象4コンテナのsource revisionは 80d297dab40871b42ff2afb2ab6212661c465248 と一致。起動正常、再起動0回。appとExcalidrawはhealthy、app2の内部healthも成功。
  • 両系統の管理対象12コンポーネントはcurrent。legacy領域を含む全データ完全性の検査ではない。
  • 公開HTTPSでhealth・ログインは200。匿名のタスク・個人設定は303、preferences API・CardDAVは401。
  • 公開tasks.js・task-productivity.js・tasks.cssのSHA-256がv0.8.0と一致。
  • 初期ログのpanic、fatal、DB lock、job failed、scheduler claim failed、errorレベルの一致件数は0。
  • ホストCLIは公開ELFとバイト一致し、versionは0.3.0、from-mailの新オプションも確認した。既存資格情報・セッション・NeoMutt設定は変更していない。

認証済みのメール取り込み・個人設定操作は一時DBと合成データで検証し、本番にテストメールやタスクを追加していない。利用者の既定Pathは自動設定せず、保存先のACLを確認したうえで本人が選択する。反映後の空き容量は約33 GiB。