1 应用背景

​ 对于大型的项目,现在有很多CI/CD 持续集成/部署方式。如下图:

但是对于小型项目来说,其实有时候用不到这么多东西。项目的体量、以及更新迭代、维护等方面,都不至于做如此自动化的流程。杀鸡焉用宰牛刀嘛。

​ 不知道大家有没有遇到过这样的场景: 总是要用maven打包好项目,再用SSH 连接Linux服务器 ,再上传jar包,然后使用shell命令启动java应用。

为了避免这一重复操作,为大家介绍一款maven插件。可以一键上传、部署运行java项目。

2. wagon-maven-plugin 插件自动打包部署jar包

2.1 配置Linux服务器用户名和密码

​ 在maven 的 settings.xml中添加:

<!--这一步可以省略:用户名密码可以手动输入;也可以在下面配置服务器url的时候加上用户名和密码   -->
<servers>
    <server>
        <id>linux-server-dev</id>
        <username>root</username>
        <password>123456</password>
    </server>
</servers>

2.2 添加依赖

 <dependency>
            <groupId>org.codehaus.mojo</groupId>
            <artifactId>wagon-maven-plugin</artifactId>
            <version>2.0.0</version>
</dependency>

2.3 首先实现打包后,自动上传jar包

​ 编辑pom.xml中的 <build> 标签 </build>

<build>
	<extensions>
		<extension>
			<groupId>org.apache.maven.wagon</groupId>
			<artifactId>wagon-ssh</artifactId>
			<version>2.8</version>
		</extension>
	</extensions>
	<plugins>
		<plugin>
			<groupId>org.codehaus.mojo</groupId>
			<artifactId>wagon-maven-plugin</artifactId>
			<version>1.0</version>
			<configuration>
                <!-- serverId即在settings.xml中配置的service的id -->
				<serverId>linux-server-dev</serverId>
                <!-- 要上传到服务器的文件,一般来说是jar或者war包 -->
				<fromFile>target/project_name.jar</fromFile>
				<!-- 配置服务器的地址以及文件上传的目录。 -->
                <!-- 如果2.1 serverId配置省略了,可以这么写:
				scp://user:password@192.168.1.1/home/project_name/	-->
				<!-- 注意上传的路径中不能带有横杠'-',例如/home/project-name ,否则会导致无法执行远程shell命令 -->
                                <url>scp://192.168.1.1/home/project_name/</url>
			</configuration>
		</plugin>
	</plugins>
</build>

配置完成后,在cmd终端 cd到 项目pom.xml文件同一级, 运行命令:mvn clean package wagon:upload-single 打包并上传。

2.4 实现自动启动/重启java应用

编辑pom.xml中的 <build> 标签: </build>

<build>
	<extensions>
		<extension>
			<groupId>org.apache.maven.wagon</groupId>
			<artifactId>wagon-ssh</artifactId>
			<version>2.8</version>
		</extension>
	</extensions>
	<plugins>
		<plugin>
			<groupId>org.codehaus.mojo</groupId>
			<artifactId>wagon-maven-plugin</artifactId>
			<version>1.0</version>
			<configuration>
				<serverId>linux-server-dev</serverId>
				<fromFile>target/project_name.jar</fromFile>
				<url>scp://192.168.20.128/home/project_name/</url>
				<commands>
                    <!-- 启动/重启jar包的shell脚本,需要自己编写,放在/home/project_name 目录下即可-->
					<command>sh ./restart.sh</command>
                     <!-- 也可以直接执行命令-->
                    <command><![CDATA[nohup java -jar /home/project_name/xx.jar &]]><command>
				</commands>
				<!-- 显示运行命令的输出结果 -->
				<displayCommandOutputs>true</displayCommandOutputs>
			</configuration>
		</plugin>
	</plugins>
</build>

运行命令:mvn clean package wagon:upload-single wagon:sshexec

打包、上传、执行shell脚本或者命令

2.5 maven install 一键打包、部署

如果觉得每次输入 mvn clean package wagon:upload-single wagon:sshexec 还是很麻烦的话。可以配置execution

<build>
	<extensions>
		<extension>
			<groupId>org.apache.maven.wagon</groupId>
			<artifactId>wagon-ssh</artifactId>
			<version>2.8</version>
		</extension>
	</extensions>
	<plugins>
		<plugin>
			<groupId>org.codehaus.mojo</groupId>
			<artifactId>wagon-maven-plugin</artifactId>
			<version>1.0</version>
            <executions>
				<execution>
					<id>upload-deploy</id>
					<!-- 运行package打包的同时运行upload-single和sshexec -->
					<phase>package</phase>
					<goals>
						<goal>upload-single</goal>
						<goal>sshexec</goal>
					</goals>
                    <configuration>
                        <serverId>linux-server-dev</serverId>
                        <fromFile>target/project_name.jar</fromFile>
                        <url>scp://192.168.20.128/home/project_name/</url>
                        <commands>
                            <!-- 启动/重启jar包的shell脚本,需要自己编写,放在/home/project_name 目录下即可-->
                            <command>sh ./restart.sh</command>
                             <!-- 也可以直接执行命令-->
                            <command><![CDATA[nohup java -jar /home/project_name/xx.jar &]]><command>
                        </commands>
                        <!-- 显示运行命令的输出结果 -->
                        <displayCommandOutputs>true</displayCommandOutputs>
                    </configuration>
                    </execution>
			</executions>
		</plugin>
	</plugins>
</build>

配置完后mvn clean package 即可 一键打包部署。

我用的是spring tools suite (其实就是eclipse )开发,右键项目-> Run as -> maven install 就直接一键 打包部署了。因为maven install 里包含了 package 这个命令。关于shell

3.后记

3.1使用的时候遇到了一个小问题

就是总是让我输入服务器密码。提示:

Keyboard interactive required, supplied password is ignored

交互式面板,提供的密码被忽略。google了一下。
StackOverflow找到了一篇问答。


vi /etc/ssh/sshd_config

service sshd restart 修改之后重启服务

3.2 shell命令参考

​ 这里提供 杀掉 老的服务启动进程命令。jar包的启动命令自己添加。

​ 如果有启动进程才执行kill ,这样判断的好处是,如果没有服务运行,执行kill脚本,不会再提示参数不够了。

#killold.sh
if [[ -n $(ps -ef | grep 项目的部分名称* | grep -v grep ) ]]; then
echo  'kill old process'
ps -ef | grep 项目的部分名称* | grep -v grep | awk '{print $2}' | xargs kill -9
fi

以下我的具体配置。 为什么java -jar 启动命令 没有和 killold.sh 写在同一个脚本呢? 一开始是写在一起的叫 restart.sh 不过新的服务总是启动不了。就拆开写了。读者可以自己试一试。