Establish box Versioning format

StackStorm / packer-st2

Packer templates for building & deploying Vagrant & OVA with StackStorm installed

https://app.vagrantup.com/stackstorm/boxes/st2

Apache License 2.0

13 stars 7 forks source link

Establish box Versioning format #14

Closed arm4b closed 6 years ago

arm4b commented 6 years ago

Establish the Vagrant & OVA box versioning format
- v2.7.1-20180501 is the version format we'll follow for now (and include in CHANGELOG)
  - Conforms with the https://semver.org/
  - v2.7.1 works as a version
  - 20180501 works as a revision (in our case the image generation date)
Keep .ova file in the same ./build directory, apart of .box file

Correct versioning will help to upload .box to the Vagrant cloud & follow the ordering.

warrenvw commented 6 years ago

Perhaps I'm not reading https://semver.org/ correctly. I read v2.7.1-20180501 as a pre-release version, per https://semver.org/#spec-item-9:

A pre-release version indicates that the version is unstable and might not satisfy the intended compatibility requirements as denoted by its associated normal version. Examples: 1.0.0-alpha, 1.0.0-alpha.1, 1.0.0-0.3.7, 1.0.0-x.7.z.92.

Do you intend v2.7.1-20180501 to be a release version? I guess this usage isn't a big deal as long as we document the format we're using.

How do we handle more than one release a day? Is this necessary to discuss now?

arm4b commented 6 years ago

You're right, - it's a formally semver pre-release :+1: Will need to include the date for version ordering & conform with semver so that looks like the needle format if we follow it when uploading the Vagrant boxes.

I don't think we need to care about 1+ release per day, at least for now. After a while when getting stable we won't touch this repo for months.