export dynamic job data

Adds a build step that exports runtime parameters into a properties file (e.g who triggered the build, what is her email address...). This information can be read by other build steps.

 job-exporter plugin

Enabling

To use it, edit the configuration of a particular job, go to "Build" and click "Add build step", in the list select "Export Job runtime parameters", this will create the files at the point in the build where this step is executed.

Details

This plugin exports Jenkins (runtime) job parameters into a ".properties" file. So other build steps (e.g. ant scripts) can read those parameters and work with them. For example: send some information via email to the user who triggered a job.

The property file is named "hudsonBuild.properties" and will be created in the project workspace. This file contains the following informations:

Property Meaning
build.jobName Name of running job.
build.id Build ID.
build.number Number of running job.
build.host Job runs on this host.
build.slave Job runs on this slave.
build.result Job result til this build step.
build.started Job started at this time.
build.elapsedTime Milliseconds the job is already running.
build.duration Human readable elapsed time.
build.executor Executor number.
build.cvsBranch CVS branch, if configured.
build.svnRevision SVN revision, if configured.
build.gitBranch GIT branch, if configured.
build.user.id ID of user that triggered this job. Has value of "null" for anonymous user. Only filled if the build was triggered by an user.
build.user.name User that triggered this job. Only filled if the build was triggered by an user.
build.user.fullName Full name of user that triggered this job. Mostly identical with value of "build.user.name" (if ID is not null).
build.user.emailAddress Email address of user that triggered this job. If no user with email address was found, the admin email address stands here.
build.upstream.number Number of upstream job that triggered this job. Only filled if the build was triggered by an upstream project.
build.upstream.project Upstream project that triggered this job.
build.remote.host Remote host that triggered this job. Only filled if the build was triggered by a remote host.
build.remote.note Host note for remotely triggered job.
build.admin.emailAddress This is the current administrator email address.
build.summary Build summary like "Executor #3 for master : executing MyJob #28"
build.hudson.version Running Jenkins version.

 Version History

Version 0.4 (27 Jan 2012)

  • Now working with current Jenkins version again.
  • Some more properties are exported.

Version 0.3.1 (22 Mar 2011)

  • Rerelease 0.3 to properly set required core version.

Version 0.3 (31 Jan 2011)

  • This is just a bugfix release that should work as described before.

Version 0.2 (29 Jan 2011)

  • User triggered build now has correct user email address again
  • Upstream and remote build causes also provide some informations

Version 0.1 (01 Dec 2009)

  • Initial release