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

3.6 KiB

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

検証と残件

Linux ELFの生成、ソース単体テスト30件、実ELFのconfigure・合成HTTPログイン・タスク一覧・対話シェル・不正な資格情報ファイル権限の拒否・ログアウトを確認した。SHA256SUMSによる全4生成物の照合も成功した。テストは一時ディレクトリと合成HTTPサーバーのみを使用し、本番ユーザーの資格情報は使用しない。

残件はリポジトリの公開範囲確認と作成、push後のCI実行・Release添付・ダウンロード検証、macOS runnerの設置、Windows移植とrunnerでの検証。実行ファイルのコード署名、macOS公証、rpm/debは後続。公開範囲とコードのライセンス付与は別に決める。