From 9861b19f7b28a1fbab1cb0d1336571e6a6eb6d17 Mon Sep 17 00:00:00 2001 From: Anya Tokugawa Date: Fri, 6 Nov 2026 02:25:02 +0900 Subject: [PATCH] docs: record v0.7.1 deployment and CLI distribution preparation [skip ci] --- .../deployments/2026-11-06-v0.7.1.md | 29 +++++++++++++++++++ docs/operations/pages-cli-distribution.md | 27 +++++++++++++++++ docs/operations/releases/2026-11-04-v0.7.1.md | 4 +-- 3 files changed, 58 insertions(+), 2 deletions(-) create mode 100644 docs/operations/deployments/2026-11-06-v0.7.1.md create mode 100644 docs/operations/pages-cli-distribution.md diff --git a/docs/operations/deployments/2026-11-06-v0.7.1.md b/docs/operations/deployments/2026-11-06-v0.7.1.md new file mode 100644 index 0000000..1dddc42 --- /dev/null +++ b/docs/operations/deployments/2026-11-06-v0.7.1.md @@ -0,0 +1,29 @@ +# PagesWiki v0.7.1 本番反映 + +2026-11-06 02:11:04 JST、本番のapp・app2・adaptor-gateway・excalidraw-viewerをv0.7.1へ更新した。タスク編集画面の2カラム化と個人別Inbox通知既定値を反映した。配布物とdigestは[リリース記録](../releases/2026-11-04-v0.7.1.md)を参照する。ソースrevisionは `a6bf3dfe41bec1896acf6a047562f79b6028836b`。 + +## 切替と保全 + +公開済み3イメージのdigestとrevisionを照合した。旧バックアップの独立コピー2系統で、ネットワークなし・DR workers無効の起動確認と管理対象12コンポーネントのschema checkを実施し、成功した。 + +`.deployment-backups/release-v0.7.1-20261106/` に旧Compose、`.env`、旧 `.env.release` と切替直前の `cutover/data`・`cutover/data2` を保持する。親ディレクトリ0700、保存した `.env` は0600。停止後のチェックサム付き最終同期、差分ゼロ、DB・WAL・SHMのバイト一致、稼働ファイルと異なるinodeを確認した。変更のないファイルは過去の不変バックアップとのみlink-destで共有する。 + +| 時刻 JST | 操作 | +| --- | --- | +| 02:09:36 | 対象4サービスの停止開始 | +| 02:10:58 | 最終バックアップ検証完了 | +| 02:11:04 | v0.7.1の起動完了 | + +停止開始から起動完了まで88秒。`.env.release` をv0.7.1に設定し、registry overlayで対象サービスだけ `up --no-build --no-deps` した。旧v0.7.0イメージには `rollback-before-v0.7.1-20261106` を付けて保持した。ローカルlatestは新バージョンへ揃えた。registry latest、code-server、Kroki等は変更していない。旧バックアップは削除せず、今回のリハーサルコピーだけを停止・検証後に削除した。終了時の空き容量は約40 GiB。 + +DBスキーマはv0.7.0と同じ。旧版へ戻して個人設定を再保存すると新しい通知既定値を失う可能性があるため、切戻しは書込みを停止して現行データも保全し、互換性を確認する。バックアップの自動復元は行わない。 + +## 本番確認 + +- 対象4サービスのrevision一致、起動状態正常、再起動0回。appとExcalidrawのhealthcheckはhealthy。app2の内部healthも成功。 +- 両系統の管理対象12コンポーネントはcurrent。これはlegacy領域を含む全データの完全性検査ではない。 +- 公開HTTPSのhealthとログイン入口は200。匿名のタスク画面・個人設定は303、preferences APIとCardDAV入口は401。 +- 公開されたtasks.js、task-productivity.js、tasks.cssのSHA-256がv0.7.1ソースと一致。 +- 初期ログのpanic、fatal、DB lock、job failed、scheduler claim failed、errorレベルの該当件数は0。 + +本番の実ユーザーデータを作成・更新するUI試験は行っていない。認証済み操作はリリース前の合成データ試験で確認済み。外部取り込みカレンダー要素にはアクセスせず、バックアップは内容を解釈しないファイルコピーとした。ホストのCLIはこの切替では置き換えていない。 diff --git a/docs/operations/pages-cli-distribution.md b/docs/operations/pages-cli-distribution.md new file mode 100644 index 0000000..97674b1 --- /dev/null +++ b/docs/operations/pages-cli-distribution.md @@ -0,0 +1,27 @@ +# pages-cliの独立リポジトリと配布準備 + +2026-11-06、サーバー本番をv0.7.1へ更新した後、pages-cliを `anya/pages-cli` へ切り出す準備を行った。Gitea側の公開範囲は確認待ちで、リモートリポジトリ作成・push・Release添付はまだ実行していない。 + +## ソースと互換性 + +`git subtree split --prefix=pages-cli` でCLI配下の5コミットを抽出した。抽出先の基点は `d3f4e668c448289f8cf264e4b7286ad772cf2d05`。サーバー側のCLIスナップショットは `pages-cli/pages`、SHA-256は `d423d1a38cb931880e78e419188083592d9163cdd958ace86f58849d141c4f41`。 + +独立先はCLIをルートの `pages` として保持し、独立SemVerの初版を0.1.0とする。サーバーのv0.7.1と番号を連動させない。`--version` とHTTP User-AgentをCLIのVERSIONへ合わせる。接続先・言語・セッション保存場所は変更しない。 + +独立したローカルリポジトリは `/home/anya/prj/pages/pages-cli` に配置した。配布準備コミットは `e4fb4f309f9257498af678c3ae37d22039081b15`。remoteとリリースタグはまだ設定していない。生成物は同ディレクトリの `release/` に置き、ビルドメタデータのsource_revisionがこのコミットと一致することを確認した。 + +サーバー側の3つのGo結合テストはCLIのスナップショットを参照している。切り出し時点では削除せず、独立リポジトリを正本にした後、レビュー済みリビジョンに固定して明示更新する。サーバーCI中に認証付きgit fetchを増やしたり、最新CLIへ暗黙追従したりしない。DB直接操作CLI `data/pageswiki-cli` は切り出し対象外。 + +## 配布方式 + +Linux/amd64はPython同梱ELF、tar.gz、ソーススクリプト、ビルドメタデータ、SHA256SUMSを生成する。Python 3.11のDebian 12イメージをdigest固定し、PyInstaller 6.22.0を使用する。最低glibcは2.36、Alpine/muslは対象外。rpm/debは後続で、まずELFを提供する。 + +Gitea Actionsのmain pushはテストとビルド、vタグはさらにRelease添付まで行う。draftへ全ファイルを添付後に公開し、公開済み同名ファイルのハッシュが異なれば停止する。API呼出しはジョブtokenを使用し、権限不足時のみCLIリポジトリ限定のrelease tokenを別途設定する。既存のサーバー用PATを自動コピーしない。 + +macOS用のnative buildジョブはrunner接続後に有効化する。Windows/amd64はfcntl・readline・所有者/権限検査の移植が必要で、未検証exeを公開しない。詳細TODOは独立作業コピーの `WINDOWS-TODO.md` に保持する。PyInstallerはクロスコンパイラではなく、OSごとの実ビルド・検証が必要。[公式説明](https://www.pyinstaller.org/en/stable/) + +## 検証と残件 + +Linux ELFの生成、ソース単体テスト30件、実ELFのconfigure・合成HTTPログイン・タスク一覧・対話シェル・不正な資格情報ファイル権限の拒否・ログアウトを確認した。SHA256SUMSによる全4生成物の照合も成功した。テストは一時ディレクトリと合成HTTPサーバーのみを使用し、本番ユーザーの資格情報は使用しない。 + +残件はリポジトリの公開範囲確認と作成、push後のCI実行・Release添付・ダウンロード検証、macOS runnerの設置、Windows移植とrunnerでの検証。実行ファイルのコード署名、macOS公証、rpm/debは後続。公開範囲とコードのライセンス付与は別に決める。 diff --git a/docs/operations/releases/2026-11-04-v0.7.1.md b/docs/operations/releases/2026-11-04-v0.7.1.md index 3f11e66..f261671 100644 --- a/docs/operations/releases/2026-11-04-v0.7.1.md +++ b/docs/operations/releases/2026-11-04-v0.7.1.md @@ -1,6 +1,6 @@ # PagesWiki v0.7.1 リリース -2026-11-04、タスク編集画面の整理と個人別のInbox通知既定値を含むv0.7.1を公開した。Gitタグと3つのコンテナイメージを作成済み。本リリース作成では本番を切り替えておらず、稼働サービスと `.env.release` はv0.7.0のままである。 +2026-11-04、タスク編集画面の整理と個人別のInbox通知既定値を含むv0.7.1を公開した。Gitタグと3つのコンテナイメージを作成済み。リリース作成と本番切替は分離し、2026-11-06に[本番反映](../deployments/2026-11-06-v0.7.1.md)を完了した。 ## 変更内容 @@ -38,4 +38,4 @@ DBスキーマとmanaged migrationのversionは変更しない。既存preferenc 実装段階で全Goテスト、go vet、JS構文検査、差分検査、合成データのブラウザテストが成功した。ブラウザではPC・1024×768のノートPC・390px幅と320px幅のスマホ・英語表示、通知既定値の保存と適用、明示的な通知OFFの保持、再編集を検証した。本番のユーザーデータや外部取り込みカレンダーを検証に使用していない。 -今回のリリースCIでも全Goテストとリリースツールのテストが成功した。サーバーパッケージは201.686秒、ストアは104.383秒で成功し、再実行は不要だった。配布物はレジストリへ公開済みだが、本番適用後の動作確認は別途実施する。 +今回のリリースCIでも全Goテストとリリースツールのテストが成功した。サーバーパッケージは201.686秒、ストアは104.383秒で成功し、再実行は不要だった。配布物はレジストリへ公開済み。2026-11-06に本番適用と稼働確認を完了した。詳細は[本番反映記録](../deployments/2026-11-06-v0.7.1.md)を参照する。