Git
English ▾ 主题 ▾ 最新版本 ▾ git-remote-ext 最后更新于 2.43.0

名称

git-remote-ext - 将智能传输桥接到外部命令。

概要

git remote add <nick> "ext::<command>[ <arguments>…​]"

描述

此远程助手使用指定的 <command> 连接到远程 Git 服务器。

写入指定 <command> 的标准输入的数据假定发送到 git:// 服务器、git-upload-pack、git-receive-pack 或 git-upload-archive(取决于情况),并且从 <command> 的标准输出读取的数据假定来自同一服务。

命令和参数用未转义的空格分隔。

以下序列具有特殊含义

'% '

命令或参数中的文字空格。

%%

文字百分号。

%s

替换为 Git 要调用的服务的名称(receive-pack、upload-pack 或 upload-archive)。

%S

替换为 Git 要调用的服务的完整名称(git-receive-pack、git-upload-pack 或 git-upload-archive)。

%G(必须是参数中的第一个字符)

此参数不会传递给 <command>。相反,它会导致助手首先将 git:// 服务请求发送到远程端,并将服务字段设置为适当的值,并将存储库字段设置为参数的其余部分。默认情况下不发送此类请求。

如果远程端是通过某些隧道访问的 git:// 服务器,这将很有用。

%V(必须是参数中的第一个字符)

此参数不会传递给 <command>。相反,它在 git:// 服务请求中设置 vhost 字段(设置为参数的其余部分)。默认情况下,在此类请求中不发送 vhost(如果已发送)。

环境变量

GIT_TRANSLOOP_DEBUG

如果已设置,则打印有关各种读/写操作的调试信息。

传递给命令的环境变量

GIT_EXT_SERVICE

设置为助手需要调用的服务的完整名称(git-upload-pack 等)。

GIT_EXT_SERVICE_NOPREFIX

设置为助手需要调用的服务的完整名称(upload-pack 等)。

示例

当您使用诸如“git fetch <URL>”、“git clone <URL>”、“git push <URL>”或“git remote add <nick> <URL>”之类的命令时,Git 会透明地使用此远程助手,其中 <URL> 以 ext:: 开头。示例

"ext::ssh -i /home/foo/.ssh/somekey [email protected] %S foo/repo"

类似于 host.example:foo/repo,但使用 /home/foo/.ssh/somekey 作为密钥对,并将 user 作为远程端的用户。这避免了编辑 .ssh/config 的需要。

"ext::socat -t3600 - ABSTRACT-CONNECT:/git-server %G/somerepo"

表示路径为 /somerepo 的存储库,可以通过抽象命名空间地址 /git-server 上的 git 协议访问。

"ext::git-server-alias foo %G/repo"

表示使用辅助程序“git-server-alias foo”访问的路径为 /repo 的存储库。存储库的路径和请求类型不会通过命令行传递,而是像往常一样作为协议流的一部分传递,就像 git:// 协议一样。

"ext::git-server-alias foo %G/repo %Vfoo"

表示使用辅助程序“git-server-alias foo”访问的路径为 /repo 的存储库。协议流中传递的远程服务器的主机名为“foo”(这允许多个虚拟 Git 服务器共享链路级地址)。

"ext::git-server-alias foo %G/repo% with% spaces %Vfoo"

表示使用辅助程序“git-server-alias foo”访问的路径为 /repo with spaces 的存储库。协议流中传递的远程服务器的主机名为“foo”(这允许多个虚拟 Git 服务器共享链路级地址)。

"ext::git-ssl foo.example /bar"

表示使用辅助程序“git-ssl foo.example /bar”访问的存储库。助手可以使用环境变量确定请求类型(请参见上文)。

Git

git[1] 套件的一部分

scroll-to-top