Apache Ant 服务器部署用户手册

作者

Christopher A. Longo (cal@cloud9.net)
Cyrille Morvan (cmorvan@ingenosya.com)

目前，这些任务支持

WebLogic 服务器
JOnAS 2.4 开源 EJB 服务器

随着时间的推移，我们预计将添加更多可选任务来支持其他 J2EE 服务器。

任务	应用服务器
serverdeploy	嵌套元素
	generic	通用任务
	jonas	JOnAS 2.4
	weblogic	WebLogic

ServerDeploy 元素

描述

serverdeploy 任务用于运行针对特定供应商的 J2EE 服务器的“热”部署工具。该任务需要嵌套元素，这些元素定义了正在执行的特定供应商部署工具的属性。特定供应商部署工具元素可能会强制执行对哪些属性是必需的规则，具体取决于工具。

参数

属性	描述	必需
action	这是要执行的操作。在大多数情况下，这将是 deploy。某些工具支持其他操作，例如 delete、list、undeploy、update 等。	是
source	要部署的组件的完全限定路径/文件名。这可以是 `.ear`、`.jar`、`.war` 或服务器支持的任何其他类型。	工具依赖

作为嵌套元素指定的参数

serverdeploy 任务支持嵌套的 classpath 元素来设置类路径。

特定供应商的嵌套元素

还支持嵌套的特定供应商元素。

用于所有工具的参数

属性	描述	必需
classpath	要传递给运行该工具的 JVM 的类路径。类路径也可以作为嵌套元素提供。	工具依赖
server	将部署组件的服务器的地址或 URL。	工具依赖
username	具有将应用程序部署到服务器的权限的用户。	工具依赖
password	具有将应用程序部署到服务器的权限的用户的密码。	工具依赖

通用元素

此元素是为通用的基于 Java 的部署工具提供的。通用任务接受（但不强制要求）嵌套的 arg 和 jvmarg 元素。将使用提供的属性生成一个 JVM。建议尽可能使用特定供应商的元素而不是通用元素。

通用元素支持以下属性。

属性	描述	必需
classname	这是要执行的基于 Java 的部署工具的完全限定类名。	是

嵌套元素

通用元素支持嵌套的 <arg> 和 <jvmarg> 元素。

示例

此示例展示了使用通用部署元素来使用基于 Java 的部署工具部署组件。

<serverdeploy action="deploy" source="${lib.dir}/ejb_myApp.ear">
    <generic classname="com.yamato.j2ee.tools.deploy.DeployTool"
             classpath="${classpath}"
             username="${user.name}"
             password="${user.password}">
        <arg value="-component=WildStar"/>
        <arg value="-force"/>
        <jvmarg value="-ms64m"/>
        <jvmarg value="-mx128m"/>
    </generic>
</serverdeploy>

WebLogic 元素

WebLogic 元素包含运行 weblogic.deploy 部署工具的附加属性。

该工具的有效操作是 deploy、undeploy、list、update 和 delete。

如果操作是 deploy 或 update，则必须设置 application 和 source 属性。如果操作是 undeploy 或 delete，则必须设置 application 属性。如果省略了 username 属性，则默认为 system。所有操作都需要 password 属性。

属性	描述	必需
application	这是正在部署的应用程序的名称	是
component	这是部署目标的组件字符串。它采用以下形式 `<component>:<target1>,<target2>...` 其中组件是存档名称（减去 `.jar`、`.ear`、`.war` 扩展名）。目标是将组件部署到的服务器	否
debug	如果设置为 true，则将在部署过程中打印更多信息。	否

示例

此示例展示了使用 serverdeploy 将组件部署到 WebLogic 服务器。

<serverdeploy action="deploy" source="${lib.dir}/ejb_myApp.ear">
    <weblogic application="myapp"
              server="t3://myserver:7001"
              classpath="${weblogic.home}/lib/weblogic.jar"
              username="${user.name}"
              password="${user.password}"
              component="ejb_foobar:myserver,productionserver"
              debug="true"/>
</serverdeploy>

此示例展示了 serverdeploy 用于从 WebLogic 服务器删除组件。

<serverdeploy action="delete" source="${lib.dir}/ejb_myApp.jar"/>
    <weblogic application="myapp"
              server="t3://myserver:7001"
              classpath="${weblogic.home}/lib/weblogic.jar"
              username="${user.name}"
              password="${user.password}"/>
</serverdeploy>

JOnAS（Java 开放应用服务器）元素

JOnAS 元素包含运行 JonasAdmin 部署工具的附加属性。

该工具的有效操作是 deploy、undeploy、list 和 update。

您不能在此任务中使用 user 和 password 属性。

属性	描述	必需
jonasroot	JOnAS 的根目录。	是
orb	选择您的 ORB：RMI、JEREMIE、DAVID 等。相应的 JOnAS JAR 会自动添加到类路径中。如果您的 `orb` 是 DAVID（RMI/IIOP），则必须指定 `davidhost` 和 `davidport` 属性。	否；默认为类路径中存在的 ORB
davidhost	系统属性的值：`david.CosNaming.default_host`。	否
davidport	系统属性的值：`david.CosNaming.default_port`。	否
classname	这是要执行的基于 Java 的部署工具的完全限定类名。	否；默认为 `org.objectweb.jonas.adm.JonasAdmin`

嵌套元素

jonas 元素支持嵌套的 <arg> 和 <jvmarg> 元素。

示例

此示例展示了使用 serverdeploy 将组件部署到 JOnAS 服务器。

<serverdeploy action="deploy" source="${lib.dir}/ejb_myApp.jar">
    <jonas server="MyJOnAS" jonasroot="${jonas.root}">
       <classpath>
           <pathelement path="${jonas.root}/lib/RMI_jonas.jar"/>
           <pathelement path="${jonas.root}/config/"/>
       </classpath>
    </jonas>
</serverdeploy>

此示例展示了 serverdeploy 用于列出 JOnAS 服务器和 WebLogic 服务器的组件。

<serverdeploy action="list"/>
    <jonas jonasroot="${jonas.root}" orb="JEREMIE"/>
    <weblogic application="myapp"
              server="t3://myserver:7001"
              classpath="${weblogic.home}/lib/weblogic.jar"
              username="${user.name}"
              password="${user.password}"/>
</serverdeploy>