92 lines
6.2 KiB
Markdown
92 lines
6.2 KiB
Markdown
# 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](https://git.anya.jp/anya/wikipages/actions/runs/14):全工程成功。
|
||
- [リリース昇格 run 15](https://git.anya.jp/anya/wikipages/actions/runs/15):全工程成功。
|
||
- SemVerのPATCH更新。v0.2.0のタグ・配布物は変更していない。
|
||
|
||
`AddEventLogContext` が読み取り前に `BEGIN IMMEDIATE` で書込権を取得し、
|
||
rawログと集約bucketを同じtransactionで保存する。書込権取得の待機と再試行を有界にし、
|
||
取消後はrollbackと接続設定の復元を行う。開始・進捗・完了ログの保存失敗は秘密を含まない分類で診断する。
|
||
完了ログだけの失敗で、成功済みの業務処理を再実行しない。
|
||
契約と残件は [Dregarnuhr](../../design/ja/dregarnuhr.md#v020後の優先修正ログ保存競合) を参照。
|
||
|
||
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` に更新した。
|
||
|
||
```sh
|
||
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・終了処理は後続課題として残る。短時間の本番観察は長期負荷試験の代替ではない。
|