3.8 KiB
CLIのダウンロードと配布
配布先はGiteaの anya/pages-cli のReleases。CLIはサーバーとは独立したSemVerで、最初の独立配布版はv0.1.0。対応APIがあるサーバーが必要で、タスク・連絡先を含む利用ではPagesWiki v0.6.0以降を基準とする。ユーザーの設定やセッションは既存のまま利用できる。
対象OS
| 対象 | 配布状態と条件 |
|---|---|
| Linux/amd64 | ELF単体とtar.gz。glibc 2.36以降(Debian 12、Ubuntu 24.04等)。Python同梱。Alpine/muslは対象外 |
| macOS | Unixソース対応。配布バイナリはmacOS runner接続後にネイティブビルド・実機検証する。署名・公証は別途必要 |
| Windows/amd64 | 配布準備の対象。fcntl、readline、所有者・0600権限検証のWindows移植とネイティブ検証が必要。未対応exeは公開しない |
rpm/debは初期配布の必須条件にせず、LinuxはELFを提供する。PyInstallerはクロスコンパイラではないため、macOS/WindowsバイナリをLinux上で作ったとみなさない。公式説明
インストール
公開ReleasesからOSに合うtar.gzと *-SHA256SUMS をダウンロードする。ダウンロードにログインは不要。PagesWikiへの接続に使う資格情報をコマンドライン引数や公開URLに埋め込まない。
# ダウンロード先で実行。手元にあるファイルをチェックする。
sha256sum --ignore-missing -c pages-cli-v0.3.1-linux-amd64-SHA256SUMS
tar -xzf pages-cli-v0.3.1-linux-amd64.tar.gz
mkdir -p ~/.local/bin
install -m 755 pages ~/.local/bin/pages
pages --version
SHA-256はダウンロード内容の整合確認であり、配布者の暗号学的署名ではない。ELF単体を取得した場合も同じSHA256SUMSで確認し、実行権限を付ける。設定・ログイン手順はREADMEを参照。PAGER・EDITOR、TLS用のOS信頼ストアは利用環境側に必要で、バイナリはOSのlibcなどへ動的リンクする。
ビルドとリリース
LinuxのCIはGitea Actionsでテスト後、Dockerfile.releaseからPython同梱ELFを作り、versionとhelpを起動確認する。VERSION とソースのVERSIONは一致必須。ビルドメタデータ、ソース版、tar.gz、実行ファイル、SHA256SUMSを出力する。ソース版に設定・トークン・ユーザーデータは含めない。
mainへのpushはテスト・ビルドのみ。vX.Y.Z タグのpushは同じ処理に加えてGitea Releaseへ添付し、全ファイルの転送後にdraftを解除する。同じ名前の既存添付はハッシュが一致する場合だけ再利用し、相違があれば停止する。公開タグは付け替えない。
既存runnerにはdocker/buildxとGiteaへのHTTPS接続が必要。公開にはジョブのtokenを使用し、権限不足の場合だけこのリポジトリに限定した CLI_RELEASE_TOKEN を設定する。サーバーリポジトリのPATやDocker資格情報をコピーしない。
macOSは CLI_MACOS_ENABLED=true と CLI_MACOS_RUNNER_LABEL を設定した場合のみ起動する。runnerにはPython 3、git、一時テスト証明書を生成するOpenSSLコマンドが必要で、タグcheckout後に同じbuild.pyを実行する。Macの最低OS、CPU、署名・公証は実際のrunnerと検証結果に合わせて公開時に明記する。Windowsは安全な資格情報保存の移植が済むまでジョブを有効化しない。
サーバーリポジトリ側の旧pages-cliは結合テスト用スナップショット。CLIの新規実装・配布はこのリポジトリで行い、サーバーの結合テスト用コピーはレビューしたリビジョンに明示的に更新する。