Files
pages/docs/operations/pages-cli-distribution.md
T

5.2 KiB

pages-cliの公開リポジトリと配布

2026-11-06、サーバー本番をv0.7.1へ更新した後、pages-cliを公開リポジトリ anya/pages-cliへ切り出し、v0.1.0をGitea Actionsから公開した。ソースとLinux/amd64成果物はログイン不要で取得できる。

同日、実行単位の --insecure / -k を追加したv0.2.0を公開した。最新の変更・TLS試験・配布確認はv0.2.0リリース記録を参照。以下の切り出し・初回検証記録はv0.1.0時点のもの。

ソースと互換性

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 に配置し、originを公開Giteaリポジトリへ接続した。配布準備コミットは e4fb4f309f9257498af678c3ae37d22039081b15、公開用の説明修正後のコミットは e3f1be2f6f99ced3d287cbe2155c3d614b0a133b。公開前にCLIのみの履歴と追跡対象を確認し、秘密情報候補はテスト用の架空資格情報だった。サーバーの履歴・設定・データは含めない。

v0.1.0のソースは 7fa71eceb1ecbed84ad3bc904af3f3a473624b92。NeoMutt連携ガイド、設定例、クライアント契約を独立リポジトリへ移転し、tar.gzにも同梱した。サーバーの旧ドキュメントは移転案内、HTTP/OIDCサーバー内部設計と結合テストはサーバー側に保持する。

サーバー側の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ごとの実ビルド・検証が必要。公式説明

検証と残件

ソース単体テスト32件、実ELFのconfigure・合成HTTPログイン・タスク一覧・メール取り込み時の本文非送信・NeoMutt宛先検索・対話シェル・不正な資格情報ファイル権限の拒否・ログアウトを確認した。テストは一時ディレクトリと合成HTTPサーバーのみを使用し、本番ユーザーの資格情報は使用しない。

既存cp01dのホストにリポジトリ専用の cp01d-pages-cli を追加し、初回CI run 29、移転後CI run 30、v0.1.0 Release CI run 31が成功した。既存runnerは変更していない。配置・停止方法はrunner運用記録を参照。

Releaseはジョブtokenで公開でき、追加PATは不要だった。添付5ファイルを匿名ダウンロードし、SHA256SUMS記載の4生成物を照合、ダウンロードしたELFの上記スモークテストを実施した。tar.gz内のREADME・NeoMuttガイド・クライアント契約・設定例がソースと一致し、メタデータのsource_revisionがタグ先コミットと一致することも確認した。

残件はmacOS runnerの設置、Windows移植とrunnerでの検証。実行ファイルのコード署名、macOS公証、rpm/debは後続。リポジトリ公開はオープンソースライセンスの新規付与とは別の操作であり、独自コードへのライセンスは追加していない。