Git
English ▾ 主题 ▾ 最新版本 ▾ 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 避免为无法从存储库的 ref 访问的提交和树提供存档。但是，由于计算对象可达性在计算上代价高昂，因此 git-upload-archive 实施了一套更严格但更容易检查的规则

  1. 客户端可以请求由 ref 直接指向的提交或树。例如，git archive --remote=origin v1.0。

  2. 客户端可以使用 ref:path 语法请求提交或树中的子树。例如，git archive --remote=origin v1.0:Documentation。

  3. 客户端不能使用其他 sha1 表达式，即使最终结果是可访问的。例如，既不允许像 master^ 这样的相对提交，也不允许像 abcd1234 这样的字面 sha1，即使结果可以从 ref 访问。

请注意，规则 3 禁止了许多没有任何隐私含义的情况。这些规则可能会在 Git 的未来版本中发生变化，并且 git archive --remote 访问的服务器可能遵循也可能不遵循这些确切的规则。

如果配置选项 uploadArchive.allowUnreachable 为真，则忽略这些规则，客户端可以使用任意 sha1 表达式。如果您不关心无法访问的对象的隐私，或者如果您的对象数据库已通过非智能 HTTP 公开提供访问权限，这将很有用。

选项

<repository>

要从中获取 tar 存档的存储库。

GIT

git[1] 套件的一部分

scroll-to-top