grunt-jenkins
Manage Jenkins with Grunt
Getting Started
Install this grunt plugin next to your project's Gruntfile.js with:
$ npm install grunt-jenkins --save-dev
Gruntfile.js
Jenkins is not authenticated
module { grunt; grunt; // ...};
.netrc (preferred)
Jenkins is authenticated and credentials are inmodule { grunt; grunt; // ...};
Jenkins is authenticated and credentials are provided by username/password
module { grunt; grunt; // ...};
Jenkins is running in a private cloud with a different than provided
If you needed the feature provided by PR #9, allowing job urls to be
overwritten by the given server url, this feature is opt-in as of v0.8.0. By
default we will use the PROVIDED
url from the Jenkins api, which supports
different context roots.
module { grunt; grunt; // ...};
If a netrcMachine and username/password are provided, the netrc machine will be used. If using username/password, please pass them in via a command line argument instead of hardcoding in the build file.
If you are using Github OAuth for authentication, use API token instead of password which you can find at /user//configure.
Usage
grunt-jenkins
makes it easier to evolve your
Jenkins installation. Jenkins configurations are often created
by many people over a long time. Making changes to Jenkins confidently without
the appropriate tools can be difficult.
Back up the configuration
Having configuration in source control gives us the confidence to make changes
and know that we can go back to a working state. To create a backup of all jobs
run grunt jenkins-backup-jobs
. Behind the scenes, grunt-jenkins will:
- Create pipelineDirectory if necessary
- For each job: Create pipelineDirectory/jobName/config.xml
Verify the backup, constantly
Having our jobs in source control is great, but it can't make us completely
confident. Jenkins encourages users to change the configuration through the UI,
and that can leave our backed up version out of sync with the server.
grunt-jenkins makes it easy to verify the configuration in source control
matches exactly the version running on the server. Create a job as part of your
pipeline that runs grunt jenkins-verify-jobs
to ensure the configuration is
the same as source control.
In The News
- How Do I Backup Jenkins Jobs? from 13-Nov-2012
- grunt-jenkins One Year On from 17-Nov-2013
Release History
0.8.0 on 20-Nov-2016
- Support alternate context roots with default
jobUrlResolutionStrategy
#13 - If you need the support provided by #9 for using the given
server address instead of the job url provided by the Jenkins API,
this is now opt-in by setting
jobUrlResolutionStrategy
to'REWRITE_WITH_SERVER_ADDRESS'
- Upgrade request to 2.78.0
0.7.1 on 7-Nov-2016
- Whitelist files for package to exclude unnecessary files from installation
0.7.0 on 5-Nov-2016
- upgrade dependencies
- test against node 4, 5, 6, 7
- require >= node 4.0.0
0.6.0 on 17-Jan-2016
- feature: handle periods in job names #11. Thanks @dtJuiceMobile!
- badges: npm version badge added
- badges: now built by travisci against node 0.10, 0.12, 4.0, and 4.1
- docs: readme update for using with github oauth #10. Thanks @floydpraveen!
0.5.0 on 23-Jun-2014
- feature: support Jenkins running on NAT network in private cloud #9. Thanks @StefanScherer!
0.4.0 on 5-Nov-2013
- bugfix: authentication broken when no auth used #6
- badges: now built by travisci against node 0.8 and 0.10
- badges: dependencies are watched by david
- badges: codeclimate reports on complexity
- logging: log error when authentication fails #7
- logging: logs if and where authentication is coming from
- logging: much more information on requests and responses with --verbose
0.3.0 on 15-Sep-2013
- compatibility with password-protected jenkins instances via .netrc or username/password. Thanks @panozzaj!
0.2.0 on 14-Apr-2013
- compatibility with grunt 0.4.x
0.1.1 on 12-Nov-2012
- inject
grunt
instance intoJenkinsServer
andFileSystem
classes, as globally-installed grunt instances couldn't berequire
d
0.1.0 on 11-Nov-2012, from the Alaskan skies!
jobs-related tasks
- list all jobs on a server with
jenkins-list-jobs
- backup every job's config.xml to pipelineDirectory/jobName/config.xml
with
jenkins-backup-jobs
- verify each configuration in pipelineDirectory/ matches the job
configurations on the server with
jenkins-verify-jobs
- install jobs from pipelineDirectory/ with
jenkins-install-jobs
plugins-related tasks
- list all enabled plugins and their versions with
jenkins-list-plugins
- backup plugins to pipelineDirectory/plugins.json with
jenkins-backup-plugins
- verify plugins in pipelineDirectory/plugins.json match the plugins on the
server with
jenkins-verify-plugins
- install plugins from pipelineDirectory/plugins.json with
jenkins-install-plugins
convenience tasks
- for each of the tasks above, a shorter version exists that will run both:
jenkins-list
will runjenkins-list-jobs
andjenkins-list-plugins
License
Copyright (c) 2012-2016 sghill Licensed under the MIT license.