ait repo — 完整參考
檢視或管理已註冊的遠端 Repository 及其 CI 任務、能力和執行記錄。
適用對象： Repository 所有者與維運
作用邊界#
用途： 檢視或管理已註冊的遠端 Repository 及其 CI 任務、能力和執行記錄。
影響類別： 遠端讀取與管理混合的入口；退役、恢復和 CI 排程會改動遠端權威。
覆蓋： ait repo 下共 6 個公開 help surface。
下面的程式碼區塊原樣保留 1.1.1 二進位的輸出，包含它給出的每一個引數、選項、 預設值、可選值、衝突關係和必填要求。
完整命令樹#
ait repo
ait repo show
ait repo retire
ait repo restore
ait repo jobs
ait repo ci-capabilities原樣輸出的 help#
ait repo#
二進位描述： Inspect and manage the configured Repository on its remote server.
Inspect and manage the configured Repository on its remote server.
Usage: ait repo <COMMAND>
Commands:
show Read Repository identity, lifecycle, storage validation, and sync state.
retire Drain, archive, verify, and purge a remote Repository, or abort that retirement.
restore Restore a complete local retirement archive as a new remote Repository.
jobs Read one Worker Job or a bounded, optionally filtered Job inventory.
ci-capabilities Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help Print help說明
在遠端伺服器上檢視並管理已設定的 Repository。
| 引數 / 選項 | 說明 |
|---|---|
show | 讀取 Repository 身份、生命週期、儲存檢查碼同步狀態。 |
retire | 排空、歸檔、校驗並清除一個遠端 Repository，或中止該退役。 |
restore | 將一份完整的本地退役歸檔恢復為一個新的遠端 Repository。 |
jobs | 讀取一個 Worker Job，或一份有界且可選過濾的 Job 清單。 |
ci-capabilities | 檢查 Patchset CI 的伺服器、原生 runner 和遠端同步前置條件。 |
help | 列印本訊息或給定子命令的幫助 |
-h, --help | 列印幫助 |
ait repo show#
二進位描述： Read Repository identity, lifecycle, storage validation, and sync state.
Read Repository identity, lifecycle, storage validation, and sync state.
Usage: ait repo show [OPTIONS]
Options:
--remote <NAME> Use this configured remote; omission uses the Repository default remote.
--json Emit the complete machine-readable JSON result.
-h, --help Print help說明
讀取 Repository 身份、生命週期、儲存檢查碼同步狀態。
| 引數 / 選項 | 說明 |
|---|---|
--remote <NAME> | 使用此已設定的遠端；省略時使用 Repository 預設遠端。 |
--json | 輸出完整的機器可讀 JSON 結果。 |
-h, --help | 列印幫助 |
ait repo retire#
二進位描述： Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with ait repo restore --remote <NAME>; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.
Without --abort, stop new work for the remote Repository, download and verify its complete archive, then delete its server data. An unrelated complete local archive blocks retirement and must be handled with `ait repo restore --remote <NAME>`; there is no archive replacement option. With --abort, reactivate the Repository and preserve any complete local archive.
Usage: ait repo retire [OPTIONS]
Options:
--remote <NAME>
Mutate this configured remote; omission uses the Repository default remote.
--abort
Abort an in-progress retirement and reactivate the Repository while preserving any complete local archive.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
不帶 --abort 時，停止遠端 Repository 的新工作，下載並校驗其完整歸檔，然後刪除伺服器資料。一份無關的完整本地歸檔會阻止退役，必須用 ait repo restore --remote <NAME> 處理；不存在歸檔替換選項。帶 --abort 時，重新啟用 Repository，並保留任何完整本地歸檔。
ait repo restore#
二進位描述： Verify the complete .ait/remote/<remote>/ retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.
Verify the complete `.ait/remote/<remote>/` retirement archive, create a new remote Repository index, upload and save its data, then update the locally configured Repository index. The archive determines the restored identity; there is no name, index, or force override.
Usage: ait repo restore [OPTIONS]
Options:
--remote <NAME>
Use this configured remote; omission uses the Repository default remote.
--json
Emit the complete machine-readable JSON result.
-h, --help
Print help (see a summary with '-h')說明
校驗完整的 .ait/remote/<remote>/ 退役歸檔，建立新的遠端 Repository 索引，上傳並儲存其資料，然後更新本地設定的 Repository 索引。恢復身份由歸檔決定；不存在名稱、索引或 force override。
ait repo jobs#
二進位描述： Read one Worker Job or a bounded, optionally filtered Job inventory.
Read one Worker Job or a bounded, optionally filtered Job inventory.
Usage: ait repo jobs [OPTIONS]
Options:
--remote <NAME> Read from this configured remote; omission uses the Repository default remote.
--worker-job-index <INDEX> Read one specific Worker Job from the current Repository; cannot be combined with list filters.
--state <STATE> Return only queued, running, succeeded, or failed Jobs. [possible values: queued, running, succeeded, failed]
--limit <COUNT> Return at most this many Jobs in list mode (1 through 1000; default 50). [default: 50]
--json Emit the complete machine-readable JSON result.
-h, --help Print help說明
讀取一個 Worker Job，或一份有界且可選過濾的 Job 清單。
| 引數 / 選項 | 說明 |
|---|---|
--remote <NAME> | 從此已設定的遠端讀取；省略時使用 Repository 預設遠端。 |
--worker-job-index <INDEX> | 從目前 Repository 讀取一個特定 Worker Job；不能與列表過濾條件組合。 |
--state <STATE> | 只傳回 queued、running、succeeded 或 failed 狀態的 Job。[possible values: queued, running, succeeded, failed] |
--limit <COUNT> | 在列表模式下最多傳回此數量的 Job（1 到 1000；預設 50）。[default: 50] |
--json | 輸出完整的機器可讀 JSON 結果。 |
-h, --help | 列印幫助 |
ait repo ci-capabilities#
二進位描述： Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
Inspect server, native runner, and remote-sync prerequisites for Patchset CI.
Usage: ait repo ci-capabilities [OPTIONS]
Options:
--remote <NAME> Use this configured remote; omission uses the Repository default remote.
--json Emit the complete machine-readable JSON result.
-h, --help Print help說明
檢查 Patchset CI 的伺服器、原生 runner 和遠端同步前置條件。
| 引數 / 選項 | 說明 |
|---|---|
--remote <NAME> | 使用此已設定的遠端；省略時使用 Repository 預設遠端。 |
--json | 輸出完整的機器可讀 JSON 結果。 |
-h, --help | 列印幫助 |