Vertx的命令行

2019/07/29 17:19
阅读数 232

 

 IntelliJ----创建一个运行配置(Application), 用io.vertx.core.Launcher类作为主类,在程序参数输入:run your-verticle-fully-qualified-name--redeploy=**/*.class --launcher-class=io.vertx.core.Launcher。为了触发重布署,需要显示生成项目或者模块(Build menu->Make project)。

run your-verticle-fully-qualified-name--redeploy=**/*.class --launcher-class=io.vertx.core.Launcher

Vertx的命令行

vertx命令被用于命令行与Vert.x进行交互。这是在运行Vert.x的 verticle的主要方式。为了运行命令行,需要下载并安装Vert.x发行版,并添加安装路径中的bin路径到PATH环境变量。同时必须确认安装了Java8的JDK,并在命令行可执行。

注意:需要JDK是为了支持运行时编译java代码。

 运行Verticles

可以使用vertx run命令从命令行直接运行一个原生的Vert.x veticles。有一两个run命令的例子。

vertx run my-verticle.js                                 (1)

vertx run my-verticle.groovy                             (2)

vertx run my-verticle.rb                                 (3)

 vertx run io.vertx.example.MyVerticle                    (4)

vertx run io.vertx.example.MVerticle -cpmy-verticle.jar (5)

 vertx run MyVerticle.java

 1. 布署一个JavaScript verticle

2. 布署一个Groovy verticle

3. 布署一个Ruby veticle

4. 布署一个已经编译过的java verticle,根类路径是当前目录。

5. 布署一个打成jar包的verticle,jar包必须在类路径中。

6. 编译Java源代码并布署。、

如你所见,在Java例子中,名称可以是安整合规则的Verticle类名,也可以直接指Java源代码文件,Vert.x会为你编译它。

也可给在verticle名称前添加实现语言前缀。例如,如果Verticle是一个编译的Groovy类,可以添加groovy:前缀,以便于Vert.x知道,这是一个Groovy类而不是一个Java类。

vertx rungroovy:io.vertx.example.MyGroovyVerticle

vertx run命令可以有一些可选参数,他们是:

·          -conf<config_file> 向verticle提供一些配置。config_file是一个包含JSON对象的文本文件的名字。当JSON对象代表了verticle对象的配置,这是可选的。

·          -cp<path> - 这是寻找verticle的路径并且也是verticle要使用的一些其他资源的路径。默认的“.”(当前路径)。如果verticle引用了其他脚本,类,或者其他资源(如jar文件),请确保它们在此路径下。此路径可以包含多个路径实体,有:或者;分隔开,具体什么分隔符依赖于操作系统。每个路径 实体可以是绝对路径也可以是档对于包含脚本的路径,或者绝对,和相对的jar/zip文件的文件名。一个路径的例子可能是这样-cpclasses:lib/otherscripts:jars/myjar.jar:jars/otherjar.jar。总是这样使用路径引用一些verticle需要的资源。不要将这些资源放在系统类路径中,因为这样会在布署的verticle之间造成隔离问题。

·          -instance<instance> - 初始veticle实例的数目。每个verticle实例是一个严格的单线程,所以为在所有能获得的运算核心上伸缩应用,应该布署多个实例。如果忽视这个参数,verticle单实例将会部署。

·          -worker—此选项决定是verticle是否是一个工作verticle。

·          -cluster-port如果cluster选项被设置,此参数决哪个端口通为与其他Vert.x实例进行通迅。默认是0,表明随机选择空端口。通常不需要设置此参数除非你真得需要绑定到指定端口。

·          -cluster-host如果集群选项被指定,这参数决定那个主机地址被用于与其他Vert.x实例进行通迅。默认是从可用的地址中选择一个。如果有多个网卡,就需要使用指定的,就在这里设置。

·          -ha 如果设置verticle被布署成高可用。参考相关章节获取更多信息。

·          -quorum 与-ha参数联合使用。此参数指定集群中最小节点数,这些节点为了激活高可用布署ID。默认是0。

·          -hagroup与-ha参数联合使用。指定此节点要加入的HA组。一个集群上可能有多个HA组。节点在失效时,由同组中的其他节点备份。默认值是` __DEFAULT__`

也可以使用   -Dkey=value设置系统属性

这里有一些更多的例子,用默认的设置运行javascript的verticleserver.js。

vertx run server.js

运行预编译java verticle 100个实例,并指定类路径:

vertx run com.acme.MyVerticle -cp"classes:lib/myjar.jar" -instances 10

从源文件运行java verticle 10个实例

vertx run MyVerticle.java -instances 10

运行ruby工作verticle20个实例

vertx run order_worker.rb -instances 20 –worker

在同一个机器上运行两个Javascript实例,并让将其集群起来

vertx run handler.js -cluster

vertx run sender.js –cluster

传入一些参数运行一个Ruby verticle

vertx run my_verticle.rb -conf my_verticle.conf

my_verticle.conf可以包含像下面的内容:

{

 "name": "foo",

 "num_widgets": 46

}

通过内核API,在verticle内部,可以获取配置。在使用vert.x高可用特性时,可能想创建一个裸vert.x实例。此实例在启动后,不布署任何verticles。但是如果集群中的节点崩溃,将会接收一个verticle。为了创建裸实例,启动如下:
vertx –ha

取决于集群配置,有可能必须添加 cluster-host和cluster-port参数。

 从一个fat jar中执行Vert.x应用

一个fat jar包是一个内嵌了依赖的可执行jar包。这就意味着,你不必预选在机器上安装Vert.x,然后执行jar。与一些可执行java jar包类似,它可以这样被执行:

java -jar my-application-fat.jar

关于这个,Vert.x没有什么需要设置的,一些应用程就可以这样做。也可以创建主程序并在mainfest中进行设置,但,建议编写自己的verticle代码,并用Vert.x的Launcher(io.vertx.core.Launcher)类作为你的主类。这个主与与命令行运行Vert.x是相同的主类,因此允许指定命令行参数,如 instances让应用伸缩更容易。

为了用fat jar方式布署verticle,必须有一个manifest:

·          Main-Class设置为 io.vertx.core.Launcher

·          Main-Verticle指定主verticle(完整严格的类名或脚本文件名

也可使用传递给vertx run命令的通用的命令行参数。

java -jar my-verticle-fat.jar -cluster -confmyconf.json

java -jar my-verticle-fat.jar -cluster -confmyconf.json -cp path/to/dir/conf/cluster_xml

 默认的,一个fat jar执行run命令。

 显示Vert.x版本

用下面命令显示Vert.x版本:

vertx version

 其他命令

vertx命令行和Launcher都提供除了run和version命令之外的其他命令,可以用下面代码创建 一个裸实例:

vertx bare

# or

java -jar my-verticle-fat.jar bare

可以在后台启动一个应用:

java -jar my-verticle-fat.jar start-Dvertx-id=my-app-name

如果 my-app-name没有设置,一个随机产生一个ID,并输出到命令提示。可以将run选项传递给start命令:

java -jar my-verticle-fat.jar start-Dvertx-id=my-app-name –cluster

一旦后台加载,可用stop命令停止:

java -jar my-verticle-fat.jar stop my-app-name

也可以列出后台运行的Vert.x应用:

java -jar my-verticle-fat.jar list

start,stop和list命令也可以从vertx工具中找到。start命令支持几个选项:值

·          vertx-id:应用ID,没有设定,使用随机UUID

·          java-opts:JVM选项,如果未设定,使用JAVA_OPTS变量

·          redirect-output:重定向启动进程输出和错误流到父进程流。

如果选项值包含了空格,一定要用双引号引起来

因为start命令起动一个新进程,传入JVM选项不会传播。所有必须使用‘java-opts’配置JVM。如果设置了CLASSPATH环境变量,请确保包含所有的需要的jar包(vert-xore,应用jar及所有依赖项)

命令集合是可扩展的,参考扩展vert.x加载器小节。

 热布署

在文件改变时自动重新布署应用,在开发应用时是非常方便的。vertx命令行工具和更常用的Launcher 类都提供此特性。下面有一些例子:

vertx run MyVerticle.groovy--redeploy="**/*.groovy" --launcher-class=io.vertx.core.Launcher

vertx run MyVerticle.groovy--redeploy="**/*.groovy,**/*.rb" --launcher-class=io.vertx.core.Launcher

java io.vertx.core.Launcher runorg.acme.MyVerticle --redeploy="**/*.class"  --launcher-class=io.vertx.core

.Launcher -cp ...

重布署实现如下。首先,应用程序以后台应用加载(用start命令)。匹配文件变化,进程被停止并且应用重新启动。这样可以避免泄漏。

为了启用执布署,向run命令添加—redeploy选项。--redeploy指定要监视的文件集合。这个文件集合使用Ant风格模式(用**,*和?)匹配。你可以指通过用”,”号分隔指定多个集合。模式是相对于当前工作目录的。

传递给run命令的参数被传给了应用。可用—java-opts设置JVM选项。

--launcher-class选项指定应用启动的主类。通常是Launcher,但也可以使用自己的主类。

在IDE中也可以使用重布署的特性:

·          Eclipse---创建一个运行配置(Run configuration),用io.vertx.core.Launcher类作为主类。在程序参数区域(在参数标签),输入run your-verticle-fully-qualified-name--redeploy=**/*.java --launcher-class=io.vertx.core.Launcher。也可以加入其他参数。在保存文件时,Eclipse会增量编译修改的文件,重新布署平滑工作。

·          IntelliJ----创建一个运行配置(Application), 用io.vertx.core.Launcher类作为主类,在程序参数输入:run your-verticle-fully-qualified-name--redeploy=**/*.class --launcher-class=io.vertx.core.Launcher。为了触发重布署,需要显示生成项目或者模块(Build menu->Make project)。

为了调试你的应用,创建你的运行配置作为远程应用并用—java-opts配置调试器。然而,不要忘记在每次重新布署一个新进程时重新插入调试器。

也可以在布署周期的构建进程下钩子。

java -jar target/my-fat-jar.jar--redeploy="**/*.java" --on-redeploy="mvn package"

java -jar build/libs/my-fat-jar.jar--redeploy="src/**/*.java" --on-redeploy='./gradlew shadowJar'

on-redeploy选项指定一个在应用关闭或应用重启后调用的命令,所以能钩信你的构建工具,如果更新一些运行时资源。例如启动gulp或者grunt更新你的资源。

重新布署特性支持下面设置:

·          redeploy-scan-period:文件系统检查周期,单位毫秒,默认250ms

·          redeploy-grace-period:在两重布署之间的等待时间默认是1000ms,单位毫秒

redeploy-termination-period:在停止应用之后启动用户命令之前的等待时间量。这在Windows上是有用的,因为进程不是立既被kill。单位毫秒,默认值为0ms.

展开阅读全文
加载中

作者的其它热门文章

打赏
0
0 收藏
分享
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部
返回顶部
顶部