Linux/Windows上Jenkins + Maven + Git的安装

第一部分：认识Jenkins

Jenkins是一个开源软件项目，旨在提供一个开放易用的软件平台，使持续集成变成可能。

Jenkins，之前叫做Hudson，是基于Java开发的一种持续集成工具，用于监控秩序重复的工作，包括：

1、持续的软件版本发布/测试项目。

2、监控外部调用执行的工作。

Jenkins搭建

下载jenkins.war

有两种启动方法。

首先保证系统中已经安装了jdk，最好是jdk1.5以上。

第一种启动方法，切换到jenkins.war存放的目录，输入如下命令：

$ java -jar jenkins.war

然后在浏览器中（推荐用火狐）输入http://localhost:8080，localhost可以是本机的ip，也可以是计算机名。就可以打开jenkins

第二种方法是用tomcat打开

解压tomcat到某个目录,如/usr/local，进入tomcat下的/bin目录，启动tomcat

将jenkins.war文件放入tomcat下的webapps目录下，启动jenkins时，会自动在webapps目录下建立jenkins目录，所以在地址栏上需要输入的地址与上一种方法有点不一样：

http://localhost:8080/jenkins。

 

你的一定很好奇你对Jekins作出的配置，比如你新建的job去哪里了，在windows中，如果没有设置环境变量jenkins home，那么这些数据的改动是在当前登录的users/{username}/.jenkins目录下。比如在我的本机上是在目录：C:\Users\swang6\.jenkins

由于.jenkins目录是隐藏目录，如果需要将该目录改为其它目录，可以用以下步骤更换成其他目录。

A、先备份当前jenkins的根目录，以便更换主目录失败以后可以恢复到以前的目录。

B、进入tomcat下的conf目录，创建一个jenkins.xml文件，将如下几行加入，其中jenkins.war文件就是我们放到webapps目录下的jenkins文件，要给出这个文件存放的绝对路径，value后面就是变更后jenkins的根目录的位置，比如，我的jenkins.xml配置如下：

<?xml version='1.0' encoding='cp936'?>
<Context docBase="D:/Program Files/java/Tomcat 6.0/webapps/jenkins.war">
  <Environment name="JENKINS_HOME" type="java.lang.String"
               value="D:/Program Files/java/JENKINS_HOME" override="true"/>
</Context> 

 

修改conf下的xml文件的时候，需要将tomcat关掉，修改好后，多次重启tomcat和jenkins，再进入jenkins之后，在系统设置中就可以看到jenkins根目录改变了，而且在环境变量里面增加了JENKINS_HOME这个变量。

C、在tomcat下webapps的jenkins目录

apache-tomcat-6.0.18/webapps/jenkins/WEB-INF

修改以上目录中的web.xml文件，修改<env-entry-value></env-entry-value>这一行，在<env-entry-value>之后添加现在的jenkins的根目录。

 <env-entry> 

    <env-entry-name>HUDSON_HOME</env-entry-name> 

    <env-entry-type>java.lang.String</env-entry-type> 

    <env-entry-value>D:/Program Files/java/JENKINS_HOME</env-entry-value>

  </env-entry> 

重启tomcat，打开jenkins，jenkins根目录修改完毕，进入jenkins系统配置页面， 可查看如下：

 

 

第二部分：具体步骤（以Linux/Ubantu为例）

1. 安装JDK

     参照我的另一篇博客：http://josh-persistence.iteye.com/admin/blogs/1908549

2. 安装Maven3

     2.1： 下载maven3， 从http://maven.apache.org/download.cgi 上下载apache-maven-3.1.1-bin.tar.gz

     2.2:    解压：apache-maven-3.1.1-bin.tar.gz

      运行命令： tar -zxvf apache-maven-3.1.1-bin.tar.gz然后会在当前目录生成apache-maven-3.1.1，然后移动到/usr并改名为maven3.1: mv apache-maven-3.1.1 /usr/maven3.1

      2.3:     然后修改环境变量：

      vi /etc/profile

      添加下面的内容：

      M2_HOME=/usr/maven3.1

      PATH=$PATH:$M2_HOME/bin

      export M2_HOME PATH  

      2.4：  保存并退出Vi编辑器

     2.5：  使环境变量生效：

      source /etc/profile 或注销重新登录

      2.6:     检验mvn是否安装成功

      mvn -v     

3、安装Jenkins

      3.1: 下载Jenkins: 你可以根据操作系统的类型在http://jenkins-ci.org/ 上下载相应操作系统类型的Jenkins，并且有相关的文档介绍怎样安装Jenkins。如适用于Ubantu/Debian类型的Jenkins可以在此下载：http://pkg.jenkins-ci.org/debian/， 上面也有介绍安 装的方法。

      但我们想要的是每种操作系统都可以用的简单方法，那么可以直接在 http://jenkins-ci.org/之上下在最新的war包。     （Java Web Archive (.war)）

     3.2：启动jenkins.war

       sudo java -jar jenkins.war --httpPort=8888 --ajp13Port=9999

      此时可能会发现如下类似的错误：

The program 'java' can be found in the following packages:

 * gcj-4.4-jre-headless

 * gcj-4.5-jre-headless

 * openjdk-6-jre-headless

其原因是没有正确的设置好JAVA_HOME.

      最需要注意的是上面的命令中是两个-，--httpPort和--ajp13Port,如果不是两个-，则要么报错，要么不起作用。

     但是很多时候我们是使用SSH方式到目标机器上的，当我们关闭SSH连接时，这个命令也会被中断，jenkins服务会被终止，我们不可能一直保持这SSH连接，怎么办？

     可以把这行命令写成 shell 脚本，然后使用 nohup sh jenkins.sh & 命令启动这个脚本，这样jenkins就能正常提供服务了。

4. 安装Git

    4.1 通过第三步启动jenkins后，可通过http://localhost:8888访问到jenkins的Dashboard，点击managed jenkins -> configure System。你会发现没有Git相关的选项，此时可以通过如下步骤在Jenkins中添加Git选项。

     4.2 在Jenkins的Dashboard中点击

    Manage Jenkins->Manage Plugins->Available中选择Git Plugin安装，

    注意有的版本要填写user name和 email地址，否则日后会碰到git tag的错误

      4.3 这样重启Jenkins后，你会发现managed jenkins -> configure System选项中有Git选项。

      4.4 从http://linux.softpedia.com/get/Communications/Email/GIT-4947.shtml 上下载Git,如下载：

      git-1.8.5.3.tar.gz

      4.5：cd git-1.8.5.3

      执行命令：./configure prefix=/usr/git --with-curl --with-expat   

      此时可能会遇到如下的错误：bash: ./cofigure.ac: No such file or directory

可以直接在控制台中使用命令make configure 来解决该问题，然后重新执行：

./configure prefix=/usr/git --with-curl --with-expat   

      然后再重新执行命令： make & make install

     4.6：检验是否安装成功: 使用命令git -version.如果有问题，则参照上诉安装maven的做法去配置git的环境变量。

     安装好Git，Maven并安装和启动Jenkins后，就可以在Jenkins的Dashboard中配置相关的信息，也可以新建一个Job了。

 注意事项：

1. 配置Git installations时一定要注意如下两点：

1） 设置Git的环境变量

2） Git的执行路径中的Path的值要到git.ext. 如：C:\Program Files (x86)\Git\bin\git.exe

2. JDK和Maven的Installations的配置中配置的是JAVA_HOME和MAVEN_HOME,不需要到bin目录。