Overview
Jenkins (and in fact any CI systems) works best when builds are triggered after each and every commit. That provides you, the developer, with the most instant feedback possible. That, in turn, means you get fix(es) to the problems you introduced before you leave the context of what you were working on.
There are two general techniques for detecting commits in any source control system:
- Polling (the "Dad, are we there yet... are we there yet... are we there yet!" technique) where you ask the source control system at regular intervals.
- Push, where the source control system tells you there has been a change.
The first technique requires no support from the source control system but puts a lot more load on both the CI system and the source control system. As well as that, it can only pick up changes as often as the polling frequency.
The second technique requires support, in both the source control system and the CI system, for the sending and receiving of notifications.
The Jenkins GitHub plugin provides support for receiving push notifications from Github post-commit hooks and using those notifications to trigger jobs within Jenkins. It can set-up the post-commit hooks in GitHub for you.
In addition, GitHub decorates the Jenkins “Changes” pages with links to the pretty GitHub commit, issues pages and adds a sidebar link to the corresponding GitHub project page.
Stable Release Version
The current stable release is version 0.9
Requirement for Plug-in Use
- Jenkins 1.400 or newer
- Jenkins Git Plugin version 1.1.12 or newer
- At least one GitHub hosted project to build ;-)
Step-by-Step Instructions on How to Use it
Installation
- Go to your Jenkins instances root page.
- If your Jenkins instance has security enabled, login as a user who has the Overall | Administer permission.
- Select the Manage Jenkins link on the left-hand side of the screen.
- Select the Manage Plugins link.
- On the Available tab, select the Github Plugin and click the Download and Install button at the bottom of the page (if you do not got the Git Plugin installed, do not worry, Jenkins is smart enough to install/upgrade the Git plugin, where required).
- Restart Jenkins once the plugins are downloaded (Note: users of Jenkins 1.442 or newer should be aware that the plugin currently requires a restart to function correctly).
Configuration
- Goto your Jenkins instance job.
- Select the Configure link on the left hand side of the screen.
- In the GitHub project field, enter the URL of the GitHub project. If your GitHub project's git URL looks like: git@github.com:username/project.git,
then the GitHub project should be: http://github.com/username/project/ or if the project is private, you can get faster navigation with: https://github.com/username/project/
- Go to your Jenkins instances root page.
- If your Jenkins instance has security enabled, login as a user who has the Overall | Administer permission.
- Select the Manage Jenkins link on the left hand side of the screen.
- Select the Configure System link.
- In the GitHub Web Hook section select the Let Jenkins auto-manage hook URLs option.
- Ensure you have provided at least one username and password for connecting to GitHub (the password is required as GitHub does not expose an API for managing the Post-Receive URLs).
- Go to your Jenkins instances root page.
- If your Jenkins instance has security enabled, login as a user who has the Overall | Administer permission.
- Select the Manage Jenkins link on the left hand side of the screen.
- Select the Configure System link.
- In the GitHub Web Hook section select the Manually manage hook URLs option.
- For each project that you want to have triggering builds, you need to open the Repository Administration screen on that GitHub project's page.
- Select the Service Hooks tab.
- Select the Post-Receive URLs hook.
- Add the URL, which will be the root URL of your Jenkins instance with /github-webhook appended.
Once you have configured your Jenkins instance for receiving the push notifications, you can enable jobs being triggered via the push notifications:- Goto your Jenkins instance job.
- Select the Configure link on the left hand side of the screen.
- Select the Build when a change is pushed to GitHub checkbox and save the configuration.
Tips & Tricks, How to Use it on DEV/RUN
The plugin is identical to configure on DEV@cloud.
Any Known Issues
- The recent GitHub refresh of their site's look-and-feel broke automatic Post-Receive URL management for versions of this plugin prior to 0.9
Relevant Documentation
Learn More
Want to learn the latest in Jenkins? Subscribe to the Jenkins newsletter , Continuous Information . This monthly newsletter contains all of the latest interesting and useful happenings in the Jenkins community, sent directly to your inbox.