使用antrun实现远程服务器自动部署

女爷i 2023-10-17 23:11 13阅读 0赞

背景：  
后端开发的日常，频繁的mvn打包，且每次都需要上传到服务器并启动服务，如果仅有Tomcat服务还可以忍受，但是当服务比较复杂需要部署多个jar包war包时，不仅效率低下而且容易出错，手工部署就会变成程序员的噩梦。  
antrun只需要简单的几部，就可以实现自动化部署，解放程序猿的双手~

步骤：  
一、maven工程的pom.xml中配置antrun的相关插件（注意是工程的主pom）

<plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-antrun-plugin</artifactId>
        <version>1.8</version>
        <executions>
            <execution>
                <inherited>false</inherited>
                <id>default-cli</id>
                <configuration>
                    <target>
                        <echo>start stopping provider</echo>
                        <sshexec host="${deploy.server.host}" username="root"
                            password="${deploy.server.password}" command="export PATH=$PATH:${deploy.jdk.bin.path};echo $PATH;${deploy.provider.path}/stop.sh"
                            failonerror="false" verbose="true" trust="true" />
                        <echo>start copying provider jar</echo>
                        <scp
                            localFile="demo/target/demo-0.0.1-SNAPSHOT.jar"
                            remoteToFile="root:${deploy.server.password}@${deploy.server.host}:${deploy.provider.path}/demo-0.0.1-SNAPSHOT.jar"
                            verbose="true" trust="true" />
                        <echo>start starting provider jar</echo>
                        <sshexec host="${deploy.server.host}" username="root"
                            password="${deploy.server.password}" command="export PATH=$PATH:${deploy.jdk.bin.path};echo $PATH;${deploy.provider.path}/run.sh"
                            failonerror="false" verbose="true" trust="true" />
                        <echo>start stopping Tomcat</echo>
                        <sshexec host="${deploy.server.host}" username="root"
                            password="${deploy.server.password}" command="export PATH=$PATH:${deploy.jdk.bin.path};echo $PATH;${deploy.tomcat.bin.path}/shutdown.sh"
                            failonerror="false" verbose="true" trust="true" />
                        <echo>start copying Tomcat war</echo>
                        <scp localFile="demo/target/demo.war"
                             remoteToFile="root:${deploy.server.password}@${deploy.server.host}:${deploy.tomcat.webapps.path}/demo.war"
                             verbose="true" trust="true" />
                        <echo>start starting Tomcat</echo>
                        <sshexec host="${deploy.server.host}" username="root"
                            password="${deploy.server.password}" command="export PATH=$PATH:${deploy.jdk.bin.path};echo $PATH;${deploy.tomcat.bin.path}/startup.sh"
                            failonerror="false" verbose="true" trust="true" /> 
                    </target>
                </configuration>
            </execution>
        </executions>
        <dependencies>
            <dependency>
                <groupId>org.apache.ant</groupId>
                <artifactId>ant-jsch</artifactId>
                <version>1.10.1</version>
            </dependency>
            <dependency>
                <groupId>com.jcraft</groupId>
                <artifactId>jsch</artifactId>
                <version>0.1.54</version>
            </dependency>
        </dependencies>
    </plugin>

这段代码片段做了以下几件事：  
1、关闭dubbo provider服务  
2、将打包的provider服务jar包上传到服务器相应的路径  
3、启动dubbo provider服务  
4、关闭Tomcat  
5、将打包的war包上传到服务器相应的路径  
6、启动Tomcat

这里使用了maven-antrun-plugin插件，它可以执行ant target，进行拷贝文件，执行sh脚本、linux命令等。  
1、sshexec

作用是建立一个远程的shell连接。远程服务器的地址、用户名、密码可以通过变量自行定义。command=后面跟着的就是Linux命令。可以同时发送多条指令，指令间用“;”分隔。（command后的指令在后面进行具体分析）  
**注意：trust属性一般设置为true,　如果为默认值false时,那么就要求你所连接的host必须存在于你的knownhosts文件中，并且这个文件也必须是存在的**  
2、scp

作用是将本地的文件拷贝到远程服务器。localFile指定本地文件放置的位置，也就是打包后的jar包或者war包位置；remoteToFile指定了远程服务器的地址、用户名、密码、文件拷贝位置。

涉及到的变量可以在pom.xml中通过properties来配置，如下：

<properties>
        <deploy.server>webserver</deploy.server>
        <deploy.server.host>xxx.xx.xx.xx</deploy.server.host>
        <deploy.server.password>abc123</deploy.server.password>
        <deploy.tomcat.bin.path>/home/demo/apache-tomcat-8.5.31/bin</deploy.tomcat.bin.path>
        <deploy.tomcat.webapps.path>/home/demo/apache-tomcat-8.5.31/webapps</deploy.tomcat.webapps.path>
        <deploy.provider.path>/home/demo/provide</deploy.provider.path>
        <deploy.jdk.bin.path>/data/jdk1.8.0_181/bin</deploy.jdk.bin.path>
    </properties>

二、编写shell脚本，实现服务的关闭和启动  
从第一步可以看出，停止和启动服务，是通过远程调用shell脚本来实现的，下面我们就来编写脚本。  
1、启动dubbo provider脚本

#!/bin/bash
    java -jar /home/demo/provide/demo-0.0.1-SNAPSHOT.jar >/dev/null 2>&1 &
    echo $! > /home/demo/provide/demo.pid
    sleep 20

a、后台运行的方式启动jar包；  
b、将进程的pid记录到文件。为了关闭该进程做准备；  
c、等待20s。因为紧接着要启动Tomcat，需要延时一会儿是为了保证dubbo服务完全启动。

2、关闭dubbo provider脚本

#!/bin/bash
    PID=$(cat /home/demo/provide/demo.pid)
    kill -9 $PID

a、从文件中读取进程pid  
b、kill进程

3、关闭、启动Tomcat的脚本  
shutdown.sh和startup.sh是Tomcat自带，不需要另写，只要把脚本所在位置配置好即可。

三、执行过程中遇到的问题：  
启动jar包和war包时，找不到JAVA\_HOME的环境变量，导致运行失败。  
原因：  
ant的sshexec连接的时候，是不会执行/etc/profile ~/.profile ~/.bash\_profile的，于是这个会话当中etc/profile定义的JAVA\_HOME环境变量就没有生效。  
解决办法：  
第一步中的代码片段可以看到解决办法：

command后有三条指令：

export PATH=$PATH:${deploy.jdk.bin.path}
    echo $PATH
    ${deploy.provider.path}/stop.sh

a、将jdk的路径配置到环境变量中，只在该shell中生效；  
b、回显环境变量path，看一下是否成功配置；  
c、执行脚本。

以上。

参考文档：  
[https://www.cnblogs.com/chenpi/p/5715029.html][https_www.cnblogs.com_chenpi_p_5715029.html]  
[http://sky425509.iteye.com/blog/2074264][http_sky425509.iteye.com_blog_2074264]  
[https://blog.csdn.net/hnoysz/article/details/78666272][https_blog.csdn.net_hnoysz_article_details_78666272]  
[https://blog.csdn.net/u79501/article/details/68925353][https_blog.csdn.net_u79501_article_details_68925353]

[https_www.cnblogs.com_chenpi_p_5715029.html]: https://www.cnblogs.com/chenpi/p/5715029.html
[http_sky425509.iteye.com_blog_2074264]: http://sky425509.iteye.com/blog/2074264
[https_blog.csdn.net_hnoysz_article_details_78666272]: https://blog.csdn.net/hnoysz/article/details/78666272
[https_blog.csdn.net_u79501_article_details_68925353]: https://blog.csdn.net/u79501/article/details/68925353