{"id":739,"date":"2014-07-30T05:34:51","date_gmt":"2014-07-30T09:34:51","guid":{"rendered":"http:\/\/qxf2.com\/blog\/?p=739"},"modified":"2017-06-14T02:00:56","modified_gmt":"2017-06-14T06:00:56","slug":"get-started-with-jenkins","status":"publish","type":"post","link":"https:\/\/qxf2.com\/blog\/get-started-with-jenkins\/","title":{"rendered":"Testers, get started with Jenkins"},"content":{"rendered":"

Problem:<\/strong> Many testers do not get a chance to explore Jenkins.<\/p>\n

Why this post?<\/h3>\n

Jenkins<\/a> is an open source continuous integration tool written in Java. Jenkins seems to be the popular choice for continuous integration. Due to a variety of reasons, many testers do not get the opportunity to explore and play around with Jenkins. May be your development teams manage Jenkins, may be you joined a testing team after Jenkins was setup and stable, may be Jenkins is hosted on a machine you are not given access too. At Qxf2 Services<\/a>, we strongly believe in exploring the tools that we use everyday. In this post, we will show you how easy it is to set up Jenkins on your personal machine and learn more about it. Happy learning!<\/p>\n

\n

For this tutorial, we take a chess application written in Java, write a unit test and execute the build and tests via a Jenkins job. We are choosing a chess app because Qxf2 loves chess. We have chosen Ant<\/a> as our automated build utility. There is nothing special about the choice of Ant here. Jenkins does allow you to integrate various automated build tools with it.<\/p>\n

Pro tip:<\/strong> To get the most out of this post, spend some time exploring the different screens Jenkins offers you. <\/p>\n

\n

Getting started with Jenkins to build an app<\/h3>\n

1. Download and install Jenkins
\n2. Install Java and Ant
\n3. Select an application to build
\n4. Update the Junit test case
\n5. Set up the project in Jenkins
\n6. Start the build
\n7. Verify the result<\/p>\n

STEP 1: Download and install Jenkins<\/a><\/strong>
\nJenkins provides installers for different operating systems. In companies, it is more common to see Jenkins hosted on a *nix system. Our best guess is that most testers use Windows. Our goal is to help you, the tester, learn about Jenkins. So we are choosing to use Windows in this example. You can download the Windows native package as a zip file. Extract the file and install Jenkins. Since we are installing Jenkins using the Windows installer, we don’t need to do anything else as the Windows installer automatically runs Jenkins as a Windows service.<\/p>\n

You can verify Jenkins is running as a service by launching the Services app from the Windows Start Menu and looking for a running service called “Jenkins” among the list of all windows services running on the machine.<\/p>\n

\"Windows<\/a><\/p>\n

NOTE:<\/strong> By default, Jenkins runs at http:\/\/localhost:8080\/. You can change it by editing jenkins.xml, which is located in your installation directory.<\/p>\n

\"Jenkins\"<\/a><\/p>\n

STEP 2: Install Java and Ant<\/strong>
\nJenkins requires Java in order to run, so make sure you have Java <\/a>installed. Since we are building an Java app using Apache Ant you need to download and install Apache Ant<\/a>. Configure the correct path to your JDK and Apache Ant by clicking on Manage Jenkins<\/em> and then Configure System<\/em> on Jenkins.<\/p>\n

\"Jenkins<\/a><\/p>\n

STEP 3: Select an application to build <\/strong>
\nWe will take an example of a chess app<\/a> posted in github for building through Jenkins. Download the project from github to your local machine. The java chess app has some dependencies, we need to download Apache Ivy<\/a> to manage these dependencies. Apache Ivy<\/a> is a tool for managing (recording, tracking, resolving and reporting) project dependencies.<\/p>\n

STEP 4: Update the test case<\/strong>
\nWe will update the test case to validate that the Title of the Chess app displays as “October Chess Sample chess Project”.<\/p>\n

import com.nullprogram.chess.Chess;\r\nimport org.junit.Test;\r\nimport static org.junit.Assert.assertEquals;\r\n\r\n\r\npublic class BoardTest {\r\n @Test\r\n    public void testGetTitle(){\r\n    \t # Assert that the Application title displays as \"October Chess Sample chess Project\"\r\n    \t assertEquals( \"October Chess Sample chess Project\", Chess.getTitle());\r\n    }\r\n    \r\n}\r\n<\/pre>\n
Make sure you have Junit.jar<\/a> files included inside your ANT_HOME\/lib directory. Both junit.jar and ant-junit.jar should be present in ANT_HOME\/lib. For more details refer to link
\nhttp:\/\/ant.apache.org\/manual\/Tasks\/junit.html<\/a><\/p>\n
STEP 5: Set up the project in Jenkins<\/strong><\/p>\n