[INFRA-2118] Add function to run JMH benchmarks

README.adoc

@@ -357,6 +357,22 @@ pct: "default"
 
 *Please note that a blank metadata file will result in an error*
 
+=== runBenchmarks
+
+Runs JMH benchmarks and archives benchmark reports on `highmem` nodes.
+
+Supported parameters:
+
+`artifacts`::
+(Optional) If `artifacts` is not null, invokes `archiveArtifacts` with the given string value.
+
+
+===== Example
+[source, groovy]
+----
+runBenchmarks('jmh-report.json')
+----
+
 === Design documents for runATH and runPCT
 
 The design and some more details about the runATH and runPCT steps can be found link:https://wiki.jenkins.io/display/JENKINS/runATH+and+runPCT+step+design[here]

vars/runBenchmarks.groovy

@@ -0,0 +1,30 @@
+#!/usr/bin/env groovy
+
+/**
+ * Run JMH benchmarks and archives results
+ * @param artifacts archive these JMH reports
+ * @since TODO
+ */
+def call(String artifacts = null) {
+    lock('runBenchmarks') {
+        node('highmem') {
+
+            stage('Checkout repo') {
+                infra.checkout()
+            }
+
+            stage('Run Benchmarks') {
+                List<String> mvnOptions = ['test', '-Dbenchmark']
+                infra.runMaven(mvnOptions)
+            }
+
+            stage('Archive reports') {
+                if (artifacts != null) {
+                    archiveArtifacts artifacts: artifacts
+                } else {
+                    echo 'No artifacts to archive, skipping...'
+                }
+            }
+        }
+    }
+}

vars/runBenchmarks.txt

@@ -0,0 +1,22 @@
+<p>
+    Runs JMH benchmarks and archives benchmark reports on <code>highmem</code> nodes.
+</p>
+<p>
+    Supported Parameters:
+</p>
+
+<dl>
+    <dt><code>artifacts</code></dt>
+    <dd>
+        (Optional) If <code>artifacts</code> is not null, invokes <code>archiveArtifacts</code>
+        with the given string value.
+    </dd>
+</dl>
+
+<p>
+    <b>Example:</b>
+</p>
+
+<pre>
+    runBenchmarks('jmh-report.json')
+</pre>