Custom Gate

The Custom Gate executes a custom Groovy script to determine status of the gate. This can be very useful to integrate other tools in pipeline to check readiness, or implement other custom logic. For example, you can write code to invoke a change management tool to determine the status of change request, or invoke issue tracking systems to update status of issue, etc).

Pipeline will execute the RUNNING gate at a regular interval, and gate will be considered complete only when it returns SUCCESSFUL or FAILED.  If the status in not returned from the script, it will be assumed SUCCESSFUL by default.

Field

Description

Field

Description

Gate Name

The name of the gate.

Description

An optional description for the gate.

Groovy Script

Groovy script to provide implementation of Gate. Return SUCCESSFUL, RUNNING or FAILED to indicate status of Gate. This can be used to provide customized implementation in pipeline to interface with external system or do any other programmatic checks.  If no status is returned, SUCCESSFUL is implied by default.

The script has access to variables and methods listed in Pipeline Groovy Variables and Methods.

Precondition

An optional Groovy script which determines whether the gate or step is applicable during execution. The script has access to variables and methods listed in Pipeline Groovy Variables and Methods. You can find these variables methods using Variable Lookup help.

The script must return true if the gate is applicable, or false otherwise.  If no script is provided, the default is to return true (applicable).

Script Variables

The following macros are not currently supported in the footer:
  • style