一、簡介 |
在持續集成中,版本管理是非常重要的一部分,本章將介紹如何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