使用 Jenkins 生成构建版本

Question

我正在想办法在 Git 中的项目上创建构建标签

我的想法是让 Jenkins 进行如下文章所示的标记。

根据这篇文章： http://www.nailedtothex.org/roller/kyle/entry/configuring-automatic-push-by-successfully

我的理解是版本号要通过以下方式生成：

(Major version).(Minor version).(Revision number).(Build number)

1.2.3 (11BCF) <- Build number, should correspond with a revision in source control
^ ^ ^
| | |
| | +--- Minor bugs, spelling mistakes, etc.
| +----- Minor features, major bug fixes, etc.
+------- Major version, UX changes, file format changes, etc.

根据此消息： https://softwareengineering.stackexchange.com/questions/3199/what-version-naming-convention-do-you-use

我的项目有 4 个级别，即 PRODUCTION、TEST、CONSOLIDATION、DEVELOPMENT。

版本看起来像

 PRODUCTION    (generate deploy build only if major/minor/revision number changes)
     ^         (send to STABLE repository)
     |
   TEST        (generate deploy build only if major/minor/revision number changes)
     ^
     |
CONSOLIDATION  (generate all of the time)
     ^
     |
DEVELOPMENT    (generate all of the time)

如何修复 $BUILD_NUMBER 以便它 ($BUILD_NUMBER) 是根据以下方式生成的： （主要版本）。（次要版本）。（修订号）。（内部版本号）

我可以将什么传递给 Jenkins 作业（在配置期间），以便它识别 （主要版本）。（次要版本）。（修订号）

有没有更好的方法来实现这一点？

TIA

Answer 1

您无法更改 BUILD_NUMBER，由 Jenkins 按顺序管理。

但是您可以确保您的 Jenkins 作业构建步骤之一生成一个标签（遵循 semver convention），然后最后一次重新编译您的项目，并使用这些版本信息生成一个属性文件。

见“Applying the existing tag on a new commit in Git”。

这使用了ktoso/maven-git-commit-id-plugin maven 插件。
它允许您的项目在运行时引用此生成的属性（键/值）文件，您可以在其中找到 X.Y.Z 以及 Git SHA1。
该插件将为您运行git describe：

描述结果的格式定义为：

v1.0-2-g2414721-DEV
 ^   ^  ^       ^
 |   |  |       \-- if a dirtyMarker was given, it will appear here if the repository is in "dirty" state
 |   |  \---------- the "g" prefixed commit id. The prefix is compatible with what git-describe would return - weird, but true.
 |   \------------- the number of commits away from the found tag. So "2414721" is 2 commits ahead of "v1.0", in this example.
 \----------------- the "nearest" tag, to the mentioned commit.