Git Describe 与 TRAVIS_TAG学习笔记

1、工具概念

1.1、TRAVIS_TAG

Travis CI 内置环境变量,仅当触发构建的事件是 Git 标签(Tag)时才会被赋值,值为标签名称(如 v1.0.0、2.1.1);非标签触发的构建(如提交代码、合并分支),该变量为空。在推送tag到云端服务器时,TRAVIS_TAG会临时生成为云端服务器的环境变量,在云端使用

1.2、git describe

Git 原生命令,用于生成基于最新标签的详细版本描述,格式为:最新标签名-提交次数-最新提交哈希前缀

示例:v1.0.0-5-g2a1f8c9

  • v1.0.0:距离当前最近的标签
  • 5:当前提交比该标签多 5 次提交
  • g2a1f8c9:当前最新提交的哈希前缀(g 代表 Git)

2、git describe 加 --tags 和不加的区别

这是最容易踩坑的点,直接决定命令能否找到你的标签

2.1、不加--tags(默认)

只识别「带注释的标签」,忽略「轻量标签」。

命令:git describe

适用:仅使用标准注释标签的项目

问题:如果你的标签是用 git tag v1.0.0(轻量标签)创建的,命令会报错 fatal: No names found, cannot describe anything.

2.2、加tags

识别所有标签(包含轻量标签 + 注释标签),兼容性最强。

命令:git describe --tags

适用:绝大多数项目(包含混用两种标签的场景)

优势:不会因为标签类型导致构建失败

2.3、加上 --always --tags

在 --tags 基础上增加 --always,无任何标签时直接返回提交哈希,彻底避免命令报错 。

命令:git describe --always --tags

结果示例:2a1f8c9(纯提交哈希)

2.4、注释标签和轻量级标签的区别

分别找一个注释标签1.2和轻量级标签1.2.1执行git show tag,输出内容如下:

bash 复制代码
# 执行git show 1.2
git show 1.2
tag 1.2  # 注释标签这里会有一行tag输出
Tagger: Garrett D'Amore <garrett@damore.org>
Date:   Mon Apr 18 19:35:25 2022 -0400

Version 1.2 - adds IPv6 support
# 执行git show 1.2.1, 可以看到直接是commit的信息
git show 1.2.1
commit fc3f684a80151a3319446fc96083a9ff384ee4fe (tag: 1.2.1, origin/master, origin/HEAD)
Author: Garrett D'Amore <garrett@damore.org>
Date:   Sat Feb 3 14:45:24 2024 -0800

    Drop CircleCI.
相关推荐
一条破秋裤14 小时前
【1115】【多线程】【笔记】
前端·chrome·笔记
神明不懂浪漫15 小时前
【第八章】多线程(一)
java·开发语言·经验分享·笔记
星恒随风17 小时前
MySQL 从零入门(九):事务管理详解——ACID、COMMIT、ROLLBACK、SAVEPOINT 与四种隔离级别
linux·服务器·数据库·笔记·mysql
蒸蒸yyyyzwd17 小时前
秋招操作系统错题本
笔记·八股
星恒随风17 小时前
MySQL 从零入门(十一):视图与用户权限管理详解
linux·服务器·数据库·笔记·mysql
山楂树の18 小时前
Java 泛型:泛型类、泛型方法、泛型接口与通配符
java·开发语言·笔记
重生之我是萧炎20 小时前
PR安装教程,Adobe Premiere Pro安装教程(含安装包),仅供学习使用
学习·adobe
努力写代码的熊大21 小时前
Linux 个人复盘博客 · 第六篇 Linux 进程间五种通信:匿名管道、命名管道、共享内存、消息队列与信号量
linux·经验分享·笔记
蒸蒸yyyyzwd21 小时前
深搜广搜学习笔记
笔记·学习
小七在进步21 小时前
string的实现(3)
开发语言·c++·笔记·visual studio