Pre-deploy Step
The Pre-deploy step executes the Pre-deploy workflow of a single named project from the snapshot to the stage. The project must have a configured Pre-deploy Workflow in the project configuration screen for the step to run.
Field | Description |
---|---|
Name | The name of the step. |
Description | An optional description for the step. |
Project | The name of the project in the snapshot to run the Pre-deploy workflow. Â This project must be in the snapshot, or the deployment will fail. |
Package | Only applicable if partial deployment project is selected. If package name is provided that package will execute pre-deploy, if package name is left blank then All Files will go through pre-deploy. If specific project/package combination is not part of release then this step will fail. |
Force | Whether or not to force deploy the project.  If true, this is equivalent to checking force deploy when individually deploying a project to an environment through the deploy request form.  Optionally, use a Groovy expression to make this field dynamic based on some contextual value (e.g. a property defined on the pipeline, and specified on the release). Checking this will cause the Pre-deploy workflow to run even if the same project (package for partial deploy) version is already deployed to this stage (environment). |
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 and methods while using the Groovy Editor. The script must return true if the step is applicable, or false otherwise. Â If no script is provided, the default is to return true (applicable). |
On Error | |
Continue | If checked, any failure will be ignored, and the pipeline execution will continue. |
Notify Pipeline Role | Selects one or more roles from the pipeline definition to notify in case of error. Default role members are defined on the pipeline, and optionally overridden for each release. Optionally, use a Groovy expression to make this field dynamic based on some contextual value (e.g. a property defined on the pipeline, and specified on the release). When using a role script you can dynamically return a key/value pair. For example |
Pre-deploy uses a named project which reduces the generic nature of pipelines, as it requires that the specific project is in the release and snapshot. Â To make the pipeline more generic, and therefore reusable, you should try to avoid tying it to specific projects where possible by using the Pre-deploy All step instead.
The Pre-deploy step allows the output from the Pre-deploy workflows to flow into the Deploy workflow inputs. For this to work, workflow developers must use the same name and data type for the Pre-deploy output(with "Return As Output" selected) and Deploy input variables in the respective workflows.
Script Variables
- style