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

6.2 KiB
Raw Blame History

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:初回で全工程成功。
  • リリース昇格 run 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 等は維持するため、必要に応じて変更する。

pages configure --lang auto
pages edit /対象のパス
# 一時指定、または明示的な言語版の作成
pages edit /対象のパス --lang auto
pages edit /対象のパス --lang en

auto は通常表示されるRevisionの言語を確定し、その言語の現在headを編集する。 明示言語のheadがない場合は既存内容を下書きとし、空のCAS基点で最初のRevisionを作成する。 元の言語版は変更せず、無変更終了では何も作らない。同時作成や更新は409で停止し、ローカル原稿を保持する。 新規Path/Page作成・自動翻訳は含まない。CLI設計を参照。

検証

  • 全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バックアップの復元は切替後の書込みを失うため、自動で行わず別途承認を必要とする。