Skip to content
This repository

The JMeter Maven Plugin

README.md

JMeter Maven Plugin


The JMeter Maven Plugin allows you to automate JMeter tests in Maven.

Current Version In Maven Central: 1.9.0 See the release notes for change information. This plugin requires JDK 1.6 or higher.


PLEASE NOTE: The Group ID and Artifact ID have changed since version 1.4!

This is to bring the project in line with maven naming practice for non-maven plugins and to enable us to upload to the Sonatype OSS repository. This project is now in the maven central repository.


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>1.9.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

Build Server

You can see the state of the current codebase by looking at the CI Server.

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
Something went wrong with that request. Please try again.