Workflow Content Versioning
When using Steps of the action, plugin and workflow you must specify the name of the desired resource. You can do this in StackSpot following the reference:
studio-name/resource-name@version
This reference requires you to specify the resource version. Semantic versioning in StackSpot uses the format major.minor.revision, where the minor and revision numbers are optional.
See the examples of how versions can be represented:
- @1: Any version >= 1.0.0 and < 2.0.0;
- @2.1: Any version >= 2.1.0 and < 2.2.0;
- @1.1.1: The exact version of the Action, Plugin, or Workflow.
The following range operators can be specified: >, >=, <, <=, ^, ~, =*, no operator, and - (interval).
You can specify more complex version ranges as well. Below is a complete list of example ranges and the corresponding interval for each operator and version combination:
| Range Example | Covered range |
|---|---|
> 1.2.3 | >= 1.2.4 <2.0.0 |
>= 1.2.3 | >= 1.2.3 <2.0.0 |
< 1.2.3 | >=1.0.0 <1.2.3 |
<= 1.2.3 | >=1.0.0 <1.2.4 |
^ 1.2.3 | >=1.2.3 <2.0.0 |
~ 1.2.3 | >=1.2.3 <1.3.0 |
= 1.2.3 | >=1.2.3 <1.2.4 |
| (without operator) 1.2.3 | >=1.2.3 <2.0.0 |
> 1.2 | >=1.3.0 <2.0.0 |
>= 1.2 | >=1.2.0 <2.0.0 |
< 1.2 | >=1.0.0 <1.2.0 |
<= 1.2 | >=1.0.0 <1.2.1 |
^ 1.2 | >=1.2.0 <2.0.0 |
~ 1.2 | >=1.2.0 <1.3.0 |
= 1.2 | >=1.2.0 <1.3.0 |
| (without operator) 1.2 | >=1.2.0 <2.0.0 |
> 1 | Not possible, as it would cause a major version break. |
>= 1 | >=1.0.0 <2.0.0 |
< 1 | Not possible, as it would cause a major version break. |
<= 1 | >=1.0.0 <1.0.1 |
^ 1 | >=1.0.0 <2.0.0 |
~ 1 | >=1.0.0 <2.0.0 |
= 1 | >=1.0.0 <2.0.0 |
| (without operator) 1 | >=1.0.0 <2.0.0 |
| 1.2.3 - 2.3.4 | >=1.2.3 <=2.3.4 |
| 1.2.3 - 2.3 | >=1.2.3 <2.4 |
| 1.2.3 - 2 | >=1.2.3 <3 |
| 1.2 - 2.3.4 | >=1.2.0 <=2.3.4 |
| 1 - 2.3.4 | >=1.0.0 <=2.3.4 |
| 1.2 - 2.3 | >=1.2.0 <2.4 |
| 1 - 2 | >=1.0.0 <3 |
For more details, refer to the page containing all the semantic versioning ranges.