Jenkins setup

jenkins-notes.md

I just had to set up Jenkins to use GitHub. My notes (to myself, mostly):

Detailed Instructions

For setting up Jenkins to build GitHub projects. This assumes some ability to manage Jenkins, use the command line, set up a utility LDAP account, etc. Please share or improve this Gist as needed.

Install Jenkins Plugins

• get both the git and github plugin
• http://wiki.jenkins-ci.org/display/JENKINS/Git+Plugin
• http://wiki.jenkins-ci.org/display/JENKINS/Github+Plugin

Make a Utility Account in the GitHub (optional)

• This would keep your identity separate from your Jenkins server
• Helpful if Jenkins runs under a different user

On the Jenkins server (optional)

• If Jenkins does run as different user, set this up on your server
• Set git user.name and user.email global config options.
• 'git config --global user.email JENKINS_USERNAME@WHATEVER_HOSTNAME'
• 'git config --global user.name JENKINS_USERNAME'
• This should match the GitHub utility account username and email address

Generate rsa key pair on your Jenkins server

• Log into the server as the user that Jenkins runs under
• Using command line, change directory to ~/.ssh
• Generate key with 'ssh-keygen -t rsa -C 'JENKINS_USERNAME@WHATEVER_HOSTNAME''
• Note that -C comment is optional, just helps you identify the public key later
• Do NOT use a passphrase for the keygen (at least, I could not make this work)
• If there's a way to use a key pair with passphrase, please comment and let me know?
• Init with 'ssh -v [email protected]'
• Reply 'yes' to add known host
• Copy contents of public key
• There's more reading about this on GitHub https://help.github.com/articles/set-up-git https://help.github.com/articles/generating-ssh-keys https://help.github.com/articles/error-permission-denied-publickey

Update the GitHub Account for Jenkins

• Register utility user with git.corp.adobe.com
• Log in the utility account
• Go to Account Settings > SSH Keys
• Add the contents of the public key from your server

Configure Jenkins

• Make sure the Manage Jenkins > Configure System has the right path to git
• Set the global git user.name and user.email to match your global config options
• Configure GitHub Web Hook to Manually manage hook urls
• Click the (?) icon next to the manual option and copy the hook URL you see there
• Optionally set the service account email as the Jenkins sender email address

Configure Github Project

• Log into Github as the owner or collaborator of a repo
• Click the Admin button for that repo
• Select 'Service Hooks' in the left column
• Select 'Jenkins (Github plugin)' in the Available Service Hooks column
• Add the service hook URL for your server eg http://yourjenkinsmachine.com:8080/github-webhook/ you might find the URL in the GitHub Web Hook > Manual setting (?) help text
• Check the 'Active' checkbox

Create a Jenkins job

• In the general options, add the URL to the github project eg 'http://github.com/tehfoo/build-test/'
• Under Source Code Management, select Git
• For the repository URL, enter the SSH URL for your project this is found by toggling the HTTP/SSH button to the right of the URL field on the repo home page in GitHub eg '[email protected]:ixab/build-test.git'
• Under Build Triggers, check the "Build when a change is pushed to GitHub"
• Add other build task (running Grunt, or Ant, or scary Maven stuff, or whatever)

Enjoy!

Make a Utility Account in the GitHub (optional).
ehm... what is this? What is Utility Account in the Github???

Hi,

When I provide the Repository URL in the Source Code Management I am facing "Failed to connect to repository : Error performing command: git.exe ls-remote -h https://*******.git HEAD" issue.??
Can anyone help me on this.

what is JENKINS_USERNAME@WHATEVER_HOSTNAME can you give me a example

@MithPallakki you just give git.exe c/program files/git/bin/git (which will be at place where git is installed in your local machine) at git global configuration

can anybody tell me how can we transfer required build artifact from nexus repository to higher environments using Jenkins build pipeline plugin and what is the use of parametrized trigger plugin in this process

Man, I don´t have any problem to use a key pair with passphrase

Thanks for the steps you mentioned above.

On windows, when Jenkins is running as a service, I also had to make sure that the service was being started as the same user that I generated the ssh key with, to make sure it finds the correct ssh key.

Thanks for the guide!

Build Trigger Build when a change is pushed to GitHub has been renamed to GitHub hook trigger for GITScm polling (v1.25.1)

Note:

If you created keys under another user and then moved keys to /var/lib/jenkins/.ssh/ - be sure that user jenkins has access to it and also became owner of these keys!