无需克隆即可从远程仓库获取最后一个 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 标签的主要内容,如果未能解决你的问题,请参考以下文章