Page Comparison

apiVersion

Defines the version of the pipeline API to be used (for example: v2, v3). If not set, the latest version is used automatically.

authorization

Defines the authorization to be used for this pipeline. Has similar meaning as the HTTP Authorization header. Possible values are:

• RunAs USERNAME = Executes the given pipeline as the user with given username. This requires a valid seed authentication or a call from a trusted service.

• Bearer TOKEN = Uses the given (JWT) token for authentication.

• Basic CREDENTIALS = Uses the given credentials for authentication.

In case no authentication header is set in current pipeline, the existing authentication from the HTTP header or from the backend will be used instead.

description

An optional description of this pipeline. The text may contain at max. 250 characters. This description is also used in logs and descriptions wherever possible.

exprPrefix

Sometimes it is necessary to change the default prefix #{ of an expression to a different value. For example if this clashes with some other expression engines. Example:

expPrefix: "$"

onCommandError

Optional value to define what should happen if a single command in this pipeline has an error / exception. Possible values are:

• IGNORE = Only the exception message (not the full stacktrace) is logged as warn, but no exception is thrown, so next command in pipeline will be executed.

• LOG = The full stacktrace of the exception is logged as error, but no exception is thrown, so next command in pipeline will be executed.

• THROW = The exception is thrown and the pipeline execution is stopped at this command. This is the default behavior in case this header doesnt exist or is empty.

• RETRY; times=3; wait=2; then=THROW; If command caused an error, the command is again executed whereas all parameters are optional:

  • wait = the time to wait in seconds before the next retry starts (default = 3).

  • times = The number of retries before giving up (default = 1).

  • then = The action to do after the retry was not successfull (one of IGNORE, LOG or THROW)(default = THROW).

• ROLLBACK[uri] = Calls the given uri in order to execute a script to rollback.

  Status
  colour Red title Experimental

  (ask our support team, if you want use this)

runAs

A username of a user under which this pipeline must be executed as. It has the same functionality as the command iam.run.as.

runWhen

This header is primarily to configure a pipeline which is auto-executed on import or install but can be useful also in other cases. It defines a PE which evaluated on execution of the pipeline. If this expression returns true, the pipeline is executed, otherwise it is skipped and a info message is logged. Furthermore a warning is returned to the caller that this pipeline was skipped. If the header is not set, the pipeline is always executed.

Here is an example to run the pipeline only when in test mode:
runWhen: "#{@instance.profiles().contains('test')}"

Or when a certain namespace is set:
runWhen: "#{@instance.namespace() == 'enterprise'}"

exprPrefix

Sometimes it is necessary to change the default prefix #{ of an expression to a different value. For example if this clashes with some other expression engines. Example:

expPrefix: "$"

description

An optional description of this pipeline. The text may contain at max. 250 characters. This description is also used in logs and descriptions wherever possible.

apiVersion

Defines the version of the pipeline API to be used (for example: v2, v3). If not set, the latest version is used automatically.

authorization

Defines the authorization to be used for this pipeline. Has similar meaning as the HTTP Authorization header. Possible values are:

• RunAs USERNAME = Executes the given pipeline as the user with given username. This requires a valid seed authentication or a call from a trusted service.

• Bearer TOKEN = Uses the given (JWT) token for authentication.

• Basic CREDENTIALS = Uses the given credentials for authentication.

In case no authentication header is set in current pipeline, the existing authentication from the HTTP header or from the backend will be used insteadtracing

Since 7.5.

If this header is set to false, the pipeline and its commands are not trace logged on execution. Default is true.