一、Freestyle project

自由风格的项目

1.General

用来为项目设定一些全局性的选项。

Discard old build（丢弃旧的构建）

作用：用来设置 Jenkins 的 jobs 保留最近几次的构建结果，可以避免占用大量的磁盘空间。

丢弃旧的构建

参数：
策略：只有一个默认值选项 Log Rotation，无须修改;
保持构建的天数：设置保留最近几天的构建结果;
保持构建的最大个数：设置保留最近几次的构建结果;
高级：也可以进一步对制品的删除策略进行设置。（一般不用设置）

This project is parameterized（参数化构建）

作用：参数化构建，可以单击添加参数，在每次构建之前需要用户给参数赋值，根据不用的参数值执行不同的处理流程。

参数化构建

Throttle build（节流构建）

作用：允许在一个指定的时间段内进行构建的次数。

节流构建

参数：
Number of builds：构建的次数
Time period：设置指定的时间段，单位可以是年、月、日、周、时、分、秒

关闭构建

作用：勾选此复选框后，此项目不会再执行。

在必要的时候并发构建

作用：默认情况下，不允许同一个项目执行并发构建。
勾选此复选框后，并且有足够的执行节点的话，就会执行并行构建。这一功能对长时间的构建项目或者是多场景的项目会很有用。
注意：在并发构建时，工作空间名称会附加 @#（其中 # 是一个数字）用于区分工作空间。但是如果没有使用默认工作空间的话，则所有并发构建都是在同一工作空间运行。

关闭构建,在必要的时候并发构建

限制项目的运行节点

勾选此复选框后，允许你通过标签表达式来指定某一个或多个“标签”指定的节点来运行此项目。注意：标签是添加节点时设置的名称。
单击限制项目的运行节点选项下方的高级按钮，可以设置一些附件选项，具体如下：

Quiet period（静默期）

静默期

作用：设置在项目构建前等待的秒数。如果这里没有设置，则使用系统默认的全局安静期。
此项主要用于支持遗留问题，比如 CVS，需要等待所有文件提交完成后才能开始构建，而不是在系统看到第一个时就开始执行。

重试次数

作用：用于重试 SCM（ Source Control Management）的检出次数。两次尝试之间有 10s 的间隔。

当上游项目正在构建时阻止构建

作用：勾选此复选框后，如果此项目的某个依赖的上游项目正在构建或处于队列中时，则不允许构建该项目。

当下游项目正在构建时阻止构建

作用：勾选此复选框后，如果其中的一个子项目正在构建或处于队列中，时，则不允许构建该项目。

上下游项目正在构建时阻止构建

使用自定义工作空间

作用：Jenkins 默认的工作空间是在“C:\Users\xxx.Jenkins\workspace\项目名称”目录下，也可以在此处指定自定义的工作空间。
参数：
目录：指定工作空间的位置，可以是绝对路径也可以是相对路径，如果是相对路径，则相对的是节点的根目录。注意：千万不要直接写磁盘的根目录，否则执行构建时会将目录下所有的内容删除！
显示名称：在 Jenkins web 界面中显示的值。

使用自定义工作空间

保留依赖的构建日志

为了保留有上下游依赖的构建日志，此配置会覆盖日志循环策略。

2.源码管理

源码管理

根据安装的插件不同，界面中看到的配置项会有所差异，但是也都是大同小异，最常见的配置如下：
仓库 URL：设置项目中能够访问的仓库位置，比如源码的存放位置，或者测试脚本的存放位置等。
凭证：用于访问 SCM 的用户名密码、ssh 密钥、token 等凭证。
版本：配置要使用的代码的具体版本。
git 仓库的配置项。

3.构建触发器

构建触发器用来设置触发项目构建的时间或者事件。

触发远程构建

勾选此复选框之后，Jenkins 会提供一个特定的 URL 用来触发项目的自动构建，可以看下面的那行提示信息。为了安全起见，可以看到在 URL 之后还会要求有一个用于授权的 Token 字段（需要在 Manage Jenkins–>Manage Users 中对用户进行设置）。这样就可以使用 wget 或 curl 这样的工具触发构建。

Build after other projects are built（其它项目构建完成后构建）

其它项目构建完成后构建

用来设置在某个项目构建完成后才能触发本项目的构建。而且可以对其它项目的具体构建结果进行设定，比如，稳定的（成功），不稳定的，失败的。比如我们需要在 war 包发布成功后，再进行测试脚本的执行，这种场景下就可以配置此项。

Build periodically（周期性构建）

周期性构建

这是一种类似于 crontab 命令的功能，可以指定在某个或某些具体时间自动进行项目的执行。包含 5 个字段，这些字段以空格或者 Tab 键分割，用来指定多久去执行一次构建。格式为：
MINUTES：一小时内的分钟，取值范围（0-59）
HOURS：一天内的小时，取值范围（0-23）
DAYMONTH ：一个月中的某一天，取值范围（1-31）
MONTH ：月份，取值范围（1-12）
DAYWEEK：一周中的星期几，取值范围（0-7）。0 和 7 都表示星期日

还可以使用特殊的字符一次指定多个值：
*：匹配所有的值
N：匹配 M-N 之间的值
M-N/ 或者 */：表示每隔，比如 */5 每隔 5 分钟
A,B,…Z：多个枚举值
5H：可以用于任何字段，用来告诉 Jenkins 在一个范围内使用该项目名的散列值计算出一个唯一的偏移量，这个偏移量于范围内的最小值相加后定义为实际的执行时间。注意：这个值是项目名的散列值，那么每一个值都与其他项目是不同的，但是同一个项目的值是不变的。 H 符号在实际的项目中是非常推荐使用的，因为在大型的项目中可能存在多个同一时刻需要执行任务，比如（0 0 * * *），都需要在半夜零点启动，那么使用 H 后，从散列算法获得的偏移量，就可以错开执行具有相同 cron 时间的项目。

示例：

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


# 每十五分钟一次
H/15 * * * *

# 每半小时内的每十分钟一次
H(0-29)/10 * * * *

# 每两小时45分钟一次，工作日上午9:45开始，下午3:45结束
45 9-16/2 * * 1-5

# 在每个工作日上午9点到下午5点之间每两小时一次
H H(9-16)/2 * * 1-5

# 每月1日和15日每天一次，十二月除外
H H 1,15 1-11 *

Generic Webhook Trigger

一种通用的生成 webhook 的插件，不局限于 github。

Github hook trigger for GITScm polling

专门针对于 github 仓库的配置项，需要安装 Github Integration plugin 插件才能看到。
这种方式要求设置一个 github 服务，以便在 github 仓库中有指定的事件发生时，向 Jenkins 发送通知，而无需 Jenkins 不断的轮询。

GITScm轮询钩子触发器，轮询 SCM

Poll SCM(轮询 SCM)

就是定期到指定的代码仓库查询是否有变化，如果有变化就执行。语法同 cron 是一样的。
与周期性构建的区别就是，让 Jenkins 在指定的时间去检查代码仓库是否有变化，有变化了才运行项目，而不是直接到点了就运行项目。
注意：最下面一行有一个复选框，忽略 post-commit 钩子，就是告诉 Jenkins 要忽略来自钩子的信号，目的就是为了防止重复触发操作。

4.构建环境

可以用来对项目指定某些全局操作和集成设置。这些选项有很多，根据安装的插件不同，显示出来的也不同。

Delete workspace before build starts（构建前删除工作空间）

就是在构建前先将工作空间删除。

构建前删除工作空间

Use secret text(s) or file(s)（使用机密文本或文件）

使用机密文本或文件

安装了凭证绑定插件（Credentials Biding plugin）才会看到此配置项。创建凭证时会为其指定一个全局变量名，然后就可以在任务中使用此全局变量代替凭证中的敏感信息，在执行构建时，会将实际值对全局变量进行替换。

下图以用户名和密码为例：

使用机密文本或文件

Abort the build if it’s stuck（如果构建被卡住，则中止构建）

如果构建被卡住，则中止构建

用来配置超时的策略和指定值，以便在构建时间过长时停止构建，有 3 个可以配置的参数：

Time-out strategy：可以使用的策略有 5 种：
Absolute（绝对的）：根据固定的超时时间中止构建
Deadline（截止时间）：截止时间格式为 HH:MM:SS
Elastic（弹性）：定义终止构建前的等待时间，以最后 n 次成功构建的平均持续时间的百分比表示
Likely stuck（可能卡住）：当任务运行的时间比以前多很多倍时，终止构建
No Activity（没有活动）：自上次日志输出后，经过指定的秒数后触发超时

Time-out variable：定义一个自动填充超时的环境变量，以 ms 为单位，可以在任务中引用此变量。

Time-outactions：用来定义超时之后采取的行动，包括终止构建、构建失败以及将信息写入到正在运行任务的描述字段中。

示例：

如果构建被卡住，则中止构建