4.2 建立项目

4.2.1 新建项目

下面以建立一个自由风格软件项目为例进行说明

• 点击左侧边栏的“新建”按钮，新建一个任务。
• 填写项目的名称，并选择一种构建的方式，此时我们选择第一个，构建一个自由风格的软件项目，然后点击“OK”按钮创建任务，并进行详细的配置

然后就会进行到下面这个配置页面

接下来，我从General、源码管理、构建触发器、构建环境、构建、构建后操作这几个部分来进行详细配置说明

4.2.2 General

    这部分主要是设置下名称、工作空间等。

第一步，点击高级按钮;
第二步，勾选“自定义工作空间”，输入工作空间路径;

若是只有一个项目，也可以直接到“系统管理>系统配置>工作空间目录”直接修改默认工作空间目录，如下图：

 

 4.2.3 源码管理

　　因为，我们的代码是部署在SVN服务器上的，所以这里有下面三个步骤来配置jenkins监控SVN服务器代码变化。
第一步，选择Subversion；
第二步，在Repository URL输入项目SVN地址；

第三步，在Credentials选择SVN用户名和账号，初次会需要点击Add添加，如下。

4.2.4 构建触发器

指定的项目完成构建后，触发此项目的构建。

• Poll SCM：当选择此选项，您可以指定一个定时作业表达式来定义Jenkins每隔多久检查一下源代码 仓库的变化。如果发现变化，就执行一次构建。例如，表达式中填写H 2 * * *将使Jenkins每 隔2分                  钟就检查一次源码仓库的变化。
• Build periodically：此选项仅仅通知Jenkins按指定的频率对项目进行构建，而不管SCM是否有变化。 如果想在这个Job中运行一些测试用例的话，它就很有帮助。

4.2.5 构建环境

        略

4.2.6 构建

　    这部分主要是配置构建的相关内容，用于定时触发构建或者手动执行构建的时候，对代码检验、编译时进行的操作。构建概念到处可查到，形象来说，构建就是要把代码从某个地方拷贝过来，编译，再拷贝到某个地方去等等操作，当然不仅与此，但是主要用来干这个。

因为我的项目是用ant脚本实现的编译和打包，所以我选择的是Invoke Ant，Ant Version选择我Ant配置的那个名字（这里可以参见3.4.2），注意不要选择default喔，那个选择了没有用。

• 增加构建步骤:Invoke Ant
• Targets：(什么也没写，默认执行根目录下的build.xml)

如果你的构建脚本build.xml不在workspace根目录、或者说你的构建脚本不叫build.xml。那么需要在高级里设置Build File选项的路

4.2.7 构建后操作

　　用于定义当前项目构建完之后的一些操作，比如构建完之后将checkstyle结果输出到指定日志文件，重新发布项目，去执行其他项目构建等。

4

4.2.7.1 构建后发布项目

           注意，首先你必须安装好Deploy Plugin插件，然后在tomcat的conf目录配置tomcat-users.xml文件，如我这里配置的是manager, 在<tomcat-users>节点里添加如下内容:

配置完之后一次war包路径、用户名、密码、主机即可

      配置完之后一次war包路径、用户名、密码、主机即可

      参数说明：

• l WAR/EAR files：war文件的存放位置，如：**/build/warDest/ad-gx-admin.war。
• l Context path：访问时需要输入的内容，如ad-gx-admin访问时如下：     http://172.16.4.166:10001/ ofCard/ad-gx-admin如果为空，默认是war包的名字。
• l Container：选择你的web容器，如tomca 7.x
• l Manager user name：填入tomcat-users.xml配置的username内容
• l Manager password：填入tomcat-users.xml配置的password内容
• l Tomcat URL：填入http://192.168.x.x:8080/
• l Deploy on failure：构建失败依然部署，一般不选择

 　　注意：虽然这种部署方法可能会导致tomcat加载时出现卡死的现象。但是也是最简单的部署方式。如果卡死了重启下就好了，将tomcat的java内存参数调高可以解决这个问题。

最后不要忘记点击保存喔。

好了！到此一个项目的获取源码，打包，远程部署

4.2.7.2构建后发布静态结果

　　输入配置文件

checkstyle-result.xml配置文件请查看附件“checkstyle-result.xml说明”，里面有配置说明。

所有这些配置多做完之后，在最下方点击“保存”按钮，现在回到首页去进行构建吧！！！

4.3 监控

4.3.1 主页面介绍

1、左边菜单栏

• l 新建：这里进入新建项目。
• l 用户：用户管理模块，对监控系统用户的增删改查。
• l 任务历史：以往构建过的项目。
• l 系统管理：进去是一些配置方面的东西，进入之后几个主要的子菜单分别是系统设置 、Global Tool    Configuration 、管理插件 几个模块
• l My Views:当前监控的项目列表。
• l Credentials:添加监控源码的的证书，其实就是SVN用户名和密码验证。

2、监控项目列表

 这里主要是Jenkins当前正在监控的项目列表。点击进去可查看当前项目详细情况。

模块1：

• l 状态：最后一次构建的状态；
• l 修改记录：代码修改记录；
• l 工作空间：编译后代码存放的目录；
• l 立即构建：单击此处，可立即进行构建；
• l 删除Project:单击此处，可删除该项目；
• l 配置：配置该项目相关监控信息（工作空间、chestyle规则等）；
• l Checkstyle Warnings：当前这次构建发现的静态警告；
• l FindBugs Warnings：当前这次构建发现的FindBugs。

模块2：

• 这里显示的最近一次构建的相关信息，是否构建成功、构建用时等。

模块3：

• l Checkstyle Trend:历史构建完之后的解决的代码中静态警告走势；
• l FindBus Trend:历史构建完之后的解决的代码中FindBugs走势。

4.3.2 构建状态查询

 当任务一旦运行，您将会看到这个任务正在队列中的仪表板和当前工作主页上运行。这两种显示如下。

一旦构建完成后，完成后的任务将会构建历史列表显示。

当然你可以在Jenkins的主控制面板上看到它，如下图。

在上面展示的截图中，您将注意到有两个图标描述当前作业的状态。S栏目代表着“最新构建状态”，W栏目代表着“构建稳定性”。Jenkins使用这两个概念来介绍一个作业的总体状况：

1、构建状态:

        下图中分级符号概述了一个Job新近一次构建会产生的四种可能的状态： 

• Successful:完成构建，且被认为是稳定的。
• Unstable:完成构建，但被认为不稳定。
• Failed:构建失败。
• Disabled:构建已禁用。

2、构建稳定性:

        当一个Job中构建已完成并生成了一个未发布的目标构件，如果您准备评估此次构建的稳定性，Jenkins会基于一些后处理器任务为构建发布一个稳健指数 (从0-100 )，这些任务一般以插件的方式实现。它们可能包括单元测试(JUnit)、覆盖率(Cobertura )和静态代码分析(FindBugs)。分数越高，表明构建越稳定。下图中分级符号概述了稳定性的评分范围。任何构建作业的状态(总分100)低于80分就是不稳定的。

当前作业主页上还包含了一些有趣的条目。左侧栏的链接主要控制Job的配置、删除作业、构建作业。右边部分的链接指向最新的项目报告和构件。

通过点击构建历史（Build History）中某个具体的构建链接，就能跳转到Jenkins为这个构建实例而创建的构建主页上。如下图：

 如果你想通过视图输出界面来监控当前任务的进展情况。你可以单击Console Output（控制台输出）。如

 果工作已完成，这将显示构建脚本产生的静态输出；如果作业仍然在运行中，Jenkins将不断刷新网页的内容，以便您可以看到它运行时的输出。如下图：

五、常见错误处理

5.1 java.lang.UnsupportedClassVersionError

这是因为jenkins和jdk版本不对应引起的。我这里用的是jdk1.7，所以下载版本http://pkg.jenkins-ci.org/redhat/jenkins-2.33-1.1.noarch.rpm(jenkins下载地址：http://pkg.jenkins-ci.org/redhat/)，   原先现在2.5版本以上，版本太高，启动报“java.lang.UnsupportedClassVersionError”错，所以要卸载之前安装的jenkins-2.54-1.1.noarch,使用如下命令

5.2 command execution failed.Maybe you need to configure the job to choose one of your Ant installations?

“

控制台输出

Started by user admin

[EnvInject] - Loading node environment variables.

Building in workspace /home/jenkins/workspace/My_cache

Updating https://ip地址/svn/iptv/新业务/广西开机广告/code/ad-gx-cache at revision ‘2017-07-17T14:14:11.377 +0800‘

Using sole credentials hehaitao/****** in realm ‘<https://ip地址:443> VisualSVN Server’

At revision 68144

No changes for https://ip地址/svn/iptv/%E6%96%B0%E4%B8%9A%E5%8A%A1/%E5%B9%BF%E8%A5%BF%E5%BC%80%E6%9C%BA%E5%B9%BF%E5%91%8A/code/ad-gx-cache since the previous build

[workspace] $ ant -file checkstyleBuild.xml -DBUILD_NUMBER=8

ERROR: command execution failed.Maybe you need to configure the job to choose one of your Ant installations?

[CHECKSTYLE] Skipping publisher since build result is FAILURE

[FINDBUGS] Skipping publisher since build result is FAILURE

Warning: you have no plugins providing access control for builds, so falling back to legacy behavior of permitting any downstream builds to be triggered

Finished: FAILURE

”

　　这是由于没有成功全局配置ant的环境变量没有配置成功导致，请确保环境Ant环境变量配置成功，并且在Global Tool Configuration正确添加了Ant的路径，这个可以参见2.2及3.4.2

5.3 JAVA_HOME is not defined correctly.

“

控制台输出

Started by user admin

[EnvInject] - Loading node environment variables.

Building in workspace /home/jenkins/workspace/My_cache

Updating https://ip地址/svn/iptv/新业务/广西开机广告/code/ad-gx-cache at revision ‘2017-07-17T15:33:26.714 +0800‘

Using sole credentials hehaitao/****** in realm ‘<https://ip地址:443> VisualSVN Server’

At revision 68151

[workspace] $ /home/lutong/apache-ant-1.9.9/bin/ant -file checkstyleBuild.xml -DBUILD_NUMBER=11

Error: JAVA_HOME is not defined correctly.

  We cannot execute java

Build step ‘Invoke Ant‘ marked build as failure

[CHECKSTYLE] Skipping publisher since build result is FAILURE

[FINDBUGS] Skipping publisher since build result is FAILURE

Warning: you have no plugins providing access control for builds, so falling back to legacy behavior of permitting any downstream builds to be triggered

Finished: FAILURE

”

 这是由于没有成功全局配置JDK的环境变量没有配置成功导致，请确保环境Ant环境变量配置成功，并且在Global Tool Configuration添加的JDK路径正确，这个可以参见2.4.1及3.4.3

5.3 Unable to access the repository 

在配置“源码管理”时，如果Credentials 不选择或者选择了验证不正确，会出现这个错误，请参见3.4.4及4.2.3

5.4 can’t create file

“

Checking out https://ip地址/svn/iptv/%E6%96%B0%E4%B8%9A%E5%8A%A1/%E5%B9%BF%E8%A5%BF%E5%BC%80%E6%9C%BA%E5%B9%BF%E5%91%8A/code/ad-gx-cache at revision ‘2017-07-17T17:46:17.618 +0800‘

Using sole credentials hehaitao/****** in realm ‘<https://ip地址:443> VisualSVN Server’

ERROR: Failed to check out https://ip地址/svn/iptv/新业务/广西开机广告/code/ad-gx-cache

org.tmatesoft.svn.core.SVNException: svn: E204899: Cannot create new file ‘/home/jenkins/workspace/广西开机广告/.svn/lock‘: 权限不够

No changes for https://ip地址/svn/iptv/%E6%96%B0%E4%B8%9A%E5%8A%A1/%E5%B9%BF%E8%A5%BF%E5%BC%80%E6%9C%BA%E5%B9%BF%E5%91%8A/code/ad-gx-cache since the previous build

”

  这是由于 项目“广西开机广告”目录的权限不够，使用“chmod777 /home/jenkins/workspace/广西开机广告 ”即可

附件：

附件一：build.xml说明

<?xml version="1.0" encoding="utf-8" standalone="no"?>
<!-- 指明xml版本，编码格式为UTF-8 -->
<!-- basedir故名思意就是工作的根目录 .代表当前目录。default代表默认要做的事情。 -->
<project basedir="." default="war" name="ad-gx-admin">
    <!--
property类似定义程序中的变量，name是变量名，value是变量值，在下文中可以通过${src}和${webroot}取得变
量的值 -->
    <property name="src" value="src" />
    <property name="webroot" value="WebContent" />
    <property name="lib" value="${webroot}/WEB-INF/lib" />
    <property name="classes" value="build/classes" />
    <property name="warDest" value="build/warDest" />
    <property name="Bulid_Number" value="warDest" />
    <!-- target,即一个任务，它有一个名字，depends是它所依赖的target，
在执行这个targe，例如这里的init之前ant会先检查clean是否曾经被执行过，
如果执行过则直接直接执行init，如果没有则会先执行它依赖的target -->
    <target name="init" depends="clean">
        <!-- 创建编译后文件存放目录、war包存放目录 -->
        <mkdir dir="${classes}" />
        <mkdir dir="${warDest}" />
        <!-- 指定jar包的目录，下面直接通过${classpath}可以取得jar路径 -->
        <path id="classpath">
            <fileset dir="${lib}">
                <include name="**/*.jar" />
            </fileset>
        </path>
        <!-- 该任务主要用来对文件和目录的复制功能,即将./${src}和./${webroot}目录下
include指定的文件拷贝到./${classes}目录下。额外说明：exclude表示排除的文件 -->
        <copy todir="./${classes}">
            <fileset dir="./${src}">
                <include name="**/*.properties" />
                <include name="**/*.xml" />
                <include name="**/*.dtd" />
                <include name="**/*.json" />
                <include name="**/*.vm" />
            </fileset>
            <fileset dir="./${webroot}">
                <include name="resource/" />
            </fileset>
        </copy>
    </target>
    <target name="clean">
        <!-- 该任务的作用是根据日志或监控器的级别输出信息。它包括message、file、append和level四个属性 -
->
<echo >${warDest}</echo>
<!== 对文件或目录进行删除,这里是删除${warDest}和${classes}目录 -->
        <delete dir="${warDest}" />
        <delete dir="${classes}" />
    </target>
    <target name="complie" depends="init">
        <!-- 编译:将srcdir目录的源码，编译后放到destdir目录下,refid表示关联的jar包 -->
        <javac srcdir="${src}" destdir="${classes}" debug="true" debuglevel="lines,vars,source" encoding="UTF-8">
            <classpath refid="classpath" />
        </javac>
    </target>
    <target name="war" depends="complie">
        <war warfile="${warDest}/ad-gx-admin.war" webxml="${webroot}/WEB-INF/web.xml">
            <lib dir="${lib}" />
            <classes dir="${classes}" />
            <fileset dir="./${webroot}">
                <include name="**/**" />
                <exclude name="META-INF/**" />
                <exclude name="WEB-INF/classes/**" />
                <exclude name="WEB-INF/lib/**" />
            </fileset>
        </war>
    </target>
</project>

View Code

 附件二：checkstyle-result.xml说明

<?xml version="1.0" encoding="utf-8"?>
<project name="checkstyle" default="checkstyle" basedir=".">
    <!-- 检查源码的路径 -->
    <target name="init">
        <tstamp />
        <!-- 输出报告的路径  -->
        <property name="project.dir" value="/home/jenkins/workspace/广西开机广告项目/checkstyle_report" />
        <property name="project.checkstyle.report.dir" value="${project.dir}/${BUILD_NUMBER}" />
        <property name="project.checkstyle.result.name" value="checkstyle-result.xml" />
        <property name="project.checkstyle.report.name" value="checkstyle-report.html" />
        <!-- 检测规则存放路径  -->
        <property name="checkstyle.config" value="/home/jenkins/workspace/checkstyle.xml" />
        <property name="checkstyle.report.style" value="/var/lib/jenkins/plugins/checkstyle/WEB-INF/lib/checkstyle-frames.xsl" />
        <property name="checkstyle.result" value="${project.checkstyle.report.dir}/${project.checkstyle.result.name}" />
        <property name="checkstyle.report" value="${project.checkstyle.report.dir}/${project.checkstyle.report.name}" />
        <mkdir dir="${project.checkstyle.report.dir}" />
    </target>
    <taskdef resource="checkstyletask.properties" classpath="/var/lib/jenkins/plugins/checkstyle/WEB-INF/lib/checkstyle-6.5-all.jar" />
    <target name="checkstyle" depends="init" description="check java code and report.">
        <checkstyle config="${checkstyle.config}" failureProperty="checkstyle.failure" failOnViolation="false">
            <formatter type="xml" tofile="${checkstyle.result}" />
            <fileset dir="/home/jenkins/workspace/广西开机广告项目" includes="**/*.java" />
            <!-- 检查源代码的存放路径 -->
        </checkstyle>
        <!--<style in="${checkstyle.result}" out="${checkstyle.report}" style="${checkstyle.report.style}" />
         通过指定的xsl模版文件生成一份html的报告，这里生成的文件用于邮件发送时附加上，另外Jenkins插件也会生成可视化的结果  -->
    </target>
    <target name="xml2html" depends="checkstyle">
        <!-- 将生产结果根据扩展样式表文件checkstyle-frames.xsl生成html页面,输出到html -->
        <xslt in="${checkstyle.result}" out="${checkstyle.report}" style="${checkstyle.report.style}"></xslt>
    </target>
</project>

View Code