为 Gatling 负载测试构建可执行 JAR

Question

我是 Gatling (2.1.2) 的新手，想做一个小型原型项目展示给我的同事。

根据 quick start 页面，我可以通过多种方式运行使用 Gatling 进行模拟：

将 Gatling 包解压缩到一个文件夹中，然后将我的模拟文件放入 user-files/simulations 文件夹中。 bin/gatling.sh 将编译并运行模拟文件。
使用 gatling-maven-plugin maven 插件执行模拟。
使用 gatling-highcharts-maven-archetype 创建一个项目，运行引擎 class。

我发现了那些问题

对于1，很难添加模拟classes的依赖。我必须弄清楚需要什么罐子并将它们放到 lib 文件夹中。

对于2，需要安装maven。

对于 3，它只有运行来自 IDE

我只想要一个简单的可执行 JAR 文件，其中包含捆绑在一起的所有依赖项（我的模拟、Gatling 和第三方），并且运行它来自任何机器（如 EC2 实例）。

有办法实现吗？

更新 1：

我尝试了方法 3，但是将所有项目文件从 test 文件夹移动到 main，并使用 maven-assembly-plugin 构建了一个具有依赖项的 jar。当我尝试运行文件时，出现以下错误：

Exception in thread "main" java.lang.ExceptionInInitializerError
    at Engine$.delayedEndpoint$Engine(Engine.scala:7)
    at Engine$delayedInit$body.apply(Engine.scala:4)
    at scala.Function0$class.apply$mcV$sp(Function0.scala:40)
    at scala.runtime.AbstractFunction0.apply$mcV$sp(AbstractFunction0.scala:12)
    at scala.App$$anonfun$main.apply(App.scala:76)
    at scala.App$$anonfun$main.apply(App.scala:76)
    at scala.collection.immutable.List.foreach(List.scala:381)
    at scala.collection.generic.TraversableForwarder$class.foreach(TraversableForwarder.scala:35)
    at scala.App$class.main(App.scala:76)
    at Engine$.main(Engine.scala:4)
    at Engine.main(Engine.scala)
Caused by: java.nio.file.FileSystemNotFoundException
    at com.sun.nio.zipfs.ZipFileSystemProvider.getFileSystem(ZipFileSystemProvider.java:171)
    at com.sun.nio.zipfs.ZipFileSystemProvider.getPath(ZipFileSystemProvider.java:157)
    at java.nio.file.Paths.get(Paths.java:143)
    at io.gatling.core.util.PathHelper$.uri2path(PathHelper.scala:32)
    at IDEPathHelper$.<init>(IDEPathHelper.scala:7)
    at IDEPathHelper$.<clinit>(IDEPathHelper.scala)
    ... 11 more

我猜这与 Gatling 配置有关，但不知道出了什么问题。

Answer 1

我试过做类似的事情。我 也不能 使用 Maven。我会努力记住我是怎么做到的。

1) 我已经配置 maven-assembly-plugin 以生成具有如下依赖项的单个 JAR：

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
</plugin>

您需要确保生成的类路径中存在所有必需的库（gatling、scala 运行时、zinc 编译器）。

2) 检查依赖项的范围，因为默认情况下 Maven 包仅类使用 scope=compile 定义。最简单的方法可能是不使用测试依赖项。

3) 创建启动脚本，例如launch.sh。它应该包含如下内容：

#!/bin/sh
USER_ARGS="-Dsomething="
COMPILATION_CLASSPATH=`find -L ./target -maxdepth 1 -name "*.jar" -type f -exec printf :{} ';'`
JAVA_OPTS="-server -XX:+UseThreadPriorities -XX:ThreadPriorityPolicy=42 -Xms512M -Xmx2048M -XX:+HeapDumpOnOutOfMemoryError -XX:+AggressiveOpts -XX:+OptimizeStringConcat -XX:+UseFastAccessorMethods -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false ${JAVA_OPTS}"
java $JAVA_OPTS $USER_ARGS -cp $COMPILATION_CLASSPATH io.gatling.app.Gatling -s your.simulation.FullClassName

为了解释，我拿了加特林自己的启动脚本作为灵感。主要注意类路径参数定义中 target 目录的存在。

4) 将编译后的 target 目录和 launch.sh 编译到一个目录并分发（例如作为存档） .然后你可以通过执行 ./launch.sh.

我知道这不是标准解决方案，但它对我有用。希望它也会对你有所帮助。如果您有任何问题或改进建议，请与我们分享。

Answer 2

您始终可以创建一个简单的 Java class 以 Gatling.fromArgs 启动 Gatling。使用此设置，您可以将所有内容都放在一个快乐的可执行 jar 中。让这个 class 成为 jar mainClass 而不是 "io.gatling.app.Gatling"。此示例用于 scala 模拟 class "my.package.MySimulation".

import scala.Option;
import io.gatling.app.Gatling;
import io.gatling.core.scenario.Simulation;

public class StartSimulation {

  public static void main(String[] args) {
    Gatling.fromArgs(new String[]{}, new Option<Class<Simulation>>() {

        private static final long serialVersionUID = 1L;

        @Override
        public int productArity() {
            return 0;
        }

        @Override
        public Object productElement(int arg0) {
            return null;
        }

        @SuppressWarnings("unchecked")
        @Override
        public Class<Simulation> get() {
            try {
                return (Class<Simulation>) Class.forName("my.package.MySimulation");
            } catch (ClassNotFoundException e) {
                e.printStackTrace();
            }
            return null;
        }

        @Override
        public boolean isEmpty() {
            return false;
        }

        @Override
        public boolean canEqual(Object o) {
            return false;
        }
    });
  }
}

Answer 3

我有一个类似的问题，我修复它如下：

Gatling 包里面有 bin/ 看看 gatling.sh。您会看到它只是将某些配置添加到 classpath 中，然后运行s io.gatling.app.Gatling class in gatling-compiler-<version_number>.jar。因此，您需要做的就是制作一个包含编译器的 jar，将配置和测试添加到 classpath 和运行 io.gatling.app.Gatling。步骤：

添加编译器依赖：

<dependency>
        <groupId>io.gatling</groupId>
        <artifactId>gatling-compiler</artifactId>
        <version>${gatling.version}</version>
    </dependency

创建具有依赖项的 jar：

  <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>2.4.1</version>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
                <finalName>${project.build.finalName}</finalName>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>

创建测试 jar（这包括你的 gatling 测试）

 <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>2.4</version>
            <executions>
                <execution>
                    <goals>
                        <goal>test-jar</goal>
                    </goals>
                    <configuration>
                        <excludes>
                            <exclude>src/test/resources/*</exclude>
                        </excludes>
                        <finalName>${project.build.finalName}</finalName>
                    </configuration>
                </execution>
            </executions>
        </plugin>

根据您的配置创建一个包。您可以为此使用 maven 程序集。我通常做的是创建一个单独的模块来处理为不同环境创建包。此包包含您的 gatling.conf、logback.xml 以及您的应用程序需要的所有其他资源，包括测试数据。现在您基本上拥有三个包：application.jar、application-tests.jar 和 application-conf.zip。解压application-conf.zip，复制application.jar和application-tests.jar到同一个文件夹。

在此文件夹中，您需要创建target/test-classes/文件夹，只需留空。就我而言，这是必需的。我想你可以在 gatling.conf 中更改它。但我不确定如何。

运行

java -cp ".:application-test.jar:application.jar" io.gatling.app.Gatling

Answer 4

我认为这有点晚了，但我面临着与此处相关的相同问题，但我使用 gradle 而不是使用 maven。猜猜方法是一样的，第一个解决方案和我自己的东西有点混合。

首先，定义一个gradle带有gatling依赖的构建文件和一个构建fatjar的任务

apply plugin: 'scala'
version 0.1

dependencies {
  compile group: 'io.gatling', name: 'gatling-test-framework', version: '2.1.7'
  compile group: 'com.typesafe.akka', name: 'akka-actor_2.11', version: '2.4.7'
  compile group: 'org.scala-lang', name: 'scala-library', version: '2.11.7'
}

repositories{
   mavenCentral()
   mavenLocal()
}


task fatJar(type: Jar) {
   manifest {
       attributes 'Implementation-Title': 'Preparing test',  
          'Implementation-Version': version,
          'Main-Class': 'io.gatling.app.Gatling'
   }
   baseName = project.name + '-all'
      from { configurations.compile.collect { it.isDirectory() ? it : zipTree(it) } } {
        exclude 'META-INF/MANIFEST.MF'
        exclude 'META-INF/*.SF'
        exclude 'META-INF/*.DSA'
        exclude 'META-INF/*.RSA'

   }
   with jar
}

该任务执行为

gradle clean build fatJar

将生成一个独立的 jar，默认情况下运行 Gatling main class。所以告诉它你想要运行的测试是用标准的 '-s' 参数进行的。

因此，如果需要，最后一步是创建运行它的脚本。我会"steal"第一个评论的脚本，稍微改一下

#!/bin/sh

if [ -z "" ];
then
    echo "Test config tool"
    echo
    echo "Running Parameters : "
    echo
    echo " <Config file> : Test definition file. Required"
    echo
   exit 0;
 fi

USER_ARGS="-DCONFIG_FILE="
JAVA_OPTS="-server -XX:+UseThreadPriorities -XX:ThreadPriorityPolicy=42 -Xms512M -Xmx2048M -XX:+HeapDumpOnOutOfMemoryError -XX:+AggressiveOpts -XX:+OptimizeStringConcat -XX:+UseFastAccessorMethods -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:+CMSParallelRemarkEnabled -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv6Addresses=false ${JAVA_OPTS}"
java $JAVA_OPTS $USER_ARGS -jar test-project-all-0.1.jar -s FunctionalTestSimulation -nr

在我的例子中，我将运行使用不同的、易于配置的参数进行相同的测试，因此我的模拟始终相同。我所有的 scala 文件都由 gradle 编译并打包在 jar 中，这意味着它们在 class 路径中，更改脚本变量的 "FunctionalTestSimulation" 名称可以轻松调整此脚本以实现更多功能通用。

估计制作Maven版本会很容易。

希望对某人有所帮助。

更新文件夹结构 请求后将为项目添加文件夹结构的小草稿：

test-project
    |_ build.gradle
    |_ src
        |_ main
            |_ scala
            |_ resources
    |_ runSimulation.sh
    |_ configFile.conf

有空的时候会提供一个link给我的github一个可以用的。干杯

Answer 5

我使用 IntelliJ Idea，我通过右键单击 scala 文件夹 > 将目录标记为 > 测试源根来解决这个问题。现在执行 "Engine" ，一切都会好起来的！

Answer 6

我最近在博客上讨论了这个 Creating a versionable, self-contained (fat-/uber-) JAR for Gatling tests, the source of which can be found in jamietanna/fat-gatling-jar。

对于 Maven 项目，步骤如下。

主要需要添加对gatling-charts-highcharts的依赖：

<project>
    <!-- ... -->
    <dependencies>
        <dependency>
            <groupId>io.gatling.highcharts</groupId>
            <artifactId>gatling-charts-highcharts</artifactId>
            <version>${gatling.version}</version>
        </dependency>
    </dependencies>
</project>

接下来，您需要确保您的 Gatling scenarios/simulations 处于 src/main 而不是 src/test。

最后，您可以使用 maven-shade-plugin 构建一个可执行 JAR，它使用 Gatling 的 CLI 运行器作为 mainClass:

<project>
    <!-- ... -->
    <build>
        <plugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-shade-plugin</artifactId>
              <version>3.1.1</version>
              <configuration>
                <filters>
                  <!--  -->
                  <filter>
                    <artifact>*:*</artifact>
                    <excludes>
                      <exclude>META-INF/*.DSA</exclude>
                      <exclude>META-INF/*.SF</exclude>
                      <exclude>META-INF/*.RSA</exclude>
                    </excludes>
                  </filter>
                </filters>
              </configuration>
              <executions>
                <execution>
                  <phase>package</phase>
                  <goals>
                    <goal>shade</goal>
                  </goals>
                  <configuration>
                    <transformers>
                      <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <mainClass>io.gatling.app.Gatling</mainClass>
                      </transformer>
                    </transformers>
                  </configuration>
                </execution>
              </executions>
            </plugin>
        </plugins>
    </build>
</project>

为 Gatling 负载测试构建可执行 JAR

Build executable JAR for Gatling load test

java

load-testing

gatling