无需克隆即可从远程仓库获取最后一个 git 标签

Posted

技术标签:

【中文标题】无需克隆即可从远程仓库获取最后一个 git 标签【英文标题】:Get last git tag from a remote repo without cloning 【发布时间】:2012-05-25 20:40:59 【问题描述】:

如何从(未签出的)远程仓库中获取最后一个标签?

在我的本地副本上,我使用describe

git describe --abbrev=0 --tags

但我不能将describe 与远程存储一起使用

【问题讨论】:

【参考方案1】:

TL;DR

使用git ls-remote,您可以从远程存储库获取引用列表。

要查看最新版本是什么,请查看以下输出的最后一行:

git -c 'versionsort.suffix=-' ls-remote --tags --sort='v:refname' <repository>

输出使用Semantic Versioning的存储库的最新标签(例如在shell脚本中)使用:

git -c 'versionsort.suffix=-' \
    ls-remote --exit-code --refs --sort='version:refname' --tags <repository> '*.*.*' \
    | tail --lines=1 \
    | cut --delimiter='/' --fields=3

对于没有 --sort 标志(pre v2.18)的旧版本 Git,或不支持 versionsort.suffix(pre v2.4)的版本,请使用:

git ls-remote --refs --tags <repository> \
    | cut --delimiter='/' --fields=3     \
    | tr '-' '~'                         \
    | sort --version-sort                \
    | tail --lines=1

没有--version-sort 标志的旧版本sort 超出了此问题的范围...


长版

仅标签

使用--tags 确保列表只包含标签引用。

这将包括引用和取消引用的标签。这意味着某些标签的引用名末尾会有^。 (有关更多信息,请参阅this question elsewhere on ***。)

对于人类消费来说这并不重要,但如果你不想看到那些^'s add --refs

排序

可以使用--sort 对引用列表进行排序。

排序选项使用与git for-each-ref 相同的排序键。由于我们在本地没有所有信息,因此并非所有选项都可供我们使用(例如与日期相关的排序键)。

我们想使用版本排序,基于参考名称。为此,我们使用version:refname 键。这也可以缩写为v:refname

这将对版本进行升序排序,这意味着最新版本将是最后一个

要反转列表,请在排序键前添加---sort='-v:refname'

预发布排序

此时,version-sort 会将候选版本(例如 v2.28.0-rc2放在他们应该在前面的稳定版本之后。

从 v2.12 开始,我们可以 use a configuration flag 告诉 Git 对具有特定字符后缀的引用名称进行排序 没有该字符后缀的引用:git -c 'versionsort.suffix=-'

要始终像这样使用versionsort.suffix,可以全局设置:

git config --global 'versionsort.suffix' '-'

在 v2.4 和 v2.12 之间,该标志称为 versionsort.prereleaseSuffix

在旧版本的 Git 中排序

对于较旧的 Git 版本,可以使用一个技巧:破折号 - 排序 之前 空格 但波浪号 ~ 排序 之后一个空格。

因此,通过将破折号 - 替换为波浪号 ~,事情会以正确的顺序排序。这可以使用tr '-' '~'来完成

只有一行

由于我们并不真正关心所有输出,除了最后一行,我们只显示尾部:tail --lines=1。当然,如果列表按降序检索(使用--sort='-v:refname'),则为:head --lines=1

只是引用名

ls-remote 命令的输出还输出引用hash

ada126bd28d66c8c8ff5966a52d63ce2c9e4d031        refs/tags/v2.28.0-rc0

要只看到实际的标签(即引用名称),我们可以剪切该行的第一部分:cut --delimiter='/' --fields=3

参考过滤器

最后要注意的是,ls-remote 可以被赋予一个过滤器以显示与过滤器模式匹配的引用。例如,对于语义版本控制,我们可以使用:'*.*.*'。与该模式不匹配的任何内容都不会显示。

如果存储库始终以 v 为版本标记添加前缀,则可以进一步缩小到 'v*.*.*'

另一个例子是只检索特定主版本的最新标签。例如,要仅查看 repo 版本 2 的标签,我们可以使用 'v2.*'

请确保在过滤器周围使用引号,否则* 会给您带来麻烦!

找不到参考

使用过滤器时最好使用--exit-code 标志。

这是因为 Git 将始终以状态码 0 退出,以表明它已成功与远程存储库通信。

对于人类来说,这很好,如果找到任何参考,您将在屏幕上看到。

但是,如果在 shell 脚本中使用此代码,则可能会出现问题。

当在远程存储库中找不到匹配的引用时,可以告诉 Git 使用状态码 2。这是通过使用--exit-code 标志来完成的。

这样脚本会知道什么时候出错了!

显然,如果不使用过滤器,使用--exit-code 并没有真正意义。

举个例子!

假设我们想知道 Git 的最新标签是什么。

我们会这样做:

git ls-remote --sort='version:refname' --tags https://github.com/git/git.git

这将返回一个包含所有标签的长列表,如下所示(为了理智而截断)。

    ...

4c8bcdda4d6e4757caf876ddc401b5392e874e21        refs/tags/v2.28.0
ada126bd28d66c8c8ff5966a52d63ce2c9e4d031        refs/tags/v2.28.0-rc0
bd42bbe1a46c0fe486fc33e82969275e27e4dc19        refs/tags/v2.28.0-rc0^
49bfe36405d1631a303992cac5cc408980a0454e        refs/tags/v2.28.0-rc1
3ddac3d691c3633cd4d9a74c07e3b2301f546f77        refs/tags/v2.28.0-rc1^
84a0d5cc2107b83a791aa4034cc54874e1d50668        refs/tags/v2.28.0-rc2
b066807397fd55553f4910ede74839e319b661fd        refs/tags/v2.28.0-rc2^
47ae905ffb98cc4d4fd90083da6bc8dab55d9ecc        refs/tags/v2.28.0^

这告诉我们最新的标签是v2.28.0

另一个例子是全局设置versionsort.suffix,然后只获取最后一个标签:

git config --global 'versionsort.suffix' '-'

git ls-remote --refs --sort=':refname' --tags https://github.com/git/git.git \
    | tail --lines=1 | cut --delimiter='/' --fields=3

现在,让我们看看是否已经有 Git 3 版!

$ git ls-remote --exit-code --refs --tags https://github.com/git/git.git 'v3.*'
$ echo $?
2 # nope, not yet

【讨论】:

除分支名称外,我如何去除所有内容? @Potherca 我做到了! | awk -F/ ' print $3 ' 为什么所有的标签名都是重复的,后面加了^? @MichaelKnudsen ^ 是用于取消引用标签的语法。更多信息可以在 *** 其他地方的这些问题中找到:***.com/questions/15472107/…***.com/questions/12938972/what-does-mean-in-git 在排序前放置- 将颠倒顺序,例如--sort="-version:refname"【参考方案2】:

不幸的是,git ls-remote --tags 实际上是按字母顺序列出标签的(至少从 1.7.2.5 开始)。因此,在 1.7.10、1.7.11 或 1.7.12 是最新标签时,1.7.9 将是列表中的最后一个:

git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."

[...]
bf68fe0313c833fa62755176f6e24988ef7cf80f        refs/tags/v1.7.9.6
cb2ed324fc917db0b79d7b1f3756575ffa5f70d5        refs/tags/v1.7.9.6^
3996bb24c84013ec9ce9fa0980ce61f9ef97be4d        refs/tags/v1.7.9.7
d0f1ea6003d97e63110fa7d50bb07f546a909b6e        refs/tags/v1.7.9.7^

但是,我们可以通过“排序”来管道这些结果,以更接近我们正在寻找的结果:

git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."| sort -g -k3 -t.

[...]
eab05abaeb51531e11835aaa4c26564a1babebac        refs/tags/v1.7.9-rc2
eac2d83247ea0a265d923518c26873bb12c33778        refs/tags/v1.7.9-rc0^
f59f511e26b4924b22c6966e79fe4f754bc81dc6        refs/tags/v1.7.9.2
0e2d57fd50f61e668be3180bc8f25991ea88aa8c        refs/tags/v1.7.10-rc1^
121f71f0da1bc9a4e1e96be2c3e683191a82a354        refs/tags/v1.7.10.4^
26e5c5d09334d157bd04f794f16f6e338d50c752        refs/tags/v1.7.10.3^
[...]
cffb45719f60d6fc2cc98ead6af88a895c63c9ac        refs/tags/v1.7.12.4
d8cf053dacb4f78920c112d10c7be21e4f5a5817        refs/tags/v1.7.12.2^
dcd07fb6262fd8bb9f531890df3986a8b719a0b5        refs/tags/v1.7.12-rc0
e15c16de396a1e1f42001b03cb885ce64eb4098e        refs/tags/v1.7.12-rc2^

虽然仍然不正确,但它更接近。如果我们排除 -rc 和 ^,并在最后一个子版本号上添加一个额外的排序,我们可能可以满足大多数需求:

git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."|grep -v -|grep -v | sort -n -t. -k3 -k4

23ed9debf17263ed6bed478a4d6d86e71342c18a        refs/tags/v1.7.11.6
527b331100ddba839cc54bb31c1bcd66acc08321        refs/tags/v1.7.11.7
14d20a75e3d57a872a8c81ae90dcc4c61ddba011        refs/tags/v1.7.12
51993a414a76120fda20d56ba767fa513d9ff440        refs/tags/v1.7.12.1
04043f4d1ae42bddee67d354a2e6fd2464592a1e        refs/tags/v1.7.12.2
b38da673be332933b8f3a873ce46ffea08d2ee2c        refs/tags/v1.7.12.3
cffb45719f60d6fc2cc98ead6af88a895c63c9ac        refs/tags/v1.7.12.4

【讨论】:

windows cmd 中的什么?【参考方案3】:
git ls-remote --tags "#github_repo" | awk 'print $2' | grep -v '' | awk -F"/" 'print $3' | sort -n -t. -k1,1 -k2,2 -k3,3 | tail -n 1.chomp

这对我有用how to get latest tag from github remote repository

【讨论】:

当最新标签是 1.4.34 时,我失败了。它将改为报告 1.4.9。我猜 9 在 3 之后 - 它不会被解释为 34。 @ernestopheles 你是对的我已经更新了解决这个问题的答案。感谢您指出。 对我不起作用,因为我们改变了我们标记的方式,这不按日期排序【参考方案4】:

这是我的单线:-)

git ls-remote --tags --refs --sort="version:refname" git://github.com/git/git.git | awk -F/ 'ENDprint$NF'

【讨论】:

@tborychowski 谢谢你的例子。现在它可以工作了:)【参考方案5】:

从版本2.18 git has 开始,一个内置的--sort 选项用于对引用名称进行排序。

所以最新的命令是

git ls-remote --tags --sort="v:refname" git://github.com/git/git.git | tail -n1

要同时删除哈希和取消引用标记 (^),只需输入一些简单的 sed

git ls-remote --tags --sort="v:refname" git://github.com/git/git.git | tail -n1 | sed 's/.*\///; s/\^//'

根据@Frederik Nord 的建议,您还可以使用--refs 开关来摆脱^,只留下一个sed 命令(使oneliner 缩短4 个字符):

git ls-remote --tags --refs --sort="v:refname" git://github.com/git/git.git | tail -n1 | sed 's/.*\///'

# output: v2.18.0

对于2.18 之前的git 版本,这是通过sort 进行管道输出的组合

git ls-remote --tags git://github.com/git/git.git | sort -t '/' -k 3 -V | awk -F/ ' print $3 ' | awk '!/\^\\/' | tail -n 1

【讨论】:

--refs 是否有助于删除一个 sed 命令,即删除 ? @FrederickNord 是的,它有效,感谢您的建议【参考方案6】:

TL;DR:

% git -c 'versionsort.suffix=-' ls-remote -t --exit-code --refs --sort=-v:refname \
    https://github.com/robert7/nixnote2 'v*' \
    | sed -En '1!q;s/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/gp'  
v2.1.0-beta4g

说明

--refs 传递给git ls-remote 以摆脱其他答案中显示的 参考:

$ git ls-remote -t --refs <URL>

这会给出如下输出:

8f235769a2853c415f811b19cd5effc47cc89433        refs/tags/continuous
24e666ed73486a2ac65f09a1479e91e6ae4a1bbe        refs/tags/continuous-develop
7c2cff2c26c1c2ad4b4023a975cd2365751ec97d        refs/tags/v2.0
35b69eed46e5b163927c78497983355ff6a5dc6b        refs/tags/v2.0-beta10

要仅获取标签名称,请通过:

sed -E 's/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/g':

$ git ls-remote -t --exit-code --refs https://github.com/robert7/nixnote2.git \
  | sed -E 's/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/g'
continuous
continuous-develop
v2.0
v2.0-beta10

然后,您可以通过适当的 grep 和/或 head -n1 传递清理后的列表(如果您希望保持较低的 PID 编号,也可以添加到您的 sed 命令中。)

建议:

在命令行末尾添加一个模式以进行过滤。例如'v*',如果所有版本标签都以v开头。 传递--exit-code 以确保在没有返回匹配的引用时退出非0。 使用https:// 版本:它更快,并且如果您正在打包,您不想冒被要求提供 ssh 密钥的风险。 --sort=-v:refname 按版本而不是按字典排序,最大的版本位于顶部 使用git -c versionsort.suffix=- 防止2.0-rc 出现在“之后”2.0

【讨论】:

【参考方案7】:

对于 Git 不支持ls-remote --sort

用法:git ls-remote [--heads] [--tags] [-u | --上传包 ] [-q|--quiet] [--exit-code] [--get-url] [ [...]]

要列出最新的标签,以及较旧的 Git 版本,请使用内置的 sort 命令。

打印标签,按第二列的版本号排序(倒序):

git ls-remote --tags $my_repo | sort -Vr -k2

...哈希 id... refs/tags/v0.10.0-rc0 ...哈希 id... refs/tags/v0.9.0-rc0 ...哈希 id... refs/tags/v0.9.0 ...哈希 id... refs/tags/v0.8.1 ...哈希 id... refs/tags/v0.8.0-rc1

使用grep获取特定版本的最新标签(例如最新的0.8版本):

git ls-remote --tags $my_repo | sort -Vr -k2 | grep -Po -m 1 "tags/\K.*0.8.*"

v0.8.1

【讨论】:

以上是关于无需克隆即可从远程仓库获取最后一个 git 标签的主要内容,如果未能解决你的问题,请参考以下文章

git-从远程仓库克隆

一次性从git远程仓库中克隆到本地。

github远程标签推送,无需克隆repo

常用Git命令

git远程仓库

Git常用指令汇总