Git
英文 ▾ 主題 ▾ 最新版本 ▾ git-upload-archive 最後更新於 2.39.0

名稱

git-upload-archive - 將封存檔傳送回 git-archive

概要

git upload-archive <repository>

說明

git archive --remote 呼叫,並透過 Git 協定將產生的封存檔傳送到另一端。

此命令通常不由最終使用者直接呼叫。協定的 UI 在 git archive 端,並且此程式對旨在用於從遠端儲存庫取得封存檔。

安全性

為了保護已從歷史記錄中移除但可能尚未修剪的物件的隱私,git-upload-archive 避免為無法從儲存庫的 refs 存取的提交和樹狀結構提供封存檔。然而,由於計算物件可存取性在計算上代價高昂,git-upload-archive 實作了一組更嚴格但更容易檢查的規則

  1. 用戶端可能會請求由 ref 直接指向的提交或樹狀結構。例如,git archive --remote=origin v1.0

  2. 用戶端可以使用 ref:path 語法請求提交或樹狀結構內的子樹。例如,git archive --remote=origin v1.0:Documentation

  3. 用戶端不得使用其他 sha1 表達式,即使最終結果是可存取的。例如,即使結果可以從 refs 存取,也不允許使用像 master^ 這樣的相對提交或像 abcd1234 這樣的文字 sha1。

請注意,規則 3 不允許許多沒有任何隱私含義的情況。這些規則可能會在未來版本的 Git 中變更,並且由 git archive --remote 存取的伺服器可能不一定遵循這些確切的規則。

如果組態選項 uploadArchive.allowUnreachable 為 true,則會忽略這些規則,並且用戶端可以使用任意 sha1 表達式。如果您不關心無法存取物件的隱私,或者您的物件資料庫已經可以透過非 smart-http 公開存取,這會很有用。

選項

<儲存庫>

要從中取得 tar 封存檔的儲存庫。

GIT

屬於 git[1] 套件的一部分

scroll-to-top