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 避免为无法从存储库的引用访问的提交和树提供归档文件。但是，由于计算对象可达性的计算成本很高，因此 git-upload-archive 实现了一组更严格但更易于检查的规则

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

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

  3. 客户端 *不能* 使用其他 sha1 表达式，即使最终结果可达。 例如，不允许使用相对提交（如 master^）或字面 sha1（如 abcd1234），即使结果可以从引用访问。

请注意，规则 3 禁止了许多没有隐私影响的情况。 这些规则可能会在未来版本的 Git 中更改，并且 git archive --remote 访问的服务器可能会或可能不会遵循这些精确规则。

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

选项

<repository>

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

GIT

属于 git[1] 套件

scroll-to-top