Pipeline: Build Step

Jenkins Plugin Changelog Jenkins Plugin Installs

Introduction

Adds the Pipeline build step, which triggers builds of other jobs. Use the "Pipeline Syntax" Snippet Generator to get a detailed example for your build step. The Pipeline Syntax Snippet Generator helps the user generate steps for Jenkins pipeline.

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(name: 'parameter-name', value: '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(name: 'parameter-name', value: 'secret-value')])

Version History

See the changelog.