Files
pages/docs/operations/deployments/2026-11-01-city-pages-cli.md
Anya Tokugawa d5d21b7841
Build and publish container images / images (push) Successful in 9m34s
Release container images / release (push) Successful in 36s
Refactor architecture into eight components and consolidate reliability work
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.
2026-11-01 15:23:31 +09:00

4.7 KiB
Raw Permalink Blame History

2026-11-01:City閲覧導線とpages-cliの反映

反映対象

2026-11-01 12:39 JST頃、Compose app / app2 を切り替えた。連携アダプタは再作成していない。

  • City検索結果とサジェストから、設定画面ではなく対応Pageまたは配下のブラウザ一覧へ遷移。
  • 生成された未整理Spotの既定名を親Streetの表示名へ射影。内部名・UUID・Path境界と独自タイトルは維持。
  • 親階層を含む閲覧権限の確認、匿名表示名の再計算、検索画面のモバイル幅調整。
  • pages-cli ソースをイメージの /src/pages-cli/ に収録。CLIはホストの /home/anya/.local/bin/pages に配置。

直前のcommand版をベースに選択した31ファイルのみをCOPYしてビルドした。作業ツリー全体は含めない。電話連絡先、SQLite初期接続の後続変更は引き続き未反映。DBスキーマ・正本形式・認証設定の変更はない。

イメージ・復旧点

  • 反映版:pageswiki-app:city-pages-cli-20261101
  • ID:sha256:bed6b2d3e497e72c26feba4edf225fd9c57d49546fec43db2f88f297fcd989ee
  • 直前版:pageswiki-app:rollback-before-city-pages-cli-20261101
  • 直前版ID:sha256:d6c059486c238a1af0c9ebb2b2f3ed51c005a9670a703c55c077ef5a56ca1ec2
  • 限定ビルドレシピと配布ソース:.deployment-backups/prod-city-pages-cli-20261101/{Dockerfile,overlay/}
  • 同ディレクトリの reference/ は直前イメージのソース、verify/ は反映対象を合成したテスト用ソース。どちらも本番データではない。
  • 既存の停止時整合バックアップは保持。今回はデータ契約が不変のため、新たな全データコピーは取得していない。

pageswiki-app:latest を反映版へ変更。Git commit/push、レジストリpush、バージョンタグ追加は行っていない。

検証

  • 限定ソースと候補イメージそれぞれで go test ./... -count=1 成功。イメージの試験はネットワーク無効、CPU 2、メモリ2GiB。
  • Python単体テスト12件成功。ホストの限定ソースで TestRemoteCLIHTTPIntegration の実行・成功を個別に確認。ログイン/既定設定/一覧/編集/競合拒否/ログアウトを合成データで検証。イメージ内にPythonは追加しておらず、イメージ内の同テストはskipする。
  • 限定ソースのCity系・検索結果・コマンドバー/ハイライトのChromium試験成功。検索結果は1440px/390pxを検査。
  • 既存バックアップのリハーサル専用コピー2系統を、ネットワーク無効・workers無効で起動。healthおよび管理対象8コンポーネントのschema check成功。リハーサルコンテナは切替前に削除。
  • 本番2台のイメージID一致、両方running/再起動回数0、app healthy。
  • localhost3000/3001と公開HTTPSのhealth、公開ログインが200。
  • 公開HTTPSのCity関連JS3ファイルと検索CSSのSHA-256が配布元と一致。
  • 本番2台の管理対象schema check成功。切替直後のログでpanic/fatal/job failed/database locked/scheduler claim failedの該当0件。

外部取り込みカレンダーの内容にはアクセスしていない。上記は長期負荷試験や本番の全データ完全性検査を意味しない。

CLIの利用

配置前に既存 pages コマンドがないことを確認。ユーザーPATHに含まれる /home/anya/.local/bin/pages に0755で配置し、helpとソースとのSHA-256一致を確認した。

SHA-256:1a6feb7349a5b1b5b25fbb46cab1c7ac7dd7a46cbaab5aea803151305ac9da77

pages configure --origin https://pages.anya.jp --username anya
pages login
pages

利用者のプロファイルや資格情報は作成していない。本番資格情報による編集試験も行っていない。クライアントはPython 3.9以降のUnix系環境向け。別端末へのインストールは pages-cli README を参照。OIDC引き継ぎ・Ctrl+P fuzzy UI・新規Page作成は後続。

今回の切り戻し

今回の変更にDB/正本の移行はない。データを戻さず、直前のcommand版イメージへ切り替える。

docker image tag pageswiki-app:rollback-before-city-pages-cli-20261101 pageswiki-app:latest
docker compose up -d --no-deps --no-build app app2

両イメージID、health、ログイン、再起動回数を確認する。これは今回の変更専用の手順で、保存基盤変更前の古い版には適用しない。

CLIはサーバから独立しているため、サーバ切り戻しで削除する必要はない。利用停止時も保存済みセッションや設定を無断で削除しない。