Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Each command can be available in different versions like v1, v2, v3, and so on. This is to support downwards compatibility in pipeline scripts. This way a newer version of a command will not break old pipeline code since it can be specified in a pipeline which exact command version to be useduse.

Which commands are available in which versions can be found in the commands reference docs.

...

Code Block
languageyaml
pipeline:
  - log:v3:
      message: "Hello World!"   

Here, we use version v4 of thelogcommand log:

Code Block
languageyaml
pipeline:
  - log:v4:
      message: "Hello World!"    

...

Instead of defining the version for each command, you can also set it globally for all commands of a pipeline using the header version. ExampleFor example:

Code Block
languageyaml
headers:
  version: v4
pipeline:
  - log:
      message: "Hello World!"

...

In case you combine the header version with the local version on a command, the local one wins:

...

In case you specify a version like v5, for example, it will be tried attempt to load the command with this exact version. In case no such command with this version exists, the next lower version will be looked up, like v4 for example. If no command with this version exists, the next lower version v3 is tried, and so on until v1 is reached which is the most minimal version and must be available for any existing command.

...