From 50b8b0323f496dc48e9c3196f8e837104f12a2e8 Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Sun, 1 Nov 2026 21:50:31 +0900 Subject: [PATCH] docs: record v0.4.0 CLI editing rollout [skip ci] --- docs/design/ja/remote-cli.md | 6 +- .../deployments/2026-11-01-v0.4.0.md | 82 +++++++++++++++++++ pages-cli/README.md | 4 +- 3 files changed, 88 insertions(+), 4 deletions(-) create mode 100644 docs/operations/deployments/2026-11-01-v0.4.0.md diff --git a/docs/design/ja/remote-cli.md b/docs/design/ja/remote-cli.md index d9530e7..4eaf5d1 100644 --- a/docs/design/ja/remote-cli.md +++ b/docs/design/ja/remote-cli.md @@ -2,7 +2,7 @@ 2026-11-01。合成データで検証済み。同日、本番サーバのCity更新と合わせてクライアントをホストの `/home/anya/.local/bin/pages` に配置した。実ユーザの資格情報取得・ログイン・本番Page編集は未実施。接続設定とログインは利用者が行う。[反映記録](../../operations/deployments/2026-11-01-city-pages-cli.md)。 -v0.3.0のOIDCログインは利用者の動作確認済み。後続変更として、OIDC承認時の追加ローカルTOTPを廃止し、CLIの `auto` 言語選択と既存Pageの新規言語版編集を実装した。この後続変更はソース段階であり、本番サーバー/PATH上のCLIには未反映。 +v0.3.0のOIDCログインは利用者の動作確認済み。v0.4.0ではOIDC承認時の追加ローカルTOTPを廃止し、CLIの `auto` 言語選択と既存Pageの新規言語版編集を実装した。2026-11-01 21:48 JSTに本番サーバー/PATH上のCLIへ反映済み。[v0.4.0反映記録](../../operations/deployments/2026-11-01-v0.4.0.md)。 ## 原設計との整合 @@ -169,7 +169,7 @@ OIDC無効の403と区別する。エラー時のログイン要求は自動再 同日の後続変更でも全Goテスト(キャッシュなし)、全Go vet、CLI関連store/serverのrace検査、 Python 22件、承認画面と既存CookieログインのChromium試験が成功した。 `TestRemoteCLILanguageForkRequiresWritePermission`で、有効なreadonlyセッションからの言語版作成が403になり、Revisionが残らないことも確認した。 -この後続変更は未リリース・未デプロイであり、上記v0.3.0の反映記録とは区別する。 +この後続変更はv0.4.0で配布し、同日21:48 JSTに本番へ反映した。実ユーザーの文書編集は行わず、利用者による操作確認に委ねる。 ソースのチェックポイント:`.deployment-backups/dev-cli-oidc-20261101/source-after.tar.gz` (SHA-256 `3e4228cd53b4220dffe43a80b4ed02c0bd757a8b3845829b7d3a77a64b0e9c4b`)。 @@ -181,5 +181,5 @@ OIDC関連18ファイルのみで、本番DB・鍵・セッション・前段の 1. Ctrl+Pによる検索選択、補完の引用文字/途中カーソル対応、永続履歴の明示opt-in。 2. 新規Page+Path+初回Revisionの原子的な作成API、create/upload-only権限、並行作成の衝突。既存Pageの言語分岐は実装済み。 3. 競合の対話選択・復旧コマンド、巨大転送のstreamingとキャンセル、mget/mput(globのlocal/remoteを明示)。 -4. OIDC引き継ぎの本番schema適用・サーバ/CLI配布と利用者確認はv0.3.0で完了。追加TOTP省略と言語編集改善の配布は未実施。schema v1の定義は変更しない。 +4. OIDC引き継ぎの本番schema適用・サーバ/CLI配布と利用者確認はv0.3.0で完了。追加TOTP省略と言語編集改善はv0.4.0で配布済み。schema v1の定義は変更しない。 5. OS keyring、Windows対応、非公開の短縮リンク引き継ぎ。自動的な公開shareは行わない。 diff --git a/docs/operations/deployments/2026-11-01-v0.4.0.md b/docs/operations/deployments/2026-11-01-v0.4.0.md new file mode 100644 index 0000000..de75f26 --- /dev/null +++ b/docs/operations/deployments/2026-11-01-v0.4.0.md @@ -0,0 +1,82 @@ +# 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バックアップの復元は切替後の書込みを失うため、自動で行わず別途承認を必要とする。 diff --git a/pages-cli/README.md b/pages-cli/README.md index 95ca0c3..d04c5b3 100644 --- a/pages-cli/README.md +++ b/pages-cli/README.md @@ -51,7 +51,7 @@ CLIに表示されたURLを手元のPC/スマホで開き、OIDCでログイ OIDCで認証した場合は、追加のローカルTOTPを要求しません。承認後はCLIが専用セッションを受け取ります。 OIDCプロバイダーのパスワードやトークンをターミナルに入力する必要はありません。 プロバイダー側のMFAポリシーはそのまま適用されます。パスワードログイン時のローカルTOTPも変更しません。 -この追加TOTP省略はv0.3.0より後の変更です。v0.3.0のサーバーでは従来どおりTOTPを要求します。 +この追加TOTP省略にはv0.4.0以降のサーバーが必要です。v0.3.0では従来どおりTOTPを要求します。 ユーザー名の指定は省略できます。指定済みならブラウザで認証したユーザーとの一致を確認し、 不一致時は発行セッションの失効を試みて保存しません。`pages logout` 後に設定を変更できます。 @@ -128,6 +128,8 @@ Tab補完、上下キーのプロセス内履歴に対応。複雑な引用位 ### 言語を指定して編集する +`auto` 言語選択と未作成言語版の編集は、v0.4.0以降のCLIで利用できます。 + ```sh pages edit /guide --lang auto # 表示される言語の最新版を編集 pages edit /guide --lang ja # 日本語版。未作成なら既存内容から開始