Pipeline: Build Step

ID: pipeline-build-step

Jenkins Plugin Changelog Jenkins Plugin Installs


Adds the Pipeline build step, which triggers builds of other jobs.

Passing secret values to other jobs

The recommended approach to pass secret values using the build step is to use credentials parameters:

build(job: 'foo', parameters: [credentials('parameter-name', 'credentials-id')])

See the user guide for the Credentials Plugin for a general overview of how credentials work in Jenkins and how they can be configured, and the documentation for the Credentials Binding Plugin for an overview of how to access and use credentials from a Pipeline.

The build step also supports passing password parameters, but this is not recommended. The plaintext secret may be persisted as part of the Pipeline's internal state, and it will not be automatically masked if it appears in the build log. Here is an example for reference:

build(job: 'foo', parameters: [password('parameter-name', 'secret-value')])

Version History

See the changelog.

ArchivesGet past versions
Version: 2.13
Requires Jenkins 2.176.4
Installs: 268,357
Jesse Glick
Andrew Bayer
Sam Van Oort
Devin Nusbaum
Carroll Chiou
Liam Newman
Karl Shultz
Help us improve this page!
To propose a change submit a pull request to the plugin page on GitHub.
Previous Security Warnings