Continuous Build with Jenkins on Windows with Tomcat, github, Ant and Eclipse

Continuous Build with Jenkins with Tomcat, github, Ant and Eclipse

A quick look at setting up a Jenkins job to automatically build and deploy a Dynamic Web Project.

For Windows here is what you need:
  1. Tomcat or another web container
    • Ensure the default ports are changed, for my examples I used 8787 for tomcat
  2. Tomcat is installed and running
  3. Eclipse with a github plugin
  4. You have a Java project checked into github.com
  5. A github account (see github.com)
    • Remember to setup the SSH keys
  6. Jenkins (see http://jenkins-ci.org/)
    •  Download the lastest war file
  7. github client software

Start Jenkins
 java -jar jenkins.war
Visit http://localhost:8080/ to access Jenkins
Install Jenkins as a service
Instructions are here:https://wiki.jenkins-ci.org/display/JENKINS/Installing+Jenkins+as+a+Windows+service
Jenkins Service installed:

Jenkins running on http://localhost:8080/

Add github support to Jenkins
Manage Jenkins
Under the github section provide the path to git.exe
github section:

Git Plugin section:
Global Config user.name Value {Your git username}
Global Config user.email Value {email address}


SSH keys
Generate ssh keys using C:\dev\Git\bin\ssh.exe
Store the generated keys in the following folder:
 C:\Documents and Settings\{username}\ssh
Add them to github.com
See my previous post http://straightforwardit.blogspot.com/2011/11/setting-up-eclipse-for-github.html


Setup email notifications, using gmail
In the E-mail Notification section, add the following
  SMTP Server:smtp.gmail.com
  Sender e-mail address:{username}@gmail.com
  Click Use SMTP Authentication
  Username:{username}@gmail.com
  Password:{gmail pass}
  Click Use SSL
  SMTP Port 465
  Confirm by using the Test configuration by sending test e-mail option


Adding plugins to Jenkins

Manage Jenkins\Manage Plugins\Available
Add the following plugins:

  • "Deploy to container Plugin"
  • "Jenkins GIT plugin"
  • "GitHub plugin"


Scroll to the bottom and Click install

View of installed plugins:

Create a Dynamic Java Project
See https://github.com/sfbishop/TestProject for a reference

Creating a New Job
In Maven's menu Click New Job
Provide a job name
Use a Build a free-style software project

Configuring the Job Options
Under the Source code Management section

Pulling code from gitbub
Click the git button
Enter you repository url, something like: git@github.com:{git username}/TestProject.git


Calling Ant
In the build section, click the Add Build Step button, select Invoke Ant
Provide the Targets to run in a commas separated list
example: compile test

Post-build actions
Check the Publish JUnit test results report
Test report XMLs: TestProject/build/testreports/*.xml
Check Retain standard output/error

Deploying to Tomcat, automatically
In the Post-build actions section
Check Deploy war/ear to container
WAR/EAR files:**/*.war
Container: Tomcat 7.x
Manager user name: tomcat
Manager password: {password}
Tomcat url: http:localhost:8787


Sending email notification on failure
Check Email-notifications
Enter your email address
Check Send e-mail for every unstable build

Building your project
From the Jenkins dashboard, click on the project name
Click Build Now on the left hand side
Select the Build from the Build history section
Select Console output to view the build information
If everything is successful you should see a Jenkins blue ball next to the build number

Build History Section:

Things to watch out for:
  1. Ant paths, since they will be running under the jobs directory try not to hard code any absolute paths
  2. ssh keys with github
  3. Ports, ensure Web Container and Jenkins aren't using the same port.
References:

Comments

Post a Comment

Popular posts from this blog

Setting up SVN on Apache on Windows

Image
As part of getting some new members up to speed I needed create an SVN repository for project related check-in. I decided to go with Apache SVN which is easy to setup on Apache. Installation the following software Apache HTTP Server 2.2.1 http://httpd.apache.org/ Apache Subverion - 1.7.1 Win32Svn (32-bit client, server and bindings, MSI and ZIPs; maintained by David Darj) http://subversion.apache.org/packages.html Reboot to ensure paths are set correctly Apache Installation note Using port 80 it should install as a service to ensure SVN is active on restart Creating a repository on the Server Copy required modules Copy the files mod_authz_svn.so and mod_dav_svn.so Configure Apache httpd.conf In the modules section ensure the following setting exist Create and add user(s) to the authfile Connect and Confirm using IE, Chrome or FireFox Setting up the standard directories Checkout the repository using TortiseSVN or a command line tool Create the follow...
Read more

Jenkins - Adding Build Lights - Delcom 904008

Image
Adding a build light notification to your Jenkins server/setup can provide immediate visual feedback to your development team regarding application builds. The following is for setting up on a Windows machine and assumes you already have Jenkins installed locally or on a server. Required Hardware : Delcom USB HID Visual Indicator RGY - 904008, approx $90. Delcom 904008, RGY Required software: Ruby (1.9.3 or above)-  http://www.ruby-lang.org/en/downloads/ Delcom DLL -  http://www.delcomproducts.com/productdetails.asp?ProductNum=890510 delcom-util github project -  https://github.com/sfbishop/delcom-util  - modified to work with Jenkins Place the Delcom.dll in the same directory as the project.  You should be able to run the "xmas_led.rb" to confirm things are working correctly. Verification Once the software is installed plug in the USB light. Windows should install a driver. Verify in Device Manager: Note : If you hav...
Read more

SVN to Hudson/Jenkins - Repository Hooks

Image
While you can set Hudson/Jenkins to poll SVN at specific times an alternative is to let SVN inform Hudson when a new change has been committed to the repository. Requirements: You will need access to the server that hosts your SVN repository. You have a project setup and configured in Hudson. Adding the SVN Plugin The following Hudson plugin is installed, version 1.20 for this example. From the Hudson Console: Click Manage Hudson-Manage Plugins Ensure the Subversion Plugin is added. Adding the SVN Hook to SVN Once the plugin has been added its time to update the SVN hook. Using a text editor, VM or VIM edit the "post-commit" file in your SVN repository hooks directory. An example based on the "Oracle Virutal Developer Days VM" Repository directory: /home/oracle/labs/Dev_labs/svn_repos/otnvdd/hooks File: post-commit An sample "post-commit" file: Verify your changes: Once you have the SVN hook in place, its time to make a change ...
Read more