node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Retrieves the latest build number/state from Jenkins.

Getting Started

If you haven't used grunt before, be sure to check out the Getting Started guide.

From the same directory as your project's Gruntfile and package.json, install this plugin with the following command:

npm install grunt-jenkins-build-number

Once that's done, add this line to your project's Gruntfile:



Inside your Gruntfile.js file add a section named jenkinsBuildNumber. This section specifies the options to provide the build state you want, the project name and the credentials if Jenkins server has authentication enabled.

Allowed build states are:

  • lastBuild (default)
  • lastCompletedBuild
  • lastFailedBuild
  • lastStableBuild
  • lastSuccessfulBuild
  • lastUnstableBuild
  • lastUnsuccessfulBuild

Config Example

Example to tag a new successful version based on the latest build number and environment:

jenkinsBuildNumber: {
    dist: {
        options: {
            hostname: '',
            port: 8080, //defaults to 80 if none chosen 
            state: 'lastSuccessfulBuild',
            username: process.env.JENKINS_USERNAME,
            password: process.env.JENKINS_PASSWORD,
            projectName: 'myproject-' + process.env.ENVIRONMENT


Copyright (c) 2013 Juan Pablo Garcia Licensed under the MIT license.