Jenkins远程部署war包到tomcat

网上关于这个的文章也是数不胜数了，但是稍不注意还是会掉坑里了，好不容易配置成功在这里记录一下。

关于怎么搭建Jenkins自动构建之前已经写过，这里就再补充一下自动远程部署的情况。

准备

在开始之前，服务器上需要有安装好环境，如：JDK，Tomcat等

配置好环境变量同时，在Jenkins和Gitlab上创建好项目。

项目文件配置

来依次看一下关于项目的文件配置，包括Maven的配置等。

pom.xml配置

<packaging>war</packaging>

<properties>
<warPackageName>spring</warPackageName>
<tomcat.deploy.server>tomcat8</tomcat.deploy.server>
<tomcat.deploy.serverUrl>http://192.168.1.2:8088/manager/text</tomcat.deploy.serverUrl>
</properties>

<build>
<finalName>spring</finalName>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>tomcat-maven-plugin</artifactId>
<version>1.1</version>
<configuration>
<server>${tomcat.deploy.server}</server>
<url>${tomcat.deploy.serverUrl}</url>
<path>/${warPackageName}</path>
</configuration>
</plugin>
</plugins>
</build>

我这里tomcat版本使用的8，如果使用的是tomcat6.x的话，serverUrl需要改为

http://192.168.1.2:8080/manager

。

在这里

<tomcat.deploy.server>tomcat8</tomcat.deploy.server>

，其中tomcat8是需要在Maven的.settings.xml文件中配置的。

Maven settings配置

~/.m2/.settings.xml

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <servers>
<server>
<id>nexus-snapshots</id>
<username>admin</username>
<password>lhy123</password>
</server>
<server>
<id>tomcat8</id>
<username>deployer</username>
<password>dev</password>
</server>
</servers>

<mirrors>
<mirror>
<id>nexus</id>
<name>internal nexus repository</name>
<url>http://192.168.1.2:8081/repository/maven-central/</url>
<mirrorOf>*</mirrorOf>
</mirror>
</mirrors>

</settings>

在这里主要是看server中的tomcat8配置，需要tomcat的用户名和密码。至于其他的是关于nexus的配置，以后有机会再写一篇详细说明Nexus的吧。

tomcat的用户名和密码就需要我们到服务器上去配置了。

服务器配置

服务器上主要是tomcat用户配置和Maven settings配置。

是的，本地配置那个是方便在本地就可以直接部署到服务器，但是如果是用Jenkins来帮我们自动的部署的话就需要在服务器上也配置一下Maven Settings了，否则在构建好后是无法进行远程部署的，因为不知道tomcat的用户名和密码。

在这里我们直接复制本地的.settings.xml文件到服务器就好，也有个地方需要注意了。

.settings.xml这个文件不是随便放的，需要放到启动jenkins的用户的那个home目录下面的.m2/目录中。

因为我是直接从Jenkins官网下载了war包，然后丢到tomcat中运行的。

所以这里我需要将.settings.xml文件放到

/usr/share/tomcat8/.m2/

中。

需要注意的是文件权限问题，我是为了偷懒直接用系统

# apt-get install tomcat8

安装的，系统会自动创建tomcat8用户。

所以还需要额外执行一条命令：

# chown tomcat8:tomcat8 .settings.xml

即可。

如果是自己从apache tomcat官网下载的压缩包的话，就看你启动tomcat服务用的哪个系统用户了，就把.settings.xml文件丢到那个用户的

$HOME/.m2/

下即可。

tomcat配置

先在tomcat用户配置文件中添加一个用户，并给予manager-script权限就行。

在我这里是编辑

/etc/tomcat8/tomcat-users.xml

文件

<tomcat-users>
<role rolename="admin-gui"/>
<role rolename="manager-gui"/>
<user username="tomcat" password="tomcat" roles="admin-gui,manager-gui"/>
<user username="deployer" password="dev" roles="manager-script"/>
</tomcat-users>

主要看deployer这个用户就行了。

Jenkins构建配置

好了，最后再说一下，在Jenkins中执行的构建命令


)

这里需要注意,执行的是mvn tomcat:redeploy。

网上很多教程说的是mvn tomcat7:redeploy，我这边死活不行，总是报错。

No plugin found for prefix 'tomcat7' in the current project.

暂时不知道是什么原因，先不管了。

总结

做开发的就是一路趟坑啊，尤其是web方面。感觉就这么一点小小的东西都折腾了好一番，真是路漫漫兮其修远矣。但是为了前途咱还是得一路顶上去呢，吾必将上下而求索~

致还在年轻奋斗的我们。。