Compatibility and Versioning
This topic describes Pivotal Platform Automation dependencies and semantic versioning.
We have tested Platform Automation with these dependencies.
|Platform Automation||Concourse||Ops Manager||Pivnet Resource|
Ops Manager 2.5
The filename for the artifact downloaded from Ops Manager is changed! If your resources or pipelines have a regex for the Ops Manager filename, you may be affected. (Please see Ops Manager's official notice for more information)
This product uses semantic versioning 2.0.0 to describe the impact of changes to our concourse tasks. In order to take advantage of semantic versioning, we must declare an API.
The following are considered part of our API:
Our concourse tasks':
- inputs and outputs (including the format/required information in config files)
- specified parameters
- intended and specified functionality
These are all documented for each task within the task files themselves.
Additionally, the minimum compatible version of Concourse and Ops Manager are part of the API, and are specified here.
The following are NOT covered:
omcommand line tool
p-automatorcommand line tool
- the dependencies on the image intended to be used with our tasks
- non-specified parameters (for instance, any env var used by a CLI we call but not specified as a parameter on the task)
- properties specific to particular product or ops manager versions in config files (which are governed by the product being configured, not our tooling)
In general, if we make any change that we anticipate could not be consumed automatically, without manual changes, by all users of our Concourse tasks, we consider it a breaking change, and increment the major version accordingly.
This assumes that the required image can be made automatically available; each version of our tasks is designed for and tested with only the version of the image that shipped with it.
If we accidentally violate our semver, we will publish an additional version addressing the problem. In some cases, that may mean releasing ths same software with a corrected version, and shipping a new patch version identical to the version prior to the violation. In others, it may mean releasing an additional patch version which reverts an unintentional breaking change.
This should make it safe to automatically consume our release. Patch releases should be very safe to automatically update to. Minor versions should be safe, but it can be more difficult to anticipate the effect of new features, so this is slightly riskier. Major versions should be expected to break for at least some users when consumed automatically. Automatic consumption of major versions should be limited to test/staging environments intended to endure and detect such breakage.