一、简介

在持续集成中,版本管理是非常重要的一部分,本章将介绍如何Version Number Plug插件生成优雅的版本号。

 

二、安装

系统管理--》插件管理

搜索 Version Number--》直接安装

jenkins 指定yarn版本 jenkins 版本号_字符串

三、构建中使用

一、配置

找到项目--》配置--》构建环境

jenkins 指定yarn版本 jenkins 版本号_字符串_02

变量说明:

BUILD_VERSION:变量名

${JOB_name}:项目名称

${BUILD_DATE_FORMATTED, "yyyyMMdd"}:格式化后的日期

${BUILDS_TODAY}:今天构建的数量

二、使用

这里为了方便我们直接调用shell看效果

echo ${BUILD_VERSION}

编译生成的版本号为:

yk-jifen-test_20180118.2

 

四、详细使用

 

版本号格式字符串

处理版本号格式字符串以创建存储在命名的环境变量中的版本号。版本号格式字符串中的每个字符都被传递到最终版本号,除了$ {}中包含的变量外。例如,版本格式字符串1.0。$ {BUILDS_THIS_YEAR},如果这是该日历年的第10个版本,则将返回1.0.10。

以下是在版本号格式字符串中使用的有效变量:

 

 

BUILD_DATE_FORMATTED

获取第二个参数,并为给定的构建日期返回一个java格式的日期字符串。例如,$ {BUILD_DATE_FORMATTED,“yyyy-MM-dd”}会返回日期(而不是时间),如2009-10-01。日期格式字符串必须用引号括起来,格式字符串中的任何空格都是重要的。

BUILD_DAY

没有参数,它只是返回构建的一天作为一个整数。如果有一个参数,它需要参数中的字符数,并使用填充日期字符串。例如,如果是本月的第三天,$ {BUILD_DAY}将返回3,$ {BUILD_DAY,X}将返回3,$ {BUILD_DAY,XX}将返回03。

BUILD_WEEK

返回BUILD_DAY的相同参数约定

BUILD_MONTH

返回月份,使用与BUILD_DAY相同的参数约定

BUILD_YEAR

返回BUILD_DAY的相同参数约定

BUILDS_TODAY

返回今天发生的构建的数量,包括这个。这在午夜重置。参数约定与BUILD_DAY相同

BUILDS_THIS_WEEK

返回本周发生的构建数量,包括这一个。这在一周的开始重置。参数约定与BUILD_DAY相同

BUILDS_THIS_MONTH

返回本月发生的构建数量,包括这一个。这在本月的第一个月重置。参数约定与BUILD_DAY相同

BUILDS_THIS_YEAR

返回今年发生的构建数量。这在今年的第一个重置。参数约定与BUILD_DAY相同。

BUILDS_ALL_TIME

返回自项目开始以来发生的构建数量。这与hudson内部版本号不同,因为它可以定期重置(例如,从1.0。$ {BUILDS_ALL_TIME}移到2.0。$ {BUILDS_ALL_TIME},并且可以配置为以任意数字开始而不是标准开始日期。

MONTHS_SINCE_PROJECT_START

自项目开始日期以来的月数。这严格依赖于当前版本的月份和项目开始日期的月份; 如果项目在10月31日开始,并且构建在11月1日,那么这将返回1.如果项目从10月1日开始,并且构建在11月30日,这也将返回1.参数约定与BUILD_DAY相同。

YEARS_SINCE_PROJECT_START

项目开始日期以来的年数。像MONTHS_SINCE_PROJECT_START一样,这仅取决于年份;

其他

在$ {}中包含的任何其他参数被替换为具有相同名称的环境变量(如果有的话),或者失败,则被忽略。例如,这可以用来集成源代码控制版本号。

更多参考:https://wiki.jenkins.io/display/JENKINS/Version+Number+Plugin