Extract Grammaratur, Dregarnuhr, Geduldh, Mestionora, Ordoschnellic, Schutzaria, Kunstzeal and Seheweit behind compatible application contracts. Include accumulated editor resilience, navigation and theme UX, remote CLI, storage/schema and DR groundwork, tests and design/operations documentation. Verified: uncached full Go suite; go vet ./...; race tests for all eight components; 11 targeted Chromium tests; Node suites; 19 Python CLI tests; reproducible editor build. No push, release tag or deployment in this checkpoint.
6.9 KiB
2026-11-01:優先UXの本番反映
対象と復旧点
- 対象:Compose
app/app2。最新のUXに加え、作業ツリーにあった保存基盤・スキーマ管理・DR・エディタ復旧の変更を含む。 - 旧イメージ:
sha256:3ee1b6b5ff24154c05990f02f112db7052b5a9bfb9894e5e9020a55fbb539d8c。 - 旧版タグ:
pageswiki-app:rollback-before-ux-20261101。 - 初回候補:
pageswiki-app:ux-20261101、sha256:1efb6fa94ae447e4769fa1056eb88fd34274cd17264646ad22a13327e05567b7。隔離検証で旧索引との不一致を検出したため本番へは適用しない。 - 修正候補:
pageswiki-app:ux-20261101-fix1、sha256:1cae0988fdc2a9d008fe971ed7f92bff9e4831b1798d080e4551b9efeca31958。 - 停止時整合バックアップ:
.deployment-backups/prod-ux-20261101/before/{data,data2}。親ディレクトリ0700。アプリ2台を停止して全データをコピーし、DB本体の一致とsyncを確認。 - ソースの復旧点:
.deployment-backups/dev-priority-20261031/。Gitの未コミット変更は保持し、commit/push/tagは行わない。
実行基盤の障害と復旧
整合コピー後、旧コンテナの再開が failed to create TTRPC connection: unsupported protocol で失敗した。新コード起動・新migration適用の前に発生。
起動中のDocker 29.5.0 / containerd 2.2.3と、インストール済みDocker 29.8.2 / containerd-shim 2.3.6が不一致だった。実行中の /proc/.../exe は削除済み旧バイナリを参照していた。
このrootless Dockerの稼働コンテナがPagesWiki関連のみであることを確認し、systemctl --user restart docker で更新済み実行基盤へ切り替え、既存コンテナを再開。rootful Dockerやホスト全体の再起動は行っていない。旧アプリの起動中、一時的にapp2のenroll接続が拒否されたが、app起動後に回復した。
旧版復旧後、公開URLとlocalhostの3000/3001双方の /health が200、appのDocker healthがhealthyであることを確認した。
検証・反映の進捗
- 全Goテスト成功、候補イメージのビルド成功。
- 旧版・停止時の正本/DB/鍵を保全。
- バックアップのコピーを
--network none、workers無効で起動し、migration/backfillを検証。 - 管理対象8 componentがcurrent。双方のSQLite quick_check、メインDBのintegrity_check成功。本文backfillはメイン1,928件・外部側0件で完了。
- オブジェクト1,598/Revision1,928/Path1,093/Principal1件が移行前後で一致(外部側は各0件)。認証画面と新規静的アセットの応答を確認。
- 05:55 JST頃、停止時の追加バックアップ
cutover/{data,data2}を取得(beforeから変更のないファイルのみrsync --link-destで共有、ライブデータへのhardlinkではない)。DB一致とsync後、fix1をlatestに付け替え、app/app2のみ再作成。 - 両インスタンスのヘルス200、app healthy、公開HTTPSのヘルス200・ログイン200・匿名エディタ303。ホーム入力検索/ブラウザアドレスJSの公開URLとローカルのSHA-256一致。両DBのschema check成功。
- 切替直後の監視で両アプリの再起動回数0。外部カレンダーの内容は開かずに確認。継続監視では05:59:59 JSTにscheduler claimのSQLITE_BUSYを1件検出(下記)。
外部取り込み済みカレンダーの内容は検証対象にしない。リハーサル用データから外部同期・通知送信を行わない。
この反映に電話連絡先の後続開発は含めない。最終反映済みイメージはfix2に固定し、以後の作業ツリーと区別する。追加機能の本番反映は別途検証して行う。
スケジューラの継続検証
05:59:59 JSTに event scheduler claim failed: database is locked (5) が1件発生。以後の直近5分では38ジョブが成功しており、停止/ジョブ失敗ではなかった。旧版にもあった、deferred read transactionからwriteへの昇格競合を除去するため、ClaimDueEvent を UPDATE ... WHERE uuid=(SELECT ...) RETURNING ... の単一statementへ変更。優先度/実行可能時刻/attemptsを保持し、同時取得をSQLiteが直列化する。
8つの独立DBハンドル+並行する別書き込み、64ジョブの重複なし全件取得を10回検証。race検査も成功。新規schemaなし。fix1ベースに internal/store/event_jobs.go だけを差し替えた pageswiki-app:ux-20261101-fix2(sha256:aa4336dd677b27966df8732054a27b3544560c6fffb18b232e89d4f764b1551e)を構築。イメージ内の全Goテストと隔離データ2系統の起動・schema checkが成功。
fix2には電話連絡先/新規SQLite初期接続の後続変更は含まない。Dockerfile.scheduler はバックアップディレクトリに保存。切替前のオンラインSQLiteバックアップは before-scheduler/ に保管(DB単体であり、全正本の整合復旧点はcutover)。fix2→fix1は同一schema/データ契約のためイメージのみで戻せる。cutoverへの全データ復旧とは区別する。
06:06 JST頃、fix2をlatestとしてapp/app2を再作成。両方の実行イメージIDを照合し、公開HTTPS/localhost3001のヘルス200、app healthy、再起動回数0を確認。初回確認期間でpanic/job failed/database locked該当ログ0件。長期負荷検証を完了した意味ではなく、過長な別writerによるSQLITE_BUSYまで根絶したとの主張ではない。
後続開発ソースの保全先:.deployment-backups/dev-followup-20261101/source-after-contacts.tar.gz。全Goテスト、電話連絡先のChromium操作、初期接続の反復試験はローカルで実施。アプリケーションDBと外部取り込みカレンダーの実データを後続機能テストには使用しない。
リハーサルで修正した問題
旧DBの idx_event_jobs_due(status,run_at_ms,created_at_ms) が残るため、CREATE INDEX IF NOT EXISTS だけではpriority付き索引にならず、event-jobs/2 assertion 12 に失敗した。未リリースの採用migrationで、この非一意索引をtransaction内で一度再構築する。両本番バックアップに既存の schema_migration_steps がないことを確認し、適用履歴を削除する回避は行っていない。
TestEventJobsAdoptLegacyDueIndex で旧索引からの移行、再実行、job本文・status・attempts・時刻の保持を検証。変更後の全Goテストも成功。
ロールバック
データ形式の互換性を確認する前に旧イメージだけへ戻さない。書き込みを停止し、新版稼働後のデータも別途保全したうえで、切替直前のDB・正本・鍵と旧イメージの組み合わせへ復元する。ユーザの新規書き込みを無断で破棄しない。詳細は 保存基盤反映手順。