| 一、简介 |
在持续集成中，版本管理是非常重要的一部分，本章将介绍如何Version Number Plug插件生成优雅的版本号。
| 二、安装 |
系统管理--》插件管理
搜索 Version Number--》直接安装
| 三、构建中使用 |
一、配置
找到项目--》配置--》构建环境
变量说明：
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
