Trigger a Run Manually
You can trigger a run of any step through the pipeline visualization. To manually run the entire pipeline, trigger the first step in the workflow.
With default configuration
To manually trigger a step:
- Click the step you want to trigger.
This displays the information box for that step. - In the step's information box, click the "Trigger this step" button.
The step executes, and its successful completion triggers the subsequent steps of the pipeline. The record of the run is logged in the pipeline history.
With custom configuration
You can trigger a run of any step and provide a set of custom settings to test a specific set of conditions.
To manually trigger a step with custom settings:
- Click the step you want to execute.
This displays the information box for that step. - In the step's information box, click the "Trigger this step with custom configuration" button.
In the resulting Run with custom configuration dialog, you can override the configuration settings, then click Confirm.
For more information, see the section Environment Variables Configuration.
The step executes with the custom settings, and its successful completion triggers the subsequent steps of the pipeline. The record of the run is logged in the pipeline history.
View Step Execution
You can view the shell commands issued as the step is executing.
To view real-time execution of a step:
- Trigger the step you want to execute.
- While the step executes, click the step.
This displays the information box for that step. In the information box, click Logs.
This displays the step log view Pipeline Run Logs view, where you can see the shell commands issued by the step as they are executed.
View Step History
There could be times when you want to view a step's execution history, to view the previous time a step was triggered or for debugging purposes.
To view a step's history:
- Click the step.
- Click Step History.
This displays the Step History window, which shows various details about the step. - Use the filter option to filter the step by status.
Cancel Runs and Steps
When a run is in progress, you may want to cancel a step or the run to either update the pipeline or free up resources.
You can cancel:
- A specific active step
- A specific active run
- All active runs
Only runs in non-terminal status (Processing, Cancelling, and so on) or waiting in queue to be executed can be canceled. Runs in terminal status (Success, Error, and Failure) cannot be canceled.
Cancel a Specific Step
You can cancel execution of a run in progress by cancelling execution of a step. When a step is canceled, all subsequent dependent steps of the pipeline are skipped. The record of the run is logged in the pipeline history.
To cancel a step:
- While the step executes, click the step.
This displays the information box for that step. - In the information box, click the Cancel This Step button.
or
- While the step executes, click the active run and hover over the step you want to cancel.
- Click the Cancel icon that appears on the right-hand side.
- Click Confirm.
Cancel a Specific Run
To cancel a specific run:
In the Pipelines tab:
- Click the Pipelines tab and click the relevant pipeline.
- Click the Cancel button on the right-hand side.
Click Confirm.
or
In the Active Runs tab:
- Click the Active Runs tab and click the relevant pipeline.
- Hover over the run you want to cancel.
- Click the Cancel icon that appears on the right-hand side.
- Click Confirm.
Cancel Multiple Runs
To cancel multiple runs:
- In the Active Runs tab, click the check box for the runs you want to cancel.
Or click the check box on top to select all the active runs. - Click the Cancel icon on top.
- Click Confirm.