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

4.4 KiB

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

2026-11-06、サーバー本番をv0.7.1へ更新した後、pages-cliを公開リポジトリ anya/pages-cliへ切り出した。ユーザー指定により公開とし、認証なしでの閲覧を確認した。ソースのpushは完了。CI用runnerの接続待ちで、リリースタグと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 に配置し、originを公開Giteaリポジトリへ接続した。配布準備コミットは e4fb4f309f9257498af678c3ae37d22039081b15、公開用の説明修正後のコミットは e3f1be2f6f99ced3d287cbe2155c3d614b0a133b。公開前にCLIのみの履歴と追跡対象を確認し、秘密情報候補はテスト用の架空資格情報だった。サーバーの履歴・設定・データは含めない。

サーバー側の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サーバーのみを使用し、本番ユーザーの資格情報は使用しない。

公開コミットからも同じDockerfileでローカルビルドと30件のテスト、実ELFのスモークテストが成功した。Giteaの初回CI run 29はqueued。既存のcp01dはwikipagesリポジトリ専用のonline runnerで、pages-cliとanyaユーザーのrunner一覧は空だった。pages-cli専用runnerの追加、またはユーザー共通runnerへの再登録が必要。既存runnerの削除・登録範囲変更は行っていない。

残件はrunner接続、CI成功確認、v0.1.0タグ・Release添付・匿名ダウンロード検証、macOS runnerの設置、Windows移植とrunnerでの検証。実行ファイルのコード署名、macOS公証、rpm/debは後続。リポジトリ公開はオープンソースライセンスの新規付与とは別の操作であり、独自コードへのライセンスは追加していない。