SaltStack Version Numbers - 怎样理解SaltStack的版本号命名逻辑

Salt使用基于主要功能的和基于补丁的系统来获取版本号。 版本号的格式为MAJOR.PATCH。

注意

在3000版本之前，Salt使用基于日期的系统作为版本号。 版本号的格式为YYYY.MM.R。 创建发行版时反映的年份（YYYY）和月份（MM）。 错误修正版本号（R）在该功能版本中以递增的形式出现。

注意

在2014.1.0版本之前，仍在使用典型的语义版本控制。 由于项目的滚动性质，这没有任何意义。 0.17版本是该样式的最后一个版本。

Code Names - 代码名称

为了区分将来的版本和当前的版本，使用了代码名称。 元素周期表被用来导出下一个代号。 基于日期的系统中的第一个版本是代号为Hydrogen的代码，每个后续版本将转到下一个原子的序号。

目前已经分配了的代码名称有:

• Hydrogen: 2014.1.0
• Helium: 2014.7.0
• Lithium: 2015.5.0
• Beryllium: 2015.8.0
• Boron: 2016.3.0
• Carbon: 2016.11.0
• Nitrogen: 2017.7.0
• Oxygen: 2018.3.0
• Fluorine: 2019.2.0
• Neon: 3000
• Sodium: 3001
• Magnesium: 3002
• Aluminium: 3003

Example - 示例

举个例子可能会有助于阐明这一切的工作方式。

例如，当前的代号是Iodine。 准备好要发行的发行版，以前的发行版是3053。，则这次新发行版的编号为3054。在发布三个补丁之后，发行版的编号将为3054.3。

当剪辑得到新的release版本后，将以Xenon代号使用新功能，然后继续重复该过程。

Version numbers, Git and salt --version

编程人员使用 git describe 来登记salt version信息，并通过 salt --version 展示给最终用户。

git checkout 的参数示例:

Argument	Comment
master	Master branch Actively developed bug-fixes and new features
v3000	Tag signaling the commit for 3000 release.
v3000.1	Tag signaling the commit for a 3000.1 patch fix.

更多的说明信息请阅读 release branch and develop branch 。

git checkout 的参数对git describe展示结果上的影响:

Checkout	Describe	Comment
v3000	v3000	(tag is fixed point in time)
v3000.1	v3000.1	(tag is fixed point in time)
master	v3000.1-9-g10d5dec	Commit of most recent tag in master

继续查看v3000.1-9-g10d5dec 的详细信息(在 git checkout master 后继续使用 git describe ):

Part	Comment
v3000.1	git describe finds the most recent tag on the 2016.11 branch
9	Commits on top of the most recent tag, relative to your local git fetch
gf2eb3dc	‘g’ + git SHA (“abbreviated name”) of the most recent commit