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

83 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# PagesWiki v0.4.0 のCLI言語編集と本番反映
2026-11-01 21:48:37 JST、CLIの言語自動選択・新規言語版編集と、OIDC承認時の追加ローカルTOTP省略を本番へ反映した。
ホストの `/home/anya/.local/bin/pages` も同じリリースへ更新した。接続設定と保存済みセッションは変更していない。
## 配布物
- ソースcommit:`93f4ecb8f4be8a798e22c4816663fc6754cc1951`。
- 注釈付きGitタグ:`v0.4.0`。タグobject:`2f7a20f6deeb80f3e998426aaf7d3f2546eba7d8`。
- [ビルド run 18](https://git.anya.jp/anya/wikipages/actions/runs/18):初回で全工程成功。
- [リリース昇格 run 19](https://git.anya.jp/anya/wikipages/actions/runs/19):全工程成功。
- 公開CLIの機能追加を含むため、SemVerのMINORを更新した。公開済みタグは変更していない。
対象はapp、app2、adaptor-gateway、excalidraw-viewer。code-server、Kroki、Mermaidは再作成していない。
registry prefixは `git.anya.jp/anya/`。SHAタグとリリースタグのmanifest digest・image IDが一致し、
OCI revisionはソースcommitと一致する。リリース昇格時の再ビルドはない。
| イメージ | v0.4.0 manifest digest |
| --- | --- |
| pageswiki-app | `sha256:d3c4fd22e1530bf85c1ec0451b731e57ede616a8f070922d517696957f3368ef` |
| pageswiki-adaptor-gateway | `sha256:08f796af86d60b851c80ad88acc1141d1240398f7b83697fe907e9b28b49bca1` |
| pageswiki-excalidraw-viewer | `sha256:adfdb46a4c4329366f1a66b918f3d5ba06b767723770b3f6e180566224193552` |
## 利用方法と互換性
OIDC経由のCLI承認では、ローカルTOTPが登録済みでも再入力を要求しない。
プロバイダー側の認証ポリシー、確認コード、明示承認、CSRF、PKCE、単回交換は維持する。
OIDC成功だけでMFA levelを加算せず、パスワードログイン時のローカルTOTP要件も変更しない。
新規CLIプロファイルの言語は `auto`。既存プロファイルの `und` 等は維持するため、必要に応じて変更する。
```sh
pages configure --lang auto
pages edit /対象のパス
# 一時指定、または明示的な言語版の作成
pages edit /対象のパス --lang auto
pages edit /対象のパス --lang en
```
`auto` は通常表示されるRevisionの言語を確定し、その言語の現在headを編集する。
明示言語のheadがない場合は既存内容を下書きとし、空のCAS基点で最初のRevisionを作成する。
元の言語版は変更せず、無変更終了では何も作らない。同時作成や更新は409で停止し、ローカル原稿を保持する。
新規Path/Page作成・自動翻訳は含まない。[CLI設計](../../design/ja/remote-cli.md)を参照。
## 検証
- 全Goテスト(キャッシュなし)、全Go vet、CLI関連store/serverのrace検査、Python単体22件が成功。
- 実HTTPハンドラと合成データで、auto編集、新規言語版、元言語保持、競合、失効、readonlyの書込拒否を確認。
- 模擬OIDC providerとローカルTOTP有効の合成アカウントで、追加TOTPなしの承認・交換を確認。
- Chromiumで1440px/390pxの承認画面と既存Cookieログインを確認。
- CIのテスト・3イメージのビルド・push・リリース昇格がすべて成功。
- 本番4サービスのrevision一致・再起動0回・health成功。公開HTTPSのhealth/ログインも200。
- 更新前後とも両インスタンスのmanaged schema 10コンポーネントがcurrent。今回のschema変更はない。
- イメージ内、リポジトリ、ホストPATH上のCLIが同じSHA-256。承認テンプレートに追加TOTP欄がないことも確認。
- 起動後の初期観察では、4サービスにpanic/fatal・DB lock・ジョブ失敗・errorログはなかった。
公開HTTPSでCLI開始→承認入口→未承認token交換の `authorization_pending` を確認した。
要求は1件だけ作成し、コード・verifier・device codeは表示/保存せず、セッションは発行していない。要求は5分で失効する。
実ユーザーの資格情報による最終承認・文書編集は行っていない。外部取り込みカレンダーの内容も開いていない。
## 保全と復旧
保全先は `.deployment-backups/release-v0.4.0-20261101/`、親ディレクトリは0700。
`config/` に旧Compose、`.env.release`、0600の `.env`、旧ホストCLIを保持した。
`cutover/data`・`cutover/data2` は21:48:21 JSTに最終同期を完了した停止時整合バックアップ。
21:47:30 JSTに停止を開始し、チェックサム比較による同期、DB関連ファイルのバイト一致、filesystem sync後に起動した。
対象4サービスの停止開始から再起動完了までは約67秒。
容量を抑えるため、前回バックアップの未変更ファイルだけをrsyncのlink-destで共有した。
本番データとのハードリンク共有はない。DBは別inodeであり、最終同期もin-place更新を使用していない。
バックアップ世代は不変として扱い、共有ファイルを直接編集しない。既存バックアップは削除していない。
切替後の空き容量は約14GB。世代の別媒体への退避・整理は後続の運用課題とする。
Git無視対象 `.env.release` は `PAGESWIKI_IMAGE_TAG=v0.4.0`。
通常の `.env` とregistry overlayを併用し、`up --no-build --no-deps` で対象4サービスだけを更新した。
ローカル3イメージのlatest互換タグもv0.4.0へ揃えた。registryのlatestは更新していない。
旧v0.3.0は各ローカルrepositoryの `rollback-before-v0.4.0-20261101` で保持した。
旧イメージの読み取り専用schema checkは、両退避DBで全コンポーネントcurrentとなった。
これはmanaged schemaの互換確認であり、復旧起動全体の実地試験ではない。
復旧時は進行中の編集・CLI承認を考慮し、書込みを停止して切替後データも保全したうえで、旧タグと旧CLIを使用する。
追加TOTP要件は旧版に戻る。DBバックアップの復元は切替後の書込みを失うため、自動で行わず別途承認を必要とする。