Job Exporter Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID job-exporter Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
0.4
Jan 27, 2012
1.433
Source Code
Issue Tracking
Maintainer(s)
Subversion
Open Issues
Michael Meyling (id: m31)
Usage Installations 2013-Apr 837
2013-May 855
2013-Jun 897
2013-Jul 929
2013-Aug 914
2013-Sep 899
2013-Oct 987
2013-Nov 967
2013-Dec 957
2014-Jan 1031
2014-Feb 1075
2014-Mar 1122

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

Labels

Edit
plugin-builder plugin-builder Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment