2. Spring XD入门
2.1 必要条件
要开始Spring XD之旅,确保你的系统的JDK版本最低为7或者更新的版本。推荐使用Java JDK 7。
2.2 下载Spring XD
要下载当前通用版本,你可以下载发布版 spring-xd-1.3.1.RELEASEdist.zip 以及与之对应的 文档 。
如果你想尝试最新的Spring XD构建,你可以从Spring快照版本库中下载。如果愿意的话,也可以从源码中构建项目。Wiki中的内容也和最新的快照版本保持一致,所以如果你从github站点读到这些内容,都会从上一个稳定版本中更新。
解压文件到一个单独的安装文件夹中。下面所有的指令都在这个文件夹里,所以在执行之前改变它。
$ cd spring-xd-1.3.2.BUILD-SNAPSHOT |
2.3 安装Spring XD
Spring XD可以运行在两种不同的模式(mode)下。有为测试和开发的单节点运行时(single-node runtime)选项,而分布式运行时(distributed runtime)支持通过多个节点的分布式任务处理。本文档会带领你在单点运行环境中快速起步。在分布式模式运行请查看相关章节(2.9节介绍)。
你可以在OS-X上使用homebrew或者在RedHat/CentOS上使用RPM安装Spring XD。
2.4 启动运行时和XD Shell
单节点模式是最容易开始的。在一个单一的过程中它会返回你需要的所有东西。要启动它,你只需要cd到xd目录并运行如下命令
xd/bin>$ ./xd-singlenode |
在另外一个终端里,cd进shell目录并启动XD shell,在这里你可以启动命令。
相对于Spring XD提供给客户端的REST API,shell是一个对用户更加友好的前端。当前针对Spring XD服务器的URL会在开启时显示出来。
!注意
如果服务器无法访问,命令提示符会收到
server-unknown:> |
那么你可以使用 admin config server <url> 去尝试重新连接至admin REST端点一旦你想通了问题出在哪里:
admin config server http://localhost:9393 |
现在你应该可以使用Spring XD了。
!提示
Spring XD在内部使用了通常作为外部程序的ZooKeeper,XD单点模式运行在内嵌的ZooKeeper服务器并指派一个随机的可用的端口号。这使得事情变得非常简单。但是如果你已经有一个ZooKeeper可以使用并希望连接到它上面,你可以编辑xd/config/servers.yml:
另外,有时候连接在处理连接ZooKeeper命令行界面(CLI)到内嵌服务器问题时是很有用的。指定的服务器端口已经列在控制台日志中,但是你还是可以在配置 servers.yml 中通过属性 zk.embedded.server.port 直接设置端口号或者在启动XD-单点前设置 JAVA_OPTS。
$export JAVA_OPTS=-Dzk.embedded.server.port=<port> |