ait gc — 完整參考
檢視、校驗並清理符合條件的原生儲存包。
適用對象: Repository 所有者與儲存維運
作用邊界#
用途: 檢視、校驗並清理符合條件的原生儲存包。
影響類別: stats 和 validate 只做檢視;prune 只刪除符合它確切資格規則的資料。
覆蓋: ait gc 下共 4 個公開 help surface。
下面的程式碼區塊原樣保留 1.1.1 二進位的輸出,包含它給出的每一個引數、選項、 預設值、可選值、衝突關係和必填要求。
完整命令樹#
ait gc
ait gc stats
ait gc validate
ait gc prune原樣輸出的 help#
ait gc#
二進位描述: Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Inspect bounded local content statistics, run exact read-only validation, or preview safe orphan object-pack cleanup. Pruning is read-only unless gc prune is given --apply; it never removes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Usage: ait gc <COMMAND>
Commands:
stats Show a bounded local content-storage summary.
validate Run exact read-only local content validation.
prune Preview safe orphan object-pack cleanup; mutate only with --apply.
help Print this message or the help of the given subcommand(s)
Options:
-h, --help
Print help (see a summary with '-h')說明
檢視有界的本地內容統計、執行精確的只讀校驗,或預覽安全的孤立物件包清理。除非給 gc prune 傳入 --apply,清理始終只讀;它絕不會刪除樹包、單個不可達 blob、Snapshot、Line、Task、工作區檔案或遠端內容。
| 引數 / 選項 | 說明 |
|---|---|
stats | 顯示有界的本地內容儲存摘要。 |
validate | 執行精確的只讀本地內容校驗。 |
prune | 預覽安全的孤立物件包清理;僅在給出 --apply 時才改動。 |
help | 列印本訊息或給定子命令的幫助 |
ait gc stats#
二進位描述: Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.
Show bounded local blob, tree, and pack counts and storage metrics without exact retained-tree traversal or full inventory rows. Use gc validate for exact retained-Snapshot reachability.
Usage: ait gc stats [OPTIONS]
Options:
--json
Emit the bounded summary as stable JSON.
-h, --help
Print help (see a summary with '-h')說明
顯示有界的本地 blob、樹和包的數量及儲存指標,不做精確的保留樹遍歷,也不列完整清單行。精確的保留 Snapshot 可達性請用 gc validate。
ait gc validate#
二進位描述: Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.
Run exact read-only validation by traversing retained Snapshot trees and blobs and checking local pack metadata without modifying repository or workspace state. The result is emitted before the command returns nonzero when needs_attention is true.
Usage: ait gc validate [OPTIONS]
Options:
--json
Emit the exact validation result as stable JSON.
-h, --help
Print help (see a summary with '-h')說明
透過遍歷保留的 Snapshot 樹和 blob 並檢查本地包後設資料來執行精確的只讀校驗,不修改儲存庫或工作區狀態。當 needs_attention 為 true 時,命令會先輸出結果再傳回非零。
ait gc prune#
二進位描述: Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Preview the exact fully orphaned object-pack cleanup plan by default. --apply recomputes, verifies, and revalidates that plan before changing local catalog metadata and deleting unreferenced object-pack archives. This command never prunes tree packs, individual unreachable blobs, Snapshots, Lines, Tasks, workspace files, or remote content.
Usage: ait gc prune [OPTIONS]
Options:
--apply
Apply the recomputed and revalidated safe plan; without this option the command is read-only.
--json
Emit the preview or apply result as stable JSON.
-h, --help
Print help (see a summary with '-h')說明
預設預覽確切的完全孤立物件包清理計劃。--apply 會在更改本地目錄後設資料並刪除未被引用的物件包歸檔之前,重新計算、驗證並複核該計劃。此命令絕不會清理樹包、單個不可達 blob、Snapshot、Line、Task、工作區檔案或遠端內容。