In October 2018, the "x.y.z" version numbering system for Puppet Enterprise (PE) changed so that the first number ("x") changes only when PE adopts a new major version of the Puppet Platform.
We made this change to so that it's easier for you to determine whether a release contains potentially high-impact breaking changes. Previously, the "x" part of the version number incremented with each new calendar year, whether or not there were breaking changes in the release.
|Type of change||Major "x" releases||Minor "y" releases||Patch "z" releases|
|Low-impact breaking changes||yes||yes||no|
|High-impact breaking changes||yes||no||no|
For example, if you are using PE 2018.1.3, then upgrading to PE 2019 likely introduces changes that involve updating your Puppet code, depending on what features you use and what we added. Upgrading to 2018.1.4 will only fix bugs and security problems, and maybe slightly adjust how a feature looks, but not greatly change how it works or how you interact with it.
The first release to use the updated system is Puppet Enterprise 2019.0. Older release streams will follow the previous version numbering system.
For information about active PE releases, mainstream and extended support, and end of life dates, see Puppet Enterprise support lifecycle.
Open source version numbers
All of our open source projects—including Puppet, PuppetDB, Facter, and Hiera—use semantic versioning ("semver"). This means that in an x.y.z version number, the "y" will increase if new features are introduced and the "x" will increase if existing features change or get removed.
Our semver only refers to the code within that project; it's possible that packaging or interactions with other projects might cause new behavior in a "z" upgrade of Puppet.