多节点测试

模块信息

要应用多节点测试，必须在我的项目中增加以下依赖项:

多节点测试概念

当咱们议论Akka中的多节点测试时，是指在不同JVM中的多个actor零碎上运行协调测试的过程。多节点测试套件包含三个次要局部。

-测试协调。协调和管制被测节点。
-多节点标准。这是启动TestConductor，并让所有节点连贯到它的封装。
-SbtMultiJvm插件。在多台机器上的多个JVM中启动测试。

测试协调

多节点测试的根底是TestConductor。它是一个Akka扩大插件，可插入网络堆栈，用于协调参加测试的节点，并提供以下性能:

-节点地址查找:查找到另一个测试节点的残缺门路（无需在测试节点之间共享配置）
-节点屏障协调:在命名的屏障处期待其余节点。
-网络故障注入:限度流量，抛弃数据包，插入并从新插入节点。
这是测试协调的示意图。

测试协调服务器负责协调屏障，并向作用在屏障上的测试协调客户端发送命令。限度与其余客户端之间的网络流量。无关可能的操作的更多信息，请参见akka.remote.testconductor.ConductorAPI文档。

多节点标准

多节点标准包含两局部。MultiNodeConfig负责通用配置、枚举和命名被测节点。MultiNodeSpec蕴含许多便当性能，用于使测试节点互相交互。无关可能的操作的更多信息，请参见akka.remote.testkit.MultiNodeSpecAPI文档。

通过在要运行被测节点的所有JVM上设置的java零碎属性来配置MultiNodeSpec。能够在JVM命令行上应用-Dproperty=value设置这些值。

这些是可用的属性
-multinode.max-nodes测试能够具备的最大节点数。
-multinode.host此节点的主机名或IP。必须应用InetAddress.getByName可解析。
-multinode.port此节点的端口号。默认为0，它将应用随机端口。
-multinode.server-host服务器节点的主机名或IP。必须应用InetAddress.getByName可解析。
-multinode.server-port服务器节点的端口号。默认为4711
-multinode.index在为测试定义的角色序列中此节点的索引。索引0是非凡的，该机器将是服务器。所有故障注入和限流必须从此节点实现。

SbtMultiJvm插件

SbtMultiJvm插件已更新，能够通过主动生成相干的multinode.*属性来运行多节点测试。这意味着您能够将它们作为一般的多jvm测试运行，而无需任何非凡配置就能够在一台计算机上运行多节点测试。而后，通过应用插件的多节点增加，无需进行任何更改能够在多台计算机上分布式运行这些测试。

多节点特定增加

该插件还具备许多新的multi-node-*sbt工作和设置，以反对在多台计算机上运行测试。将必要的测试类和依赖项打包为散发到其余具备SbtAssembly的计算机上的jar文件，其名称格局为<projectName>_<scalaVersion>-<projectVersion>-multi-jvm-assembly.jar

留神
为了可能在多台计算机上散发和启动测试，假设主机和指标零碎都是POSIX零碎，并且具备ssh和rsync。

这些是可用的sbt多节点配置
-multiNodeHosts,用于运行测试的一系列主机，格局为user@host:java，其中host是惟一必须的局部。将覆盖文件中的设置。
-multiNodeHostsFileName,一个文件，用于读取运行测试的主机。每行一个，格局与上述雷同。默认为根底我的项目目录中的multi-node-test.hosts。
-multiNodeTargetDirName,指标计算机上将jar文件复制到的目录的名称。在用于rsync jar文件的ssh用户的根本目录中，默认值为multi-node-test。
-multiNodeJavaName指标计算机上默认Java可执行文件的名称。默认为java。

以下是一些如何定义主机的示例

localhost应用默认java的localhost上的以后用户。
user1@host1主机host1上的用户user1，默认Java。
user2@host2:/usr/lib/jvm/java-7-openjdk-amd64/bin/java应用Java7的主机host2上的用户user2。
host3:/usr/lib/jvm/java-6-openjdk-amd64/bin/java应用Java6的主机host3上的以后用户。

运行多节点测试

要从sbt外部以多节点模式运行所有多节点测试（即散发jar文件并近程启动测试），请应用multiNodeTest工作:

multiNodeTest

要以多jvm模式（即本地计算机上的所有JVM）运行它们，请执行以下操作:

multi-jvm:test

要运行单个测试，请应用multiNodeTestOnly工作:

multiNodeTestOnlyyour.MultiNodeTest

要以多jvm模式运行单个测试，请执行以下操作:

multi-jvm:testOnlyyour.MultiNodeTest

能够列出多个测试名称来运行多个特定测试。sbt中的制表符补全使实现测试名称变得容易。

多节点测试示例

首先，咱们须要一些脚手架，以将MultiNodeSpec与您喜爱的测试框架连接起来。让咱们定义一个接口STMultiNodeSpec，该接口应用ScalaTest启动和进行MultiNodeSpec。

而后，咱们须要定义一个配置。让咱们应用两个节点"node1和"node2"，并将其称为MultiNodeSampleConfig。

而后最初到节点测试代码。这将启动两个节点，并演示一个阻碍，以及一个近程actor音讯发送/接管。

注意事项

编写多节点测试时，须要牢记两点，否则测试的行为可能会令人诧异。

不要敞开第一个节点。第一个节点是控制器，如果敞开，测试将失败。
为了可能应用blackhole，passThrough和限流，必须通过在MultiNodeConfig中指定testTransport（on = true）来激活故障注入和节流传输适配器。
节流，停机和其余故障注入只能从第一个节点（也就是控制器）进行。
节点敞开后，不要应用node（address）来申请节点的地址。在敞开节点之前先获取地址。
不要从其余线程而不是主测试线程，应用诸如地址查找，障碍物等MultiNodeSpec的办法。这也意味着您不应该在actor，future或scheduled task中应用它们。

配置

多节点测试模块有多个配置属性，请参考参考配置。