Jenkins实例自由风格项目

一.General
二.源码管理
三..构建触发器
四.构建环境
五.构建
六.构建后操作

一.General

General是构建任务的一些基本配置。名称，描述之类的。

项目名称:是刚才创建构建任务步骤设置的，当然在这里也可以更改。

描述:对构建任务的描述。

丢弃旧的构建：配置完成后，每次构建项目，都会在服务器保存一份历史记录，太多会导致磁盘占满，所以要合理配置一下'保持构建天数'和'保持构建的最大个数'。

我配置了最大保持 10 天之内的构建，如果超过 10 天的构建，则会在Job 执行前被清理掉。同时配置了最大保持构建数量为 20 个，意思就是如果 10 天内构建次数如果超过 20 次，则最多保留最近执行的 20 个构建。

二.源码管理

源码管理就是配置你代码的存放位置，点击构建项目后，jenkins会按照如下配置拉取代码，然后移动到代码所在目录下，方便操作。

Git: 支持主流的github 、gitlab、gogs等代码仓库。

Repository URL：仓库所在地址，一般是http://xxxx.git

Credentials：凭证，如果是github那种开放项目，就不需要添加凭证。如果需要账号密码才能查看项目，可以使用HTTP方式的用户名密码，也可以是RSA文件。但要通过后面的"ADD"按钮添加凭证。

Branches to build：构建的分支。*/master表示master分支，也可以设置为其他分支。

源码浏览器：你所使用的代码仓库管理工具，如github, gitlab，这里点击自动可以让jenkins自动识别。

三..构建触发器

构建触发器，顾名思义，就是构建任务的触发器。如果不配置这一段，则要手动发布项目。配置如下后，则根据配置自动发布，例如每天发布一次，或代码更新就发布一次。

Build periodically：周期性的构建。很好理解，就是每隔一段时间进行构建。如下图的设置，表示每隔30分钟进行一次构建。

触发远程构建(例如，使用脚本): 该选项会提供一个接口，可以用来在代码层面触发构建。这里不做介绍，后期可能会用到。

Build after other projects are built：当本job依赖的job被build时，执行本job

Build when a change is pushed to GitLab：当有更改push到gitlab代码仓库，即触发构建。后面会有一个触发构建的地址，一般被称为webhooks。需要将这个地址配置到gitlab中，webhooks如何配置后面介绍。这个是常用的构建触发器。

Poll SCM：该选项是配合上面这个选项使用的。当代码仓库发生改动，jenkins并不知道。需要配置这个选项，周期性的去检查代码仓库是否发生改动。

四.构建环境

构建环境就是构建之前的一些准备工作，如指定构建工具(在这里我使用ant)。

With Ant：选择这个工具，并指定ant版本和jdk版本。这两个工具的版本我都事先在服务器上安装，并且在jenkins全局工具中配置好了。

五.构建

Eexcute shell：执行shell命令，在构建之前，可能我们需要执行一些命令，比如压缩包的解压之类的。

Ant：Ant是一款java项目构建工具，当然也能用来构建php。

Ant Version：选择Ant版本。这个ant版本是安装在jenkins服务器上的版本，并且需要在jenkins"系统工具"中设置好。

Targets：要执行的操作，一行一个操作任务。以上图为例，build是构建，tar是打包。

Build File: 是Ant构建的配置文件，如果不指定，则是在项目路径下的workspace目录中的build.xml。build.xml文件具体怎么配置，后面再细讲。

properties: 设定一些变量，这些变量可以在build.xml 中被引用。

Send files or execute commands over SSH：发送文件到远程主机或执行命令(脚本)

Name: SSH Server的名称。SSH Server可以在jenkins-系统设置中配置。

source files: 需要发送给远程主机的源文件。

Remove prefix: 移除前面的路径。如果不设置这个参数，则远程主机会自动创建构建源 source files 包含的那个路径。

Remote directory: 远程主机目录。

Exec command：在远程主机上执行的命令，或者执行的脚本。

六.构建后操作

建后操作，就是对project构建完成后的一些后续操作，比如生成相应的代码测试报告。

Publish Clover PHP Coverage Report：发布代码覆盖率xml格式的文件报告。路径会在"build.xml"文件中定义

Publish HTML reports：发布代码覆盖率的HTML报告。

Report Crap: 发布crap报告。

E-mail Notification: 邮件通知，构建完成后发邮件到指定的邮箱。