/jmeter-maven-plugin

The JMeter Maven Plugin

Primary LanguageJavaApache License 2.0Apache-2.0

#JMeter Maven Plugin

Join the chat at https://gitter.im/jmeter-maven-plugin/jmeter-maven-plugin Build Status Dependency Status Maven Central Javadoc

A Maven plugin that provides the ability to run JMeter tests as part of your build

See the CHANGELOG for change information.

This plugin requires JDK 1.7 or higher.

#Basic Usage

Add the plugin to your project

  • Add the plugin to the build section of your pom's project :

      <plugin>
      	<groupId>com.lazerycode.jmeter</groupId>
      	<artifactId>jmeter-maven-plugin</artifactId>
      	<version>2.1.0</version>
      	<executions>
      		<execution>
      			<id>jmeter-tests</id>
      			<phase>verify</phase>
      			<goals>
      				<goal>jmeter</goal>
      			</goals>
      	   </execution>
      	</executions>
      </plugin>
    

Reference JMX files

Once you have created your JMeter tests, you'll need to copy them to <Project Dir>/src/test/jmeter. By default this plugin will pick up all the .jmx files in that directory, to specify which tests should be run please see the project documentation.

Run the tests

`mvn verify`

All your tests will run in maven!

#Documentation

All the documentation you need to configure the plugin is available on the github wiki.

Beginners should start with the Basic Configuration section.

For advanced POM configuration settings have a look at the Advanced Configuration section.

#Community

Users Group

A place to discuss usage of the maven-jmeter-plugin, let people know how you use it here.

Homepage: http://groups.google.com/group/maven-jmeter-plugin-users

Group Email: maven-jmeter-plugin-users@googlegroups.com

Devs Group

A place to discuss the development of the maven-jmeter-plugin, or ask about features you would like to see added.

Homepage: http://groups.google.com/group/maven-jmeter-plugin-devs

Group Email: maven-jmeter-plugin-devs@googlegroups.com

Website

The official website is available at http://jmeter.lazerycode.com

#Contributing

  1. Fork it.
  2. Create a branch (git checkout -b my_plugin)
  3. Commit your changes (git commit -am "Added feature")
  4. Push to the branch (git push origin my_plugin)
  5. Create a new Issue with a link to your branch, or just make a Pull Request.
  6. Enjoy a refreshing Diet Coke and wait