Ant内置任务之sshsession

一、概述

        sshsession是Ant1.8引入的内置任务，用于与运行ssh守护进程的远程计算机建立ssh连接。可以选择在该连接上建立任意数量的本地或远程隧道，并且在连接关闭之前执行任意的嵌套任务。此任务需要外部包jsch.jar版本为0.1.42+。

二、属性

        host：要连接的远程主机的主机名或ip地址。
        username：要连接的远程主机的用户名。
        port：连接到远程主机的端口，默认为22。
        localtunnels：以逗号分隔的lport:rhost:rport列表，用于定义本地端口转发。如果同时嵌套了localtunnel元素，将建立两组隧道。
        remotetunnels：以逗号分隔的rport:lhost:lport列表，用于定义远程端口转发。如果同时嵌套了remotetunnel元素，将建立两组隧道。
        trust：如果设置为true/yes，则信任所有未知主机。如果设置为false，则连接的主机必须在knownhosts中列出，默认为false。
        knownhosts：设置用于验证远程主机标识的已知主机文件，文件必须是ssh2格式的。默认为${user.home}/.ssh/known_hosts。
        failonerror：如果命令未成功完成，是否停止构建，默认为true。
        password：密码，如果使用的是基于密钥的身份验证，或者在file或todir属性中设置了密码，则不需此属性。
        keyfile：保存私钥的文件的位置，如果使用基于密钥的认证，则必须设置此属性。
        passphrase：私钥的密码。默认为空字符串。
        timeout：如果在指定的毫秒时间内无法建立连接，则放弃。默认为0，即永远等待。

        支持以下嵌套元素：
        localtunnel：可以选择使用任意数量的localtunnel元素，通过ssh连接定义本地端口转发，具有以下属性：
                lport：要转发的本地端口号。
                rhost：本地端口要转发到的远程主机的主机名或ip地址。
                rport：本地端口要转发到的远程主机的端口号。
        remotetunnel：可以选择使用任意数量的remotetunnel元素定义通过ssh连接的远程端口的转发，具有以下属性：
                rport：要转发的远程端口号。
                lhost：远程端口应转发到的本地主机的主机名或ip地址。
                lport：应向其转发远程端口的本地主机的端口号。
        sequential：sequential元素是必须的，它是在ssh建立连接并建立所有本地或远程隧道后要执行的操作的任务的容器。

三、简单示例

<project>
	<sshsession host="192.168.0.112" username="root" password="root" trust="true">
		<sequential>
			<scp trust="true" file="build.xml" todir="root:root@192.168.0.112:/root"/>
		</sequential>
	</sshsession>
</project>