[MESOS-1987] Add support for SemVer build and prerelease labels to stout.

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.2.1, 1.3.0, 1.4.0
• Component/s: stout
• Labels: mesosphere
• Target Version/s: 1.2.1, 1.3.0, 1.4.0
• Epic Link: Disallow old Mesos agents
• Assignee: Neil Conway
• Reporter: Kapil Arya
• Shepherd: Benjamin Mahler
• Created: 23/Oct/14 23:35
• Updated: 10/May/17 05:00
• Resolved: 03/May/17 22:43

Description

Currently, the Version class handles strings of the form X.Y.Z only. A recent patch (https://reviews.apache.org/r/27115/) allows for strings of the form X.Y.Z-* by discarding the "-" along with the rest of the string following it. This means that the check `Version("0.20.1") == Version("0.20.1-rc2")` will succeed.

A better fix is to allow arbitrary number of components in the Version string and still do the right thing w.r.t. comparisons. To standardize it a bit, we can consider Semantic Versioning (http://semver.org/).

Semantic Versioning allows for strings of the following tagformat:
<code>
"MAJOR.MINOR.PATCH-IDENTIFIER[.IDENTIFIER]*"
</code>

An IDENTIFIER must comprise only ASCII alphanumerics and hyphen [0-9A-Za-z-].

One way to implement it in the Version class is to keep a vector of (string) identifiers along with major, minor, and patch variable. Another alternative is to not have the major, minor, and patch variables and just have a single vector of strings.

The comparison can be tricky. One has to consider the pre-release version, etc. as explained in SemVer 2.0.0 RFC.

Issue Links

• relates to: MESOS-7389 Mesos 1.2.0 crashes with pre-1.0 Mesos agents.
• relates to: MESOS-6976 Disallow (re-)registration attempts by old agents.