repo打了 tag之后如何提交tag_repo 导出本地 git tag 给他人

本文介绍了如何使用repo工具自动化地将本地Git仓库的tag同步到其他人的本地环境,详细解析了整个过程,包括获取commit信息、排除无tag仓库、定制git log格式以及生成可执行脚本,以简化多人协作中tag的同步问题。
摘要由CSDN通过智能技术生成

背景

使用 repo 管理了多个 git 仓库,有时需要将本地仓库的tag同步给其他人,但又不能直接推到远程(例如权限问题)。

实际场景举例

本地复现了一个问题,需要让其他人回退到相同环境来排查。

本地集成验证好了一个版本需要发布,打好tag却没有权限推送,得告知各个仓库负责人在同样的commit上打tag并推送到远程仓库。

仓库少的话,简单告知下各个仓库对应的commit号就可以了,对方手工找到对应的commit号进行操作。

涉及的仓库数量多或者本地 tag 可能发生变更需要多次同步的时候,手工操作就比较麻烦了。

自动化脚本

让我们来考虑下如何让同步本地 tag 这个事情变得简单些。(不看实现过程的话,可直接拉到最后总结部分)

后续演示基于一个简单的repo环境

mkdir test-repo;

cd test-repo;

repo init -u https://github.com/zqb-all/zqb-manifest

repo sync

#打上tag方便后续测试

repo forall -c git tag test-v1

基础命令

tag名是已知的,要提取的关键信息就只有 仓库 和 commit号。

repo可以帮我们遍历所有仓库,在每个仓库下执行git命令,使用方式是repo forall -c git xxx。

已知tagname,要获取commit号,可以通过git log tagname列出对应的commit,我们只需要一个commit,于是可以加上-1参数只列出一个提交。

组合一下就得到了

#!/bin/bash

# v1

tag=$1

repo forall -c git log -1 $tag

试试效果,

$ ./repo_share_tag.sh test-v1

commit e9e78ee6df545fb057eb6baaaf9446327cabdfa7

Author: zhuangqiubin

Date: Mon Apr 6 00:14:54 2020 +0800

fix typo

commit 059c803e9f1d0df8e5c89aec11340224c1d85f0e

Author: zqb-all

Date: Fri Aug 30 10:11:51 2019 +0800

fix save name, support vim

以下省略多个commit信息

得到的结果是每个仓库对应这个tag的commit打印。

有几个问题。

没有打印仓库名

对于没有打上该tag的仓库,git log会有报错信息

打印的冗余信息太多,例如时间,commit信息等,都无关紧要,只需要唯一的commit号即可

定制格式

问题1和2可以通过为repo forall加上-p参数来一并解决。

使用repo forall -p -c git xxx,会打印出仓库路径,并忽略错误。

问题3可以通过定制git log的格式来解决。

我是想到了平时一直在使用的一个git的alias,它可以定制git log的显示格式。

$cat ~/.gitconfig | grep "lg"

lg = log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)%Creset' --abbrev-commit

明显看出用--pretty=format就可以指定格式,各个参数的含义对照执行结果也容易猜测出来,不想猜就通过man git log来确认下。

如果平时没用过定制的git log输出,只要有这个想法,搜索一下也有很多介绍。

既然有git原生提供的功能,就不要自己费力气去过滤处理了。

所以问题3的解决方式是,加上--pretty=format:'%h'参数。

修改后为

#!/bin/bash

# v2

tag=$1

repo forall -p -c git log -1 $tag --pretty=format:'%h'

此时就没有冗余信息了,输出格式清爽多了。

$ ./repo_share_tag.sh test-v1

project python/convertfb/

774ddb6

project rust/cut-trailing-bytes/

e9e78ee

project shell/EasierMinicom/

059c803

project shell/PathMarker/

4b6e219

project shell/pop-up-task-diary/

5d85ed2

project shell/smartbc/

9d7bc06

生成脚本

导出轻松了,但接收方还是得手工打tag。

能不能直接生成一个脚本,给到接收方运行,自动打tag呢 ?

观察下这个输出,规律很简单,一行仓库路径,一行commit号。如果每两行合为一行,再适当插入一些shell命令,应该就可以得到shell脚本了。

两行合并为一行,根据经验sed和awk应该都能做,具体命令就得搜索下了,简单搜索可得到

sed -n '{N;s/\n/\t/p}' test //sed的方法

awk '{tmp=$0;getline;print tmp"\t"$0}' test //awk方法

观察下,awk似乎更方便进一步定制,那就选awk吧

#!/bin/bash

# v3

tag=$1

repo forall -p -c git log -1 $tag --pretty=format:'%h' | awk '{tmp=$0;getline;print tmp"\t"$0}'

得到的结果

$ ./repo_share_tag.sh test-v1

project python/convertfb/ 774ddb6

project rust/cut-trailing-bytes/ e9e78ee

project shell/EasierMinicom/ 059c803

project shell/PathMarker/ 4b6e219

project shell/pop-up-task-diary/ 5d85ed2

project shell/smartbc/ 9d7bc06

以上的project我们是不要的,只要保留 仓库path 和 commit。这一点可以将awk命令中的$0改成$2来实现,$0是整行,$1对应project,$2则刚好是我们需要的path。

另外得再插入一些固定的字符,将 变成 cd ; git tag tagname,考虑处理完一个仓库后还得要退回源目录,方便处理下一个仓库,那再加个 cd -。cd -表示回到上一个目录,很实用的命令。

以上都可以通过修改awk命令来实现,修改后得到:

#!/bin/bash

# v4

tag=$1

repo forall -p -c git log -1 $tag --pretty=format:'%h' | awk '{tmp=$2;getline;print "cd "tmp"; git tag '$tag' "$1"; cd -;"}'

看起来差不多了,重定向到文件中,加上必要的sheban,即#!/bin/bash

#!/bin/bash

# v5

tag=$1

file=set-tag-$tag.sh

echo "#!/bin/bash" > $file

echo "" >> $file

repo forall -p -c git log -1 $tag --pretty=format:'%h' | awk '{tmp=$2;getline;print "cd "tmp"; git tag '$tag' "$1"; cd -;"}' >> $file

chmod +x $file

#for debug

cat $file

执行后可得到set-tag-test-v1.sh脚本

$cat ./set-tag-test-v1.sh

#!/bin/bash

cd python/convertfb/; git tag test-v1 774ddb6; cd -;

cd rust/cut-trailing-bytes/; git tag test-v1 e9e78ee; cd -;

cd shell/EasierMinicom/; git tag test-v1 059c803; cd -;

cd shell/PathMarker/; git tag test-v1 4b6e219; cd -;

cd shell/pop-up-task-diary/; git tag test-v1 5d85ed2; cd -;

cd shell/smartbc/; git tag test-v1 9d7bc06; cd -;

接收方运行这个脚本即可。

完善脚本

实际验证下,很快发现问题

已经打过了tag需要更新,重复打会报错,需要先删除同名tag

如果接收方代码中不存在对应的commit(例如代码未更新),虽然会报错,但脚本没有暂停,可能会让人忽略该报错

没有提示处理的仓库路径

存在冗余信息,例如 cd - 会打印路径,其实是没作用的

解决方式

打tag之前先删除原有同名tag,即执行git tag -d $tag,再考虑tag可能不存在会报错,加上错误log重定向2>/dev/null

打tag失败则中止运行,即加上|| exit 1

cd之前,先打印目标路径, 即加上 echo tmp

屏蔽掉cd -的输出, 即加上 > /dev/null

顺便加点换行,调整下输出的脚本,可得到

#!/bin/bash

# v6

tag=$1

file=update-tag-$tag.sh

echo "#!/bin/bash" > $file

echo "" >> $file

repo forall -p -c git log -1 $tag --pretty=format:'%h' | awk '{tmp=$2;getline;print "echo "tmp"\ncd "tmp"\ngit tag -d '$tag' 2>/dev/null\ngit tag '$tag' "$1" || exit 1\ncd - > /dev/null\n"}' >> $file

chmod +x $file

#for debug

cat $file

此时生成的打tag脚本就变成了

$ cat ./update-tag-test-v1.sh

#!/bin/bash

echo python/convertfb/

cd python/convertfb/

git tag -d test-v1 2>/dev/null

git tag test-v1 774ddb6 || exit 1

cd - > /dev/null

echo rust/cut-trailing-bytes/

cd rust/cut-trailing-bytes/

git tag -d test-v1 2>/dev/null

git tag test-v1 e9e78ee || exit 1

cd - > /dev/null

echo shell/EasierMinicom/

cd shell/EasierMinicom/

git tag -d test-v1 2>/dev/null

git tag test-v1 059c803 || exit 1

cd - > /dev/null

echo shell/PathMarker/

cd shell/PathMarker/

git tag -d test-v1 2>/dev/null

git tag test-v1 4b6e219 || exit 1

cd - > /dev/null

echo shell/pop-up-task-diary/

cd shell/pop-up-task-diary/

git tag -d test-v1 2>/dev/null

git tag test-v1 5d85ed2 || exit 1

cd - > /dev/null

echo shell/smartbc/

cd shell/smartbc/

git tag -d test-v1 2>/dev/null

git tag test-v1 9d7bc06 || exit 1

cd - > /dev/null

最后加点提示语句,参数检查

#!/bin/bash

show_help()

{

echo -e "Usage: share_tag.sh "

echo -e 'Eg. ./share_tag.sh release-v1'

}

[ x"$1" = x"" ] && {

show_help

exit 1

}

tag=$1

file=update-tag-$tag.sh

echo "#!/bin/bash" > $file

echo "" >> $file

repo forall -p -c git log -1 $tag --pretty=format:'%h' | awk '{tmp=$2;getline;print "echo "tmp"\ncd "tmp"\ngit tag -d '$tag' 2>/dev/null\ngit tag '$tag' "$1" || exit 1\ncd - > /dev/null\n"}' >> $file

chmod +x $file

#for debug

cat $file

echo -e '\033[0;31;1m'

echo "to update tag $tag, please run ./$file"

echo -e '\033[0m'

总结

本地已打好tag,如 test-v1,需要分享给他人则运行./repo_share_tag.sh test-v1

本地没有tag,那可以先批量打一个tag,再如上所述导出脚本给他人。

批量打tag : repo forall -c git tag test-v1

批量删tag : repo forall -c git tag -d test-v1

东拼西凑出来的脚本,暂时也够用了,后续有更新会放到 https://github.com/zqb-all/repo-share-tag

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值