Files
pages/docs/operations/deployments/2026-11-01-v0.2.1.md
T

6.2 KiB
Raw Blame History

PagesWiki v0.2.1 のログ保存修正と本番反映

2026-11-01 20:00:00 JST、イベントログのSQLite書込競合を修正した v0.2.1 を本番へ反映した。 対象は app、app2、adaptor-gateway、excalidraw-viewer。code-server、Kroki、Mermaidは再作成していない。 別作業で進行中のCLI認証変更は含めず、イベントログ関連の9ファイルだけをリリースした。

リリース対象

  • ソースcommit:a36934e72cd68e4ce6ea27b944d00378ef316e8d。
  • 注釈付きGitタグ:v0.2.1。タグobject:1ab0aca388cb24fc52edf4d6ac8dfadec526f6a7。
  • ビルド run 14:全工程成功。
  • リリース昇格 run 15:全工程成功。
  • SemVerのPATCH更新。v0.2.0のタグ・配布物は変更していない。

AddEventLogContext が読み取り前に BEGIN IMMEDIATE で書込権を取得し、 rawログと集約bucketを同じtransactionで保存する。書込権取得の待機と再試行を有界にし、 取消後はrollbackと接続設定の復元を行う。開始・進捗・完了ログの保存失敗は秘密を含まない分類で診断する。 完了ログだけの失敗で、成功済みの業務処理を再実行しない。 契約と残件は Dregarnuhr を参照。

registry prefixは git.anya.jp/anya/。3種類ともSHAタグとリリースタグのmanifest digestが一致し、 OCI revisionラベルはソースcommitと一致した。タグ昇格時の再ビルドは行っていない。

イメージ v0.2.1 manifest digest
pageswiki-app sha256:8b789f8f28a987bcb6f5ba2828fb00222716cce251a5b159a5e0bf7adba2cf46
pageswiki-adaptor-gateway sha256:c7a288c6c01e1509d7e3dbbd22ded464747fc05d56ccb45410bed0ce8c1cd5b7
pageswiki-excalidraw-viewer sha256:c08569a0a8a170067952e0e427154882da0e076454deb130143ef57b821071c7

検証

未コミットのCLI認証変更を含まない独立ソースコピーで、次を確認した。

  • go test ./... -count=1:全件成功。
  • go test -race ./internal/store ./internal/server -run 'TestEvent(Log|Completion|Logging)' -count=3:成功。
  • go vet ./...:成功。
  • Gitea CIの全Goテストとリリースツール試験:成功。

整合バックアップの独立コピー2系統をCIイメージで起動した。 network none、CPU 2、メモリ2GiB、コピーだけのDR設定でworkersを無効化し、外部enroll引数を省略した。 両方とも設定済みポート3000でhealthが成功し、起動ログのerror・failed・panic・fatalは0件だった。 管理対象9コンポーネントのschema checkはすべてcurrent。DBスキーマ追加・データ変換はない。 検証コピーと検証コンテナは削除し、整合バックアップは保持した。

本番切替後も、4サービスのrevision一致・再起動0回、アプリ2台のhealth、 公開HTTPSのhealth・ログインの200、gateway・Excalidrawのhealth、 アプリ2台の管理対象9コンポーネントcurrentを確認した。 外部から取り込んだカレンダーの内容は開いていない。

ログ競合の観察

切替準備前のv0.2.0では、直近2分にappの開始ログ保存競合が7件発生し、ジョブ本体の失敗は0件だった。 切替後の確認は19:59:53 JSTを起点とし、composeログの失敗件数と、 読み取り専用DB接続によるジョブ状態・定型の開始/完了ログの件数だけを取得する。 payloadやイベント本文は出力しない。

19:59:53〜20:03:21 JSTの約3分28秒で、4サービスとも開始/進捗/完了ログ保存失敗、 SQLiteロック、ジョブ失敗、panic・fatalは0件だった。4サービスとも再起動0回を維持した。 この間に作成され完了したジョブはappで30件、app2で27件、すべてsucceededであり、 57件すべてに開始ログと完了ログが存在した。観察範囲では、修正前に発生していた開始ログの欠落は再現していない。

保全と起動設定

保全先は .deployment-backups/release-v0.2.1-20261101/。親ディレクトリは0700。

  • cutover/data・cutover/data2:19:59:53 JSTに確定した切替直前の整合コピー。
  • config/:切替前のCompose、.env.release、秘密値を含む .env。秘密設定は0600で保持し、Gitへ入れない。
  • アプリ2台とgatewayを停止し、最終差分約6.22GBを同期。DBバイト一致とfilesystem sync後に新版を起動した。
  • 未変更ファイルのhardlink共有はバックアップ間のみ。本番とのhardlink共有はない。既存バックアップは削除していない。
  • 検証コピー削除後・本番切替後のホスト空き容量は約28GB。バックアップ世代の整理は別途判断する。

Git無視対象 .env.release の PAGESWIKI_IMAGE_TAG を v0.2.1 に更新した。

docker compose --env-file .env --env-file .env.release \
  -f docker-compose.yml -f docker-compose.registry.yml \
  up -d --no-build --no-deps app app2 adaptor-gateway excalidraw-viewer

ローカル互換タグ pageswiki-app:latest、pageswiki-adaptor-gateway:latest、 pageswiki-excalidraw-viewer:latest もv0.2.1へ合わせた。registryのlatestは更新していない。

復旧点と後続監視

旧版v0.2.0は、上記3種類のローカルrepositoryの rollback-before-v0.2.1-20261101 タグで保持した。 v0.2.0のregistryタグも利用できる。このPATCH版にschema変更はないが、復旧前には切替後の状態と互換性を確認する。 イメージ切替とデータ復元は別操作であり、バックアップへデータを戻すと切替後の書込みが失われる。 データ復元は別途承認・保全の上で行う。schema履歴を削除してcheckを通す回避はしない。

長時間ロックやI/O障害で保存できなかったログの自動回収、業務完了状態とログの一体commit、 リース・HA・終了処理は後続課題として残る。短時間の本番観察は長期負荷試験の代替ではない。