欢迎您访问 最编程 本站为您分享编程语言代码，编程技术文章！

热门搜索/Hot Search

您现在的位置是： 首页

git push

最编程 2024-05-04 19:59:46
...

Name

git-push - 更新远程引用以及关联的对象

概要

代码语言：javascript
复制 
git push [--all | --mirror | --tags] [--follow-tags] [--atomic] [-n | --dry-run] [--receive-pack=<git-receive-pack>]
           [--repo=<repository>] [-f | --force] [-d | --delete] [--prune] [-v | --verbose]
           [-u | --set-upstream] [--push-option=<string>]
           [--[no-]signed|--sign=(true|false|if-asked)]
           [--force-with-lease[=<refname>[:<expect>]]]
           [--no-verify] [<repository> [<refspec>…​]]

描述

使用本地引用更新远程引用，同时发送完成给定引用所需的对象。

您可以在每次进入存储库时通过在存储库中设置有趣的事情hooks。请参阅 git-receive-pack [1] 的文档。

当命令行未指定将<repository>参数推branch.*.remote送到何处时，将查阅当前分支的配置以确定推送的位置。如果配置丢失，则默认为origin。

当在命令行中没有指定，可以把什么<refspec>...参数或--all，--mirror，--tags选项，该命令将查找默认<refspec>通过咨询remote.*.push配置，如果没有找到它，荣誉push.default配置来决定推什么（请查看 git-config[1]为）push.default 的意思。

如果命令行和配置均未指定要推送的内容，则使用默认行为，该行为对应于以下simple值push.default：当前分支被推送到相应的上游分支，但作为安全措施，如果上游分公司不具有与本地名称相同的名称。

选项

<repository>

作为推送操作目标的“远程”存储库。此参数可以是 URL（请参阅下面的 GIT URLS 部分）或远程名称（请参阅下面的 REMOTES 部分）。

<refspec>…​

指定源对象要更新的目标引用。一个 <refspec> 参数的格式是一个可选的 plus +，后面是源对象 <src> ，后面是一个冒号:，后面是目标 ref <dst> 。

<src> 通常是您想要推送的分支的名称，但它可以是任意的“SHA-1表达式”，例如master~4 或 HEAD（请参阅 gitrevisions [7] ）。

<dst> 通过这个推送来告诉远程端的哪个 ref 被更新。任意表达式不能在这里使用，必须命名实际的引用。如果git push [<repository>]没有任何<refspec>参数设置为<src>使用remote.<repository>.push配置变量更新目标中的某个 ref ，:<dst>则可以省略部分 - 这样的推送将更新<src>通常<refspec>在命令行上没有任何更新的 ref 。否则，缺少:<dst>意味着更新相同的参考作为<src>。

由 <src> 引用的对象用于更新远程端的 <dst> 引用。默认情况下，只有当 <dst> 不是标签（带注释或轻量级标签）时才允许使用，并且只有在它可以快速转发 <dst> 时才允许使用。通过具有可选的领导+，你可以让 Git 更新 <DST> REF 即使是默认不允许的（比如，它不是一个快进。）这并不会试图合并<来源>为 <DST> 。有关详细信息，请参阅下面的示例。

tag <tag> means the same as refs/tags/<tag>:refs/tags/<tag>.

推送一个空的 <src>允许你从远程仓库中删除 <dst> ref 。

特殊 refspec :（或+:允许非快进更新）指示 Git 推送“匹配”分支：对于本地存在的每个分支，如果远程已存在的同名分支已经存在，则更新远程端侧。

--all

推送所有分支（即参考下refs/heads/）; 不能与其他 <refspec> 一起使用。

--prune

删除没有本地副本的远程分支。例如，tmp如果具有相同名称的本地分支不再存在，则远程分支将被删除。这也尊重 refspecs ，例如git push --prune remote refs/heads/*:refs/tmp/*，refs/tmp/foo如果refs/heads/foo不存在，将确保远程将被删除。

--mirror

代替命名每个裁判推的，指定了下的所有参考文献refs/（包括但不限于refs/heads/，refs/remotes/和refs/tags/）被镜像到远程存储库。新创建的本地参考将被推送到远端，本地更新的参考将在远端强制更新，删除的参考将从远端移除。如果remote.<remote>.mirror设置了配置选项，这是默认值。

-n --dry-run

做除了实际发送更新之外的其他事

--porcelain

生成机器可读的输出。每个 ref 的输出状态行将被制表符分隔并发送到 stdout 而不是 stderr 。将给出参考文献的完整符号名称。

--delete

所有列出的 ref 都从远程存储库中删除。这与用冒号前缀所有引用相同。

--tags

refs/tags除了在命令行中明确列出的 refspecs 之外，所有 refs 都将被推送。

--follow-tags

推送所有没有此选项时将被推送的引用，并且推送refs/tags远程引用中缺少的带注释的标签，但指向可从所推送的引用访问的提交标识。这也可以通过配置变量来指定push.followTags。有关更多信息，请参阅push.followTags git-config [1]。

--no-signed --sign=(true|false|if-asked)

GPG - 签署推送请求以更新接收端的 refs，以便通过钩子检查和/或记录。如果false或者--no-signed，不会尝试签名。如果true或者--signed，如果服务器不支持签名推送，推送将失败。如果设置为if-asked，则当且仅当服务器支持签名推送时签名。如果实际的呼叫gpg --sign失败，推送也会失败。有关接收端的详细信息，请参阅 git-receive-pack [1]。

--no-atomic

如果可用，请在远程端使用原子事务。要么所有的参考文献都被更新，要么出错，没有参考文献被更新。如果服务器不支持原子推送，推送将失败。

-o --push-option

将给定的字符串传送给服务器，服务器将它们传递给预接收以及接收后挂接。给定的字符串不能包含 NUL 或 LF 字符。

--receive-pack=<git-receive-pack> --exec=<git-receive-pack>

git-receive-pack远程端程序的路径。通过 ssh 推送到远程存储库时有用，而且您没有默认 $ PATH 目录中的程序。

--no-force-with-lease --force-with-lease=<refname> --force-with-lease=<refname>:<expect>

通常，“git push”拒绝更新一个不是本地 ref 的祖先的远程 ref ，用于覆盖它。

如果远程 ref 的当前值是期望值，则此选项将覆盖此限制。否则，“git push”会失败。

想象一下，你必须重新发布你已经发布的内容。您将不得不绕过“必须快进”规则，以便用最新发布的历史记录替换您最初发布的历史记录。如果其他人在重新装修时建立在原始历史的基础上，则遥控器分支的尖端可能会随着承诺而前进，而盲目推动--force则会失去她的工作。

这个选项允许你说你期望你正在更新的历史是你重新设计和想要取代的。如果远程引用仍然指向你指定的提交，你可以确定没有其他人对引用做任何事情。这就像在 ref 上“租赁”而不显式锁定它，只有当“租约”仍然有效时才更新远程参考。

--force-with-lease 单独的，没有指定细节，将通过要求它们的当前值与我们对它们的远程跟踪分支相同来保护将被更新的所有远程参考。

--force-with-lease=<refname>，而不指定期望值，如果它将要更新，将通过要求它的当前值与我们为它的远程跟踪分支相同来保护指定的 ref（单独）。

--force-with-lease=<refname>:<expect>将保护指定的 ref（单独），如果它将被更新，则通过要求其当前值与指定值相同<expect>（其可以不同于我们针对 refname 的远程跟踪分支），或者当使用这种形式时，我们甚至不需要有这样的远程追踪分支）。如果<expect>是空字符串，那么命名的 ref 必须不存在。

请注意，除此之外的所有形式--force-with-lease=<refname>:<expect>明确指定 ref 的预期当前值仍然是实验性的，并且随着我们获得此功能的经验，它们的语义可能会改变。

“--no-force-with-lease”将在命令行中取消之前的所有--force-with-lease。

安全的一般注意事项：无预期值提供这个选项，即作为--force-with-lease或--force-with-lease=<refname>任何事情非常糟糕交互隐含运行git fetch遥控器上的在后台推到，例如git fetch origin在一个你存储库的 cronjob 。

它提供的保护措施--force是确保您的工作不基于的后续更改不会被破坏，但如果某些后台进程正在更新后台中的 refs ，则会被轻微击败。除了远程追踪信息外，我们没有任何东西可以作为启发式参考，您预计会看到并愿意诋毁。

如果您的编辑器或其他系统正在git fetch后台运行，则可以采取以下措施来简化此操作：只需设置另一个远程设备：

代码语言：javascript
复制 
git remote add origin-push $(git config remote.origin.url)
git fetch origin-push

现在当后台进程运行时git fetch origin，引用origin-push将不会被更新，因此命令如下所示：

代码语言：javascript
复制 
git push --force-with-lease origin-push

除非您手动运行，否则会失败git fetch origin-push。这种方法当然完全被运行的东西击败git fetch --all，在这种情况下，你需要禁用它或者做一些更乏味的事情，比如：

代码语言：javascript
复制 
git fetch              # update 'master' from remote
git tag base master    # mark our base point
git rebase -i master   # rewrite some commits
git push --force-with-lease=master:base master:master

base即为上游代码的版本创建一个标签，这些代码是您已经看到并愿意覆盖的版本，然后重写历史记录，最后master在远程版本仍在时强制推送更改base，无论您的本地remotes/origin/master更新为背景。

-f --force

通常，该命令拒绝更新远程 ref ，该远程 ref 不是用于覆盖它的本地 ref 的祖先。另外，当使用--force-with-lease选项时，该命令拒绝更新当前值与预期值不匹配的远程参考。

该标志会禁用这些检查，并可能导致远程存储库丢失提交; 小心使用它。

请注意，--force适用于所有推入的 ref，因此使用它push.default设置为matching或配置有多个推送目标，remote.*.push可能会覆盖当前分支以外的引用（包括严格位于其远程对象之后的本地引用）。要强制只推送一个分支，可以使用+refspec前面的一个按钮（例如git push origin +master强制推送master分支）。有关<refspec>...详情，请参阅上面的部分。

--repo=<repository>

该选项等同于 <repository> 参数。如果两者都指定，则命令行参数优先。

-u --set-upstream

对于最新或成功推送的每个分支，添加无参数 git-pull [1] 和其他命令使用的上游（跟踪）引用。有关更多信息，请参阅branch.<name>.merge git-config [1]。

--no-thin

这些选项被传递给 git-send-pack [1]。当发送方和接收方共享许多相同的对象时，精简传输可显着减少发送的数据量。默认值是 --thin 。

-q --quiet

抑制所有输出，包括更新的引用列表，除非发生错误。进度未报告给标准错误流。

-v --verbose

运行详细。

--progress

当连接到终端时，默认情况下，标准错误流中会报告进度状态，除非指定了 -q 。即使标准错误流未定向到终端，此标志也会强制进度状态。

- no-recurse-submodules --recurse-submodules = check | on-demand | only | no

可用于确保所推送的版本所使用的所有子模块提交在远程跟踪分支上可用。如果check使用，Git 将验证子模块的至少一个远程模块上是否有可供推送中修改的所有子模块提交。如果缺少任何提交，推送将被中止并以非零状态退出。如果on-demand使用了所有在修订中被更改的子模块将被推送。如果按需无法推送所有必需的修订，它也会被中止并以非零状态退出。如果only使用了所有子模块，则在超级项目处于未放置状态时将递归推送所有子模块。值no或使用--no-recurse-submodules 可用于在不需要子模块递归时覆盖 push.recurseSubmodules 配置变量。

--no-verify

切换预推钩（见 githooks [5]）。默认值是 - 验证，使钩子有机会阻止推送。使用 --no-verify ，挂钩完全被旁路。

-4 --ipv4

仅使用 IPv4 地址，忽略 IPv6 地址。

-6 --ipv6

仅使用 IPv6 地址，忽略 IPv4 地址。

Git 网址

通常，URL 包含有关传输协议，远程服务器地址和存储库路径的信息。根据传输协议，这些信息可能不存在。

Git 支持 ssh，git，http 和 https 协议（另外，ftp 和 ftps 可用于提取，但效率低下，不推荐使用;不要使用它）。

本地传输（即 git：// URL）不进行身份验证，因此在不安全的网络上应谨慎使用。

以下语法可以与它们一起使用：

  • ssh://user@host.xz:port/path/to/repo.git/
  • git://host.xz:port/path/to/repo.git/
  • https://host.xz:port/path/to/repo.git/
  • ftps://host.xz:port/path/to/repo.git/

ssh 协议也可以使用另一种类似 scp 的语法：

  • user@host.xz：path / to / repo.git /只有在第一个冒号前没有斜线时才能识别此语法。这有助于区分包含冒号的本地路径。例如，本地路径foo:bar可以被指定为绝对路径或./foo:bar避免被误解为 ssh url 。ssh 和 git 协议还支持用户名扩展：
  • ssh://user@host.xz:port/~user/path/to/repo.git/
  • git://host.xz:port/~user/path/to/repo.git/
  • user@host.xz:/~user/path/to/repo.git/

对于本地支持的本地存储库，可以使用以下语法：

  • /path/to/repo.git/