Agent controller install.sh finds no release: first page is all prereleases, stable release is unsigned, --version rejects prereleases

オープン
#1,981 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

@GauravPatil2515 がすでに取り組んでいます。

2026年11月13日 から。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
40/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
github, shell
領域
cli, release

調査の方向性

Start in console/packages/agent-controller/install.sh: the release lookup that requests /releases?per_page=100 without paging, the prerelease skip, and the --version check that rejects anything containing characters outside digits and dots. The fix needs the script to find the newest signed stable release across pages and to accept signed prerelease versions like x.y.z-rc.N. Publishing a signed stable release needs maintainer access, so confirm that with the maintainers before starting.

索引モデルが issue の本文から書いたものです。

説明

bug

What happens

The documented one-line install of the headless agent controller fails on every machine:

curl -fsSL https://raw.githubusercontent.com/sandbox-quantum/switch/main/console/packages/agent-controller/install.sh | sh -s -- --server <server> --code <code> --name <name>
switch-agent-controller install: sandbox-quantum/switch has no switch-agent-controller release yet.

Why

Three things in console/packages/agent-controller/install.sh combine:

  1. Only the first page of releases is read. The newest release is looked up with GET /repos/sandbox-quantum/switch/releases?per_page=100, with no paging. Dev builds of main are published as controller prereleases several times an hour, so the newest 100 releases are all prereleases (95 of them controller dev builds and release candidates at the time of writing), and the script skips prereleases. The stable releases are further back and never seen.
  2. The only stable controller release is unsigned. switch-agent-controller-v0.31.0 ships switch-agent-controller-0.31.0.tgz but no .sig, so even when it is found, or named with --version 0.31.0, the installer refuses it: only signed releases are installed.
  3. Signed prereleases cannot be requested. Release candidates are signed (switch-agent-controller-v0.32.0-rc.5 ships its .tgz.sig), but --version accepts only x.y.z (*[!0-9.]* is refused), so --version 0.32.0-rc.5 is rejected before any download.

So there is currently no way to install the controller with the script.

Expected

The script installs the newest signed stable release, and --version can name any signed release, including a prerelease.

Suggested fix

  • Find the newest stable controller release without depending on the first page: page through /releases until a match is found, or list matching tags (/git/matching-refs/tags/switch-agent-controller-v) and fetch releases by tag.
  • Let --version accept a prerelease version (x.y.z-rc.N, x.y.z-dev.N.gSHA), still requiring a valid signature.
  • Publish a signed stable controller release (or add a .sig to the next one), so the default path has something to install.

Workaround

Switch Console sets up a managed machine on the computer it runs on, so agents can run there without the headless controller, at the cost of stopping when Console quits.

主要言語
Python
スター
4.5k
フォーク
348
平均マージ
1日 17時間
マージ済み PR(30日)
287

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

sandbox-quantum/switch のほかの issue

sandbox-quantum/switch の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。