jenkins 部署 git 项目

心已赠人 2022-07-13 03:58 276阅读 0赞

## 背景 ##

最近安装Jenkins，参照网上的各种资料进行尝试，折腾了好久，但是查找了这么多资料，相似度在90%以上！！！，相同的安装过程，[测试][Link 1]了几台机器，未曾成功，不得不感慨自己能力有限，最终慢慢摸索，形成思路，现分享给大家，希望大家在安装的时候少走弯路。

PS：本人很痛恨那种粘贴复制，毫无思考的博主，本想着拿着解决问题的心态，但结果还是一样，不但浪费了大家的时间，还浪费了大家的感情，所以，我把我遇到的问题和解决的方式记录下来和大家分享。

## 知识背景 ##

首先需要理解的是，Jenkins是帮我们将代码进行统一的编译打包、还可以放到tomcat容器中进行发布。

意思是我们通过配置，将以前：编译、打包、上传、部署到Tomcat中的过程交由Jenkins，Jenkins通过给定的代码地址URL，将代码拉取到其“宿主服务器”（这是我个人的称呼，在下边会用到，就是Jenkins的安装位置），进行编译、打包和发布到容器中。

因此我们可以注意到的是，在Jenkins的宿主服务器中必须要有可以进行：代码clone（[Git][]）、代码编译（Maven）、代码运行（Tomcat）的基本环境，其他文章上来就是安装jenkins，忽略了一些基本的配置。

下边就开始讲解各部分的安装过程，如果已经安装某一步的环境，则可以以此进行下一步。

## 一、Git的安装 ##

1、安装依赖

sudo yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel gcc perl-ExtUtils-MakeMaker

*  1

注意：perl-ExtUtils-MakeMaker 也是这些安装列表中的一员，不要因为显示的换行造成大家认为是两条执行命令。

2、下载Git

选择一个目录，存放下载的git，例如我的是：/home/xuliugen/tmp，大家可以根据需求到官网下载相应的版本

wget https://github.com/git/git/archive/v2.3.0.zip

*  1

3、解压git

下载之后是这样的，不要感到奇怪，直接解压即可

![这里写图片描述][20151218185102163]

因为下载的是一个zip，所以使用命令将其解压到git目录下：

#参数-d 后边的是解压到的目录
    unzip v2.3.0 -d git

*  1
 *  2

4、编译安装git

进入git目录

![这里写图片描述][20151218185413382]

将其安装在“/usr/local/git”目录下,命令如下：

make prefix=/usr/local/git all
    sudo make prefix=/usr/local/git install

*  1
 *  2

5、配置Git

sudo vim /etc/profile #编辑profile文件

*  1

然后而已看到这个文件已经有很多配置了，只需要在最下边添加git的路径即可：

export PATH=/usr/local/git/bin:$PATH

*  1

将这段话放在最后边，然后使用source命令应用修改:

source /etc/profile

*  1

6、检验Git是否安装成功

git --version

*  1

![这里写图片描述][20151218190754642]

## 二、Maven安装 ##

1、下载和解压Maven

Maven的安装包下载可以根据需求找到合适的版本，解压之后，我的位置是：

![这里写图片描述][20151218191318380]

2、配置Maven

编辑：~/.bash\_profile文件,根据注释相应的修改即可

# maven所在的目录 
    export M2_HOME=/home/xuliugen/software/maven/apache-maven-3.3.3
    # maven bin所在的目录 
    export M2=$M2_HOME/bin
    # 将maven bin加到PATH变量中 
    export PATH=$M2:$PATH
    # 配置JAVA_HOME所在的目录，注意这个目录下应该有bin文件夹，bin下应该有java等命令 
    export JAVA_HOME=/usr/lib/jvm/jre-1.7.0

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8

然后运行：source ~/.bash\_profile 应用修改

3、查看Maven是否安装成功

使用：mvn -version 即可查看结果

![这里写图片描述][20151218192019956]

## 三、Jenkins的部署 ##

Jenkins的安装很简单，直接将war放到容器中进行运行即可

1、将jenkins放到Tomcat中并解压，启动Tomcat，成功启动之后访问ip和端口如下：

![这里写图片描述][20151218192520727]

启动成功之后，进入的界面如上，表示启动成功。

2、安装插件

在进行配置之前，由于使用的是Git拉去代码的方式，所以要首先安装插件

![这里写图片描述][20151218193633583]

找到：插件管理 在“可选插件”界面使用ctrl+f 搜索：Deploy to [Container][] Plugin 插件（这个是支持将代码部署到tomcat容器的）

![这里写图片描述][20151218193834804]

勾选，点击下边的按钮：直接安装，这个可能时间较久，等待即可。

![这里写图片描述][20151218193933270]

安装完之后，如果勾选了：安装完成后重启jenkins 那么会重启jenkins。

然后安装:GIT plugin，何上边的步骤一样，如果使用上述的方式，由于网络的原因，可能会安装失败，这就需要我们使用另一种方式进行安装。

使用同样的方式在“可选插件”中搜索GIT plugin，找到之后点击蓝色链接（最好右键在新窗口中打开，放置覆盖jenkins界面）

![这里写图片描述][20151218194433833]

会跳转到Git Plugin的插件信息地址：

![这里写图片描述][20151218194551596]

可以看到Plugin ID为：git，然后在：[http://updates.jenkins-ci.org/download/plugins/][http_updates.jenkins-ci.org_download_plugins] 这地地方搜索（ctrl+f）即可找到，点进去，选择一个版本进行下载：

![这里写图片描述][20151218194731941]

![这里写图片描述][20151218194754631]

点进去下载的是一个hpi文件

然后同样的在：系统管理–管理插件–高级Tab中，下拉可以看到上传插件，然后选择文件上传刚才下载的hpi文件，即可，上传完之后，会自动安装。上述安装Deploy to container Plugin的方式也可以采用这种方式。

都安装完之后，在已安装Tab中可以看到刚安装的插件：

![这里写图片描述][20151218195413688]

3、进行配置

看到上图中的左侧有一个：系统管理 点击去

![这里写图片描述][20151218192705649]

上边的第一行黄色信息，表示编码问题，在Tomcat–>conf–>server.xml文件中修改即可

![这里写图片描述][20151218192835652]

4、Jenkins系统设置

点击：系统设置，这里没有强调的都设置为默认即可

（1）JDK，别名是任意的,选择自己jdk的位置，jenkins推荐使用sun jdk而不是openjdk

![这里写图片描述][20151218193358085]

（2）Git 的配置

![这里写图片描述][20151218195557240]

注意这里的git位置，是可执行文件的地址，即是git–bin–下的可执行文件 git的目录（类似于[Java][]中bin下的java可执行文件位置）

如果填错，后期回报无法找到git等错误（最下边，其他问题下的第三个问题），请大家注意！

（3）Ant的配置

由于本次并没有用到Ant，不做配置，大家可以根据配置进行设置

（4）Maven的配置，选择自己maven的存放位置

![这里写图片描述][20151218195813977]

（5）Jenkins Location

![这里写图片描述][20151218195938182]

这里配置的是ip加端口和一个路径名称，邮箱要进行设定，后期会发送jenkins执行的结果到邮件中

（6）邮件通知

![这里写图片描述][20151218200105578]

这里我配置的QQ邮箱，大家根据情况进行设置相应的smtp服务器，用户名、密码分别为自己的QQ邮箱何密码，如果不进行设置，后期jenkins构建项目的时候会报错，报错信息很好理解也很好找到是没有配置邮件的问题。

首先，要保证邮件的smtp和pop是开启状态的，这样的话才可以通过验证：

![这里写图片描述][20151218215854533]

最后点击下边的应用、保存即可

5、Configure Global Security

然后回到系统管理，看到Configure Global Security 点击进去，根据下边进行配置即可

![这里写图片描述][20151218200318537]

点击应用 保存之后，然后在屏幕的右上角，有一个登录-注册 ，点击注册即可实现用户的登录。

![这里写图片描述][20151218200512549]

这里，如果是公司内网的话，或者最后搭建的jenkins是公司使用，那么最好用户名和密码为公司的账户密码，邮件也是公司的邮件，这样的话方便后期的操作。

至此Jenkins的基本配置完成。

## 创建Job ##

1、创建项目

点击登录之后，会看到下边的界面中：My Views

![这里写图片描述][20151218200713879]

点击进去

![这里写图片描述][20151218200737251]

点击：创建一个新任务

![这里写图片描述][20151218200834163]

选择maven项目，点击OK，这里的Item名称是后边需要用到的，下边的配置也有用到这个的，大家可以很好的对应。

2、进行项目的配置

（1）源码管理选择Git，这个时候添加url之后，下边会报错，显示让去认证，认证即可（其他的安装中又遇到这个问题），如果认证失败，请下载认证Github Authentication plugin插件，这个在插件管理的可选插件中搜索安装。

我这里的rul是我在gitos上的一个项目，credentials是我在gitos上的用户名和密码认证。

![这里写图片描述][20151218201028481]

（2）构建触发器，就是什么时候执行jenkins的自动化部署

![这里写图片描述][20151218201211811]

选择第一个，其他的基本是定时执行什么的，大家可以自行查找，查看如何设置，根据需要进行配置

（3）Post Steps

![这里写图片描述][20151218201327970]

选择上图中的，然后下边 的Execute shell如下，脚本的编写在下边进行了详细的说明：

![这里写图片描述][20151218220932482]

#!/bin/bash 
    #copy file and restart tomcat 
    
    
    export JAVA_HOME=/opt/tools/jdk1.7.0_67
    export CATALINA_HOME=/opt/tools/apache-tomcat-7.0.70
    export BUILD_ID=dontKillMe
    
    
    tomcat_path=/opt/tools/apache-tomcat-7.0.70
    war_name=webTest.war 
    #war_path=http://132.153.131.237/:8022/jenkins/job/ManenDemo/ws/targetserver_port=8082 
    file_path=~/.jenkins/jobs/test/workspace/webTest/target
    
    
    $tomcat_path/bin/shutdown.sh 
    
    
    sleep 3s 
    
    
    echo "rm -rf ${tomcat_path}/webapps/ROOT/*"
    
    
    rm -rf ${tomcat_path}/webapps/ROOT/*
    
    
    cd $file_path
    
    
    cp ${war_name} ${tomcat_path}/webapps/ROOT/
    
    
    cd $tomcat_path/webapps/ROOT/
    
    
    unzip ${war_name}
    
    
    rm -rf ${war_name}
    
    
    sleep 5s 
    
    
    #$tomcat_path/bin/startup.sh
    
    
    cd $tomcat_path/bin/
    ./startup.sh

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13
 *  14
 *  15
 *  16
 *  17
 *  18
 *  19
 *  20
 *  21
 *  22
 *  23
 *  24
 *  25
 *  26
 *  27
 *  28
 *  29
 *  30
 *  31
 *  32
 *  33
 *  34
 *  35
 *  36
 *  37
 *  38
 *  39
 *  40

（4）邮件通知

![这里写图片描述][20151218201519607]

至此基本设置完毕，点击应用、保存

（5）立即构建

点击左上角的立即构建

![这里写图片描述][20151218201630782]

然后看到下边的Build History 点击蓝色的进去，会进入Console

![这里写图片描述][20151218201755886]

下边是进行jar的下载，会下载到宿主服务器的maven仓库中：

![这里写图片描述][20151218221308245]

下边的信息表示项目编译通过：

![这里写图片描述][20151218201837028]

下边是运行脚本的信息：

![这里写图片描述][20151218201856383]

## 脚本的分析 ##

在Jenkins的服务器上查看：

![这里写图片描述][20151218202449077]

![这里写图片描述][20151218202709253]

可以看到在/root/.jenkins这个目录，实际存放了Jenkins拉取Git代码之后编译好war的位置，到此，大家也许都该明白了，编译后的位置就在这里啊！然后，接着是部署到宿主服务器的Tomcat容器中，如何将编译好的war放到tomcat中，这就需要脚本来完成，也是上述过程中配置的过程，下边对每一行进行分析。

首先我们应该明白，将编译好的war放到tomcat容器中，我们首先要知道这两个的位置：编译后war的位置和目标容器的位置，很显然我们是知道的。

1、脚本文件的头，这个没得说

#!/bin/bash

*  1

2、环境变量设置

export JAVA_HOME=/data/home/server/jdk
    export CATALINA_HOME=/home/xuliugen/dubbo-provider
    export CATALINA_BASE=/home/xuliugen/dubbo-provider
    export BUILD_ID=dontKillMe

*  1
 *  2
 *  3
 *  4

上边的各个位置，大家也许都知道，CATALINA\_HOME和CATALINA\_BASE的位置就是Tomcat容器的位置，这里根据需求我将Tomcat容器的名字改为dubbo-provider了，如果改成/home/xuliugen/tomcat是不是更好理解。

export BUILD\_ID=dontKillMe这一句很重要，因为该job启动完后执行下一job,jenkins直接把tomcat进程杀了，所以无论脚本中怎么写了启动tomcat的命令，他是不会启动的。虽然上述截图中显示了Tomcat started、server restarted但是访问项目地址是访问不了的，这在：其他问题的第二个说明了这个问题。

3、其他路径位置

tomcat_path=/home/xuliugen/dubbo-provider #我的Tomcat位置
    project=dubbo-provider #我的项目编译的名称
    war_name=dubbo-provider.war  #最后打包的war名称
    war_path=http://132.153.131.237/:8022/jenkins/job/ManenDemo/ws/targetserver_port=8082 #宿主服务器的ip何端口
    file_path=~/.jenkins/jobs/ManenDemo/workspace/spring_provider/target  #编译好的war包存放地址

*  1
 *  2
 *  3
 *  4
 *  5

这个：war\_path 其实也就是Jenkins的宿主服务器位置IP，端口为jenkins运行的端口，大家只需要将ip地址端口ManenDemo换成自己的即可；

file\_path：就是Jenkins帮我们编译好的项目war的位置，上图中大家也可以看到，并且大家不可以完全按照上边的路径，要找到自己宿主服务器上实际war的位置，进行设置。

4、耳熟能详的执行命令

下边就是我们在使用原始方式，部署war的命令，大家很简单的可以理解，其中：

注意：个人写脚本的能力有限，所以我是假设项目已经在运行的情况下，因此我上来就是先关闭Tomcat，（正确的方式，应该判断端口是否打开，如果本身tomcat未启动，我的这种情况，会在Jenkins的Console中报拒绝连接的问题，如下图）。

![这里写图片描述][20151218222319885]

另外用到了sleep 3s 这个可以让线程休眠一下，这样的话可以看一下tomcat的日志信息。

下边的脚本就是删除原来容器中的文件，然后将编译好的war移动到容器中，解压。运行tomcat。

$tomcat_path/bin/shutdown.sh 
    sleep 3s 
    echo "rm -rf ${tomcat_path}/webapps/ROOT/*"
    rm -rf ${tomcat_path}/webapps/ROOT/*
    cd $file_path
    cp ${war_name} ${tomcat_path}/webapps/ROOT/
    cd $tomcat_path/webapps/ROOT/
    unzip ${war_name}
    rm -rf ${war_name}
    sleep 5s 
    cd $tomcat_path/bin/
    ./startup.sh
    echo "server restarted"

*  1
 *  2
 *  3
 *  4
 *  5
 *  6
 *  7
 *  8
 *  9
 *  10
 *  11
 *  12
 *  13

## 将项目布署到远程Tomcat ##

上述创建项目，可以看出是在本地进行执行的，也就是进行编译后执行的Tomcat是何Jenkins的宿主服务器是在一起的，这很显然不符合我们常规的公司及其部署的方案，通常是将编译之后的代码在运行到其他的Tomcat服务器中的，下边有两种方式，将编译之后的项目部署到远程服务器中。

1、使用脚本的方式部署到远程服务器

2、使用`Deploy to container Plugin`插件部署到远程服务器

插件下载地址：http://updates.jenkins-ci.org/download/plugins/deploy/1.10/deploy.hpi

上述的开始阶段就安装了这个插件，下边就开始发挥其作用。

![这里写图片描述][20151221174515978]

在创建的Job左侧点击设置，其他配置何在远程搭建项目是一致的，不同的是在这个地方：

![这里写图片描述][20151221174651648]

以前我们在编译之后，将编译后的通过脚本补助到Jenkins的宿主服务器，使用插件，就不需要这种方式了。

![这里写图片描述][20151221174801916]

还有就是的在构建之后，将编译后的文件`**/target/dubbo-provider.war`（就是上边的~/.jenkins/jobs/ManenDemo/workspace/spring\_provider/target目录）部署到下边的远程Tomcat容器中；这里Containers的用户名和密码是Tomcat管理员的账户密码，Tomcat URL 就是你需要进行部署的远程Tomcat服务器的ip和端口。

这里需要进行设置的是远程Tomcat的管理员信息，修改远程Tomcat容器下的conf–tomcat-users.xml文件，在内添加下边的内容：

注意 manager-script 这个必须得有，不然的话这个用户就没有操作脚本的权限了。

*  1
 *  2
 *  3
 *  4
 *  5

即可实现远程的访问，测试是可以通过的，但是有一个问题，通过这种方式，只将war复制到了wenapps下：

![这里写图片描述][20151221182429438]

因此这种方式的话，我们访问的时候必须是ip、端口和项目名，例如：

http://115.159.151.247:8030/dubbo-provider/

*  1

当然这种方式 也是在实际的应用中不提倡的，解决方式就是修改Tomcat默认的访问路径即可，设置Tomcat–conf–server.xml文件如下：   
在Host节点之间添加：

*  1

![这里写图片描述][20151221183654759]

或者在docBase里边输入项目的绝对路径，例如我的：

*  1

然后重启Tomcat，这样的话,[http://ip:8030/dubbo-provider/][http_ip_8030_dubbo-provider] 和[http://ip:8030][http_ip_8030]这两种方式都可以访问到该项目。

![这里写图片描述][20151222102329094]

![这里写图片描述][20151222102348289]

## 其他问题 ##

1、部署项目的时候报错

![这里写图片描述][20151218204314021]

这个大家很好理解，是因为下载jar失败的问题，由于是第一次使用Maven，需要第一次下载很多jar到Maven仓库中，由于网络的问题下载失败，大家可以多次构建让他重新下载，或者直接到：[https://repo.maven.apache.org/maven2][https_repo.maven.apache.org_maven2] 根据报错的jar，在maven2中找到自己缺失的jar，然后在`/root/.m2/repository` 相应的位置添加jar即可。

2、编写脚本文件启动tomcat但是项目仍然运行不起来

就是上边说道的问题了：   
添加：`export BUILD_ID=dontKillMe`，因为该job启动完后执行下一job,jenkins直接把tomcat进程杀了，所以无论脚本中怎么写了启动tomcat的命令，他是不会启动的。

3、遇到下边的问题

![这里写图片描述][20151218215257875]

这就是在系统设置的时候，设置的git的地址不对，上述已经说明了，应该是git的可执行文件的地址，如果只是git的目录，是无法找到git这个可执行文件的，如下：

![这里写图片描述][20151218222704835]

可以看出使用的是这个：/usr/local/git/bin/git 进行git仓库的配置何代码的拉取，因此这设置git的目录，jenkins默认是不会找bin目录下的git可执行文件的。

至此，Jenkins的部署完成，希望对大家有所帮助。

[Link 1]: http://lib.csdn.net/base/softwaretest
[Git]: http://lib.csdn.net/base/git
[20151218185102163]: /images/20220713/55f7a4c1794d4e23ad4d287795fcd744.png
[20151218185413382]: /images/20220713/b5ea062a69ae4ebc985169df2ce03bf1.png
[20151218190754642]: /images/20220713/081edb759ff34055b0a9891eabb69e93.png
[20151218191318380]: /images/20220713/1c940d1fbb5543db84422b51cac32146.png
[20151218192019956]: /images/20220713/bffb0c0f852d402f932595cb0a26aaa3.png
[20151218192520727]: /images/20220713/5411af12d0fb42faadb62fb4d19675e0.png
[20151218193633583]: /images/20220713/fa807af73e7f4b17a2343b25f0c42354.png
[Container]: http://lib.csdn.net/base/docker
[20151218193834804]: /images/20220713/411557572fc749ff8b2b5ca872d98437.png
[20151218193933270]: /images/20220713/8c357049053748928ad73bbf897464e5.png
[20151218194433833]: /images/20220713/435a4a6ad9f84fc0a00c815a86fd9614.png
[20151218194551596]: /images/20220713/d8c7012030ad439990f3e04606fc2484.png
[http_updates.jenkins-ci.org_download_plugins]: http://updates.jenkins-ci.org/download/plugins/
[20151218194731941]: /images/20220713/73a66060f22643a8adbc0d73ab391c74.png
[20151218194754631]: /images/20220713/612e1d2371d94bb8a9c4d05f97c2ad3e.png
[20151218195413688]: /images/20220713/c6aef267c8e14303bf1be6e99ce881f3.png
[20151218192705649]: /images/20220713/36d5c651c90e413094490d7bf5024806.png
[20151218192835652]: /images/20220713/2459a20a41b4420a9b0b4d527444ad1f.png
[20151218193358085]: /images/20220713/1f987c5da44446b9b5affb35c943268e.png
[20151218195557240]: /images/20220713/bceadc882ae740a6a4b80cf20011ae74.png
[Java]: http://lib.csdn.net/base/javase
[20151218195813977]: /images/20220713/0ab054dd00fb4a5c8c480dc92e01f87e.png
[20151218195938182]: /images/20220713/d719de83e0234f12a8e929ce586e43dc.png
[20151218200105578]: /images/20220713/485ec26bf55f43e189cf695b5a20fad2.png
[20151218215854533]: /images/20220713/5eca1645b07a4ec79bddf576dfd9a3fd.png
[20151218200318537]: /images/20220713/e956b95e9bff4b96a9916c2a430f3b7a.png
[20151218200512549]: /images/20220713/b3b17f71d0294e7f933672e4e64763a8.png
[20151218200713879]: /images/20220713/483ad1e0697f4e8e91db7b4e67eb622b.png
[20151218200737251]: /images/20220713/cf1454e756ef4c428858c1d7f19ac0c3.png
[20151218200834163]: /images/20220713/f06a6f910a1141acaf962cb544582e9f.png
[20151218201028481]: /images/20220713/f014cd98f2514a2c83785a173d44c7b3.png
[20151218201211811]: /images/20220713/a1954671513e47c5a90c687dffe549fa.png
[20151218201327970]: /images/20220713/ec8f8261bed249429b5151f24dde4b52.png
[20151218220932482]: /images/20220713/5f01963f61b9435f96064ecc2033f509.png
[20151218201519607]: /images/20220713/553118c203564e61aed5ded106cb79bf.png
[20151218201630782]: /images/20220713/54a771f9028c40d28f15c2fbb76ce911.png
[20151218201755886]: /images/20220713/b913aefc1688449cb7794606d5450e7a.png
[20151218221308245]: /images/20220713/cd01c9832f264a92b9e324d6e25f394a.png
[20151218201837028]: /images/20220713/11c77599865a4177a29274109eab36ed.png
[20151218201856383]: /images/20220713/6e91c31a08d04f08afc47b953c733444.png
[20151218202449077]: /images/20220713/8af262ab90cc4b29bed8ef7172d61bc0.png
[20151218202709253]: /images/20220713/f37e4f77368c4cb2b5c984e89a57891c.png
[20151218222319885]: /images/20220713/da3e45b62ff64838b4095e4c6a76a26d.png
[20151221174515978]: /images/20220713/2a4e4ab6e78745f0a159708b1f62f357.png
[20151221174651648]: /images/20220713/3a5203f57bfb47d79e5f0b9b578cd2c2.png
[20151221174801916]: /images/20220713/eb451d22e4e54ed5a5090909e5adb300.png
[20151221182429438]: /images/20220713/ec10a9c77f8e48db97349296234c4ad9.png
[20151221183654759]: /images/20220713/475138b768d94a9da963b3b693986dc6.png
[http_ip_8030_dubbo-provider]: http://ip:8030/dubbo-provider/
[http_ip_8030]: http://ip:8030/
[20151222102329094]: /images/20220713/b7af9cae7c3e4e67b389b702b304ae17.png
[20151222102348289]: /images/20220713/c05717f474f44fdda995c0300b9775ee.png
[20151218204314021]: /images/20220713/4027f208440d40e48e3ee49b789ac85d.png
[https_repo.maven.apache.org_maven2]: https://repo.maven.apache.org/maven2
[20151218215257875]: /images/20220713/4f718c958919463f92e0213278bb7711.png
[20151218222704835]: /images/20220713/f768b2e79403407c91c560205f378f8b.png