Run builds and parameters

Starting a build

Select a pipeline and press Run (or ⌘↩). If the job has parameters, BuildCaptain opens a form with the right control for each type: text fields for string parameters, a larger area for text parameters, checkboxes for booleans, menus for choice parameters, and a secure field for passwords — pre-filled with the job's defaults.

From the menu bar popover you can also run pinned pipelines directly. In Settings, choose whether that button opens the form, runs immediately with default parameters, or shows both options.

Following the build

After you submit, BuildCaptain tracks the build through three phases — submitting, waiting in the queue (with Jenkins's reason, e.g. waiting for an executor), and starting on an agent — and then jumps straight to the new run's stage graph. A queued build can be cancelled at any point before it starts.

Stopping and rerunning

• Stop (⌘.) interrupts the selected running build, after a confirmation.
• Rerun starts a finished run again with the same Pipeline script and the same parameters (Jenkins's rerun, via the Pipeline Graph View plugin).

Picking runs

The run picker above the graph lists the pipeline's recent builds with their status. Selecting an older run shows its graph and logs exactly as they were.

Notifications

When notifications are enabled, BuildCaptain tells you when a build you started finishes — whatever pipeline you're looking at meanwhile.