Inizia ora la tua demo e risparmia sui primi 12 mesi!

Blog

Easy and fast CI with Jenkins & Ant

Pubblicato da Il 29 Settembre 2020 in Blog, Tips

Continuous Integration (read more about CI in Maveryx) is often applied in environments with automated build and/or automated test execution systems, such as Jenkins, also using tools for automating software build, such as Ant.

Of course, Maveryx tests can be run automatically in Jenkins, among other ways, with Ant.

To do this, you just need to perform the following steps:
1) first, create a Maveryx tests project,
2) then, create an Ant Build file that executes the tests of the project,
3) eventually, set up a Jenkins job that runs the tests & publishes the results.

The following example is made by using the IDE Eclipse and the Maveryx-Eclipse Plugin.

Run Configuration

Let’s suppose you already have your Maveryx test project, and its name is MaveryxDemo.

Easily create a Run Configuration as follow:
1) right-click on the package you want (e.g. org.maveryx.demo.junit),
2) then, click Run As,
3) and click Run Configurations


Eclipse Project Run Configuration

Once in the Run Configurations window:
1) click New Launch Configuration,
2) set Name (e.g. Jenkins),
3) click Run all tests in the selected project, package or source folder,
4) then set Test Runner to JUnit4,
5) and click Close


Eclipse Run Configurations Dialog

Ant Build File

At this point, it’s time to create the Ant Build file. So, in the Package Explorer view
1) right-click on MaveryxDemo
2) and click Export… 


Eclipse Project Export

In the Export Wizard Select dialog:
1) click General -> Ant BuildFile
2
) click Next


Eclipse Export Ant Buildfile

Eventually, in the Export Wizard Generate Ant BuildFiles dialog:
1) select (check) MaveryxDemo,
2) then uncheck Create target to compile project using Eclipse compiler,
3) and click Finish.


Eclipse Generate Ant Buildfile

At this point, you should have your Ant build file in your project (build.xml).


Ant Buildfile xml

Create the Jenkins Job & Invoke Ant

Now, it is finally time to create a Jenkins Job. so, in the Jenkins Dashboard:
1) click New Item
2) then, set Item Name (e.g. MaveryxTestJob)
3) now, select Freestyle project
4) and finish by clicking OK.


Jenkins New Item

Of course, now, you have to configure the Job. Obviously, in the Job Configuration page:
1) select the JDK to use, according to the Ant build.xml file,
2) and click Advanced… 


Jenkins Job Configuration

More, in the Advanced Project Options section of the page:
1) select (check) Use custom workspace
2) and set Directory to the path of the folder containing the Eclipse project (the build.xml file)


Jenkins Advanced Project Options

In the Build section of the page:
1) click Add build step
2) and, of course, select Invoke Ant.


Jenkins Invoke Ant

So, in the Invoke Ant section of the page:
1) select Ant Version to be used,
2) then set Targets to
build-subprojects
init
build-project
build
jenkins
junitreport
3) and set Build File to build.xml


Jenkins Ant Buildfile

Now, in the Post-build action section:
1) click Add post-build action
2) and select Publish JUnit test result reports

Jenkins Publish JUnit test result report

Eventually, in the Publish JUnit test result report section:
1) set Test report XMLs to
junit*.xml
2) and click Save.



Jenkins Build and Run

Now, it’s finally time to build and run the tests. So, in the Project Dashboard:
1) just click Build Now to run the tests.

Of course, the stripy progress bar, in the Build History section, indicates that the tests are running.


Jenkins Dashboard

When the job finishes, if everything went fine (no failures) of course, the sphere in the Build History box becomes solid blue. Obviously, this means the build was a complete success.

At this point, just click on Latest Test Result to see the test report.


Jenkins Build History
Jenkins Test Result

This example can not cover all the things to say about the topic. If you are interested don’t be shy and feel free to ask and contribute.