docs: record v0.14.1 production deployment [skip ci]
This commit is contained in:
1 parent
4049acf76e
commit
84d52390f9
2 files changed
+78
-1
No files matched your search
@@ -0,0 +1,77 @@
|
||||
# PagesWiki v0.14.1とpages-cli v0.4.2
|
||||
|
||||
削除済みタスクの受付記録が残り、変更した下書きの再送で412になっていた問題を修正します。
|
||||
削除済みなら410、受付記録に対応するタスクと削除記録が両方欠落していれば409 `capture_missing` で停止します。
|
||||
存続中のタスクを異内容のcaptureで上書きすることは許可しません。
|
||||
|
||||
2026-11-08 19:42:51 JSTに本番配備後の確認を完了しました。
|
||||
DBスキーマ変更・既存データの削除・実タスクの再取り込みは行っていません。
|
||||
Gecko等の未コミット変更は含みません。
|
||||
|
||||
## 再取り込み
|
||||
|
||||
サーバーをv0.14.1、利用するCLIをv0.4.2に更新してから実行します。
|
||||
別インスタンスへ接続している場合は、その接続先サーバーの更新も必要です。
|
||||
|
||||
```sh
|
||||
pages --version
|
||||
pages task retry REQUEST_UUID --recreate-deleted
|
||||
```
|
||||
|
||||
保持した下書きから、新UUIDのタスクを作成します。旧UUIDの削除記録とDAV識別子予約を残し、
|
||||
通常の再送で古いタスクが復活するのを防ぎます。再取り込み用IDは決定的で、応答消失や並行再送でも重複作成しません。
|
||||
既存Wikiが保存先にあれば本文・リビジョンは変更せず、新タスクから関連付けます。
|
||||
ページがなければ保留本文から作ります。移動済みページの自動探索や旧作業記録の復元ではありません。
|
||||
|
||||
通信失敗時はCLIが表示する新IDで `pages task retry NEW_REQUEST_UUID` を実行します。
|
||||
セッションファイルや受付記録を手動で消さないでください。
|
||||
詳細は[実装契約](../../design/ja/tasks-implementation.md#削除済みメール取り込みの再作成)と
|
||||
[CLIのNeoMutt手順](https://git.anya.jp/anya/pages-cli/src/tag/v0.4.2/docs/neomutt.md)を参照してください。
|
||||
|
||||
## リリースと検証
|
||||
|
||||
| 対象 | タグ | commit | CI |
|
||||
| --- | --- | --- | --- |
|
||||
| PagesWiki | [v0.14.1](https://git.anya.jp/anya/pages/releases/tag/v0.14.1) | `4049acf76e36c12b8f3c506de5eaf1e920ac7e86` | [build 72](https://git.anya.jp/anya/pages/actions/runs/72)、[release 75](https://git.anya.jp/anya/pages/actions/runs/75) success |
|
||||
| pages-cli | [v0.4.2](https://git.anya.jp/anya/pages-cli/releases/tag/v0.4.2) | `e27c023d66a61b73d3fe47e982daa6f34213c41f` | [build 73](https://git.anya.jp/anya/pages-cli/actions/runs/73)、[release 74](https://git.anya.jp/anya/pages-cli/actions/runs/74) success |
|
||||
|
||||
- 正確なリリースソースで `go test ./...`。server/storeのgo vet、削除・再取り込み・並行再送のrace検査が成功。
|
||||
- CLIの52単体テスト、サーバーとCLIのHTTP結合テストが成功。Wiki本文・版の保全、他所有者拒否、readonly、kill switch、入力上限、保存途中のロールバックを検証。
|
||||
- 公開されたCLIの4配布ファイルをSHA256SUMSで照合し、Pythonソースとcommitを照合。
|
||||
- 配布Linux ELFでバージョン、メール取り込み、下書き差し替え、削除済み再取り込み、認証・ファイル権限のスモークテストとTLS関連6テストが成功。
|
||||
- Linux ELFはglibc 2.36以降。macOS/Windowsの未検証バイナリは配布していません。
|
||||
|
||||
## 本番切り替えと復旧点
|
||||
|
||||
app・app2・adaptor-gateway・excalidraw-viewerを同じv0.14.1へ更新しました。
|
||||
`.env.release` の選択は `PAGESWIKI_IMAGE_TAG=v0.14.1` です。
|
||||
|
||||
- 19:40:36 JSTに停止開始。
|
||||
- 19:42:17 JSTに、停止時点のdata/data2についてchecksum同期、再走査の差分ゼロ、DBファイル一致を確認。
|
||||
- 19:42:23 JSTに新版の起動と両アプリのhealth応答を確認。
|
||||
- 設定と停止時データは `.deployment-backups/release-v0.14.1-20261108/` の `config/` と `cutover/data`、`cutover/data2` に保存。DBのinodeは稼働元と独立しています。
|
||||
- 旧3イメージを `rollback-before-v0.14.1-20261108` タグで保持。旧バックアップも残しています。
|
||||
|
||||
v0.14.0への切り戻しはイメージ選択のみで行い、DBを過去へ戻しません。
|
||||
その場合は再取り込みAPIが利用できなくなるため、CLIの再取り込み操作を止めてください。
|
||||
v0.14.0より前への切り戻しは削除記録の扱いが異なり、[v0.14.0の注意点](2026-11-08-task-deletion.md#dbと切り戻し)が引き続き適用されます。
|
||||
|
||||
## 配備後確認
|
||||
|
||||
- 4サービスのrevisionが対象commitと一致、running、再起動回数0。
|
||||
- app/app2のhealth正常。管理対象13スキーマはcurrent。これはlegacy領域を含む全移行検証ではありませんが、今回の変更にスキーマ移行はありません。
|
||||
- 両DBの `quick_check` はok。
|
||||
- 外部HTTPSのhealth・ログイン画面200。匿名のタスク/ダッシュボード/RSS画面303、タスクAPI401。匿名DELETEとcapture POSTも401。
|
||||
- tasks.js、tasks.css、organizer-dashboard.js、feeds.js、feed-gecko.jsのSHA-256がリリースcommitと一致。
|
||||
- 起動直後のfatal/panic、DB lock、schema/migration failure、event job failureは両アプリとも0件。
|
||||
- 実際のメール本文・利用者の保留下書きを使った再取り込みは実施していません。
|
||||
|
||||
## 配布イメージ
|
||||
|
||||
SHAタグから再ビルドせず昇格。本番で取得したdigestとCI結果は一致しています。
|
||||
|
||||
| イメージ(`git.anya.jp/anya/`、タグ`v0.14.1`) | manifest digest |
|
||||
| --- | --- |
|
||||
| pageswiki-app | `sha256:11488fb958db12ec5a25aa265fc8179a31ab5728800f47605759822a44eb81e6` |
|
||||
| pageswiki-adaptor-gateway | `sha256:ca17704eb5e88a4e73827ff2a5fafda7c4bb7d9be3987b5a83a3a5ae0c780098` |
|
||||
| pageswiki-excalidraw-viewer | `sha256:a2b692c3864b8c4f13412e746fcea7cd9a2c03d49e0d5ead252432f37930c4c4` |
|
||||
Reference in new issue
Block a user