【Jenkins使用之二】Jenkins全局配置
环境
CentOS Linux release 7.6.1810
jdk1.8.0_65
apache-tomcat-8.5.45
Jenkins 2.235.5
apache-maven-3.6.3
git-2.9.5
gradle-6.6.1
在"系统管理" -> "全局工具配置" 中，设置你要使用到的构建工具、版本控制工具、JDK 版本、Jenkins工作目录、邮件通知服务等。全局工具配置下面默认只有Maven 配置、JDK、Maven安装，其他的工具配置需要先安装插件再来这里配置。
1、JDK
(1)Linux安装jdk
搭建Linux-java web运行环境之一：安装jdk+tomcat
(2)配置jenkins JDK环境变量
2、构建工具的配置
常见的构建工具有make、ant、maven、gradle，这里只演示maven、gradle，另外的配置也是类似操作。
(一)maven
(1)安装
安装很简单，请自行百度，我这里安装3.6.3版本
[root@node106 apache-maven-3.6.3]# mvn -v Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f) Maven home: /usr/local/apache-maven-3.6.3 Java version: 1.8.0_65, vendor: Oracle Corporation, runtime: /usr/local/jdk1.8.0_65/jre Default locale: en_US, platform encoding: UTF-8 OS name: "linux", version: "3.10.0-957.el7.x86_64", arch: "amd64", family: "unix"
(2)配置
(二)gradle
(1)Linux安装gradle
第一步：下载 [root@node106 ~]# wget https://services.gradle.org/distributions/gradle-6.6.1-all.zip 第二步：解压 [root@node106 ~]# unzip gradle-6.6.1-all.zip 第三步：配置环境变量 [root@node106 ~]# vim /etc/profile [root@node106 ~]# source /etc/profile 第四步：检验是否成功 [root@node106 ~]# gradle -version Welcome to Gradle 6.6.1! Here are the highlights of this release: - Experimental build configuration caching - Built-in conventions for handling credentials - Java compilation supports --release flag For more details see https://docs.gradle.org/6.6.1/release-notes.html ------------------------------------------------------------ Gradle 6.6.1 ------------------------------------------------------------ Build time: 2020-08-25 16:29:12 UTC Revision: f2d1fb54a951d8b11d25748e4711bec8d128d7e3 Kotlin: 1.3.72 Groovy: 2.5.12 Ant: Apache Ant(TM) version 1.10.8 compiled on May 10 2020 JVM: 1.8.0_65 (Oracle Corporation 25.65-b01) OS: Linux 3.10.0-957.el7.x86_64 amd64
(2)配置
(2.1)jenkins先安装gradle插件
(2.2)jenkins配置gradle
3、版本控制工具-svn和git
(一)git
(1)安装git
#安装依赖 [root@node106 local]# yum -y install gcc-c++ zlib-devel openssl-devel cpio expat-devel gettext-devel curl-devel perl-ExtUtils-CBuilder perl-ExtUtils-MakeMaker #下载tar包 [root@node106 local]# cd /usr/local/src && wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.9.5.tar.gz -- #编译构建 [root@node106 local]# tar -zxvf git-2.9.5.tar.gz -C /usr/local && cd /usr/local/git-2.9.5 [root@node106 git-2.9.5]# make prefix=/usr/local all [root@node106 git-2.9.5]# make prefix=/usr/local install #验证 [root@node106 git-2.9.5]# git --version git version 2.9.5
(2)配置git
(2.1)下载git插件
(2.2)配置git
注意：要配置到git命令 而不是安装目录
(二)svn
(1)安装svn
参考：DevOps之二：搭建SVN服务器（subversion）
(2)配置
(2.1)安装svn插件
(2.2)配置
在新建的构建项目里配置
4、更改Jenkins的工作目录
Jenkins默认的主目录是root/.jenkins,一般生产主机这个目录空间不大，但在以后需要安装很多插件，以及构建很多任务，每次都要备份应用程序包，慢慢就占满了磁盘，导致需要将Jenkins默认的主目录修改到其它目录。
4.1在Jenkins运行时是不能更改的. 请先将Jenkins停止运行，否则会使服务挂掉，所有配置均重新配置
4.2要先将原目录内容全部迁移到新目录下面，比如新目录是/data/.jenkins：
[root@node106 data]# mv /root/.jenkins /data
4.3修改
有三种方式修改：
(1)使用你Web容器的管理工具设置JENKINS_HOME环境参数.
打开tomcat的bin目录，编辑catalina.sh文件。
在# OS specific support. $var _must_ be set to either true or false.上面添加：
export JENKINS_HOME="/data/.jenkins"
在引号中填入你的路径。
(2)在启动Web容器之前设置全局环境变量JENKINS_HOME.
用root用户登录
编辑profile文件：vi /etc/profile
在最后加入：export JENKINS_HOME=/data/.jenkins
保存，退出后执行：source /etc/profile 让配置生效
(3)（不推荐）更改Jenkins.war（或者在展开的Web容器）内的web.xml配置文件）
<!-- if specified, this value is used as the Hudson home directory --> <env-entry> <env-entry-name>HUDSON_HOME</env-entry-name> <env-entry-type>java.lang.String</env-entry-type> <env-entry-value>/data/jenkins</env-entry-value> </env-entry> <!-- 在<env-entry-value>节点中填入路径，windows系统建议使用/分隔路径 -->
5、邮件通知
Jenkins是一个很受欢迎的CI持续集成工具，能够实现项目的自动构建、打包、测试、发布等。还可以在构建失败、构建不稳定等状态后发送邮件通知。
现介绍一下如何在Jenkins中配置实现邮件通知。在Jenkins中配置实现邮件通知，Jenkins提供了两种方式的配置：
一种是Jenkins内置默认的邮件通知，但是它本身有很多局限性，比如它的邮件通知无法提供详细的邮件内容、无法定义发送邮件的格式、无法定义灵活的邮件接收配置等等；另外一种是通过安装Email Extension Plugin插件，使用该插件来发送邮件通知。
不管哪种邮件通知都有全局配置和项目配置。其中全局配置是在Jenkins中系统管理的系统设置里面设置，项目配置在具体的项目中的配置中设置。
5.1Jenkins内置默认的邮件通知配置
（一）全局配置
(1)系统管理--》系统配置--》Jenkins Locaction填入系统管理员邮件地址
系统管理员邮件地址一定要配置，否则发不了邮件通知，因为邮件通知都是由系统管理员的邮箱发出来的。
(2)找到邮件通知项，填入SMTP服务器信息及用户名、密码等认证信息。
配好以后勾选“通过发送测试邮件测试配置”
（二）项目配置
邮件通知的全局设置配好以后就可以在具体的项目中应用发送邮件通知了。
在项目的设置中找到“增加构建后的操作步骤”，选择“E-mail Notifacation”通过E-mail通知。
在Recipients中填入邮件通知接收者中，如果有多个接收者用空格分隔，可以发送邮件通知给多个相关的接收人。
5.2 Email Extension Plugin插件配置邮件通知
(一)全局配置
安装插件
(2)系统管理-->系统设置”，找到Extend E-mail Notification进行全局配置
（二）项目配置
邮件全局属性和变量清单：
邮件通知配置相关的全局属性详解 1. Override Global Settings：如果不选，该插件将使用默认的E-mail Notification通知选项。反之，您可以通过指定不同于( 默认选项)的设置来进行覆盖。 2. Default Content Type：指定构建后发送邮件内容的类型，有Text和HTML两种. 3. Use List-ID Email Header：为所有的邮件设置一个List-ID的邮件信头 4. Add 'Precedence: bulk' Email Header：设置优先级 5. Default Recipients：自定义默认电子邮件收件人列表。如果没有被项目配置覆盖,该插件会使用这个列表。您可以在项目配置使用$ DEFAULT_RECIPIENTS参数包括此默认列表，以及添加新的地址在项目级别。添加抄送：cc:电子邮件地址例如,CC:someone@somewhere.com 6. Reply To List：回复列表, A comma separated list of e-mail addresses to use in the Reply-To header of the email. This value will be available as $DEFAULT_REPLYTO in the project configuration. 7. Emergency reroute：如果这个字段不为空，所有的电子邮件将被单独发送到该地址（或地址列表）。 8. Excluded Committers：防止邮件被邮件系统认为是垃圾邮件,邮件列表应该没有扩展的账户名(如:@domain.com),并且使用逗号分隔 9. Default Subject：自定义邮件通知的默认主题名称。该选项能在邮件的主题字段中替换一些参数，这样你就可以在构建中包含指定的输出信息。 10. Maximum Attachment Size：邮件最大附件大小。 11. Default Content：自定义邮件通知的默认内容主体。该选项能在邮件的内容中替换一些参数，这样你就可以在构建中包含指定的输出信息。 12. Default Pre-send Script：默认发送前执行的脚本（注：grooy脚本，这是我在某篇文章上看到的，不一定准确）。 13. Enable Debug Mode：启用插件的调试模式。这将增加额外的日志输出，构建日志以及Jenkins的日志。在调试时是有用的，但不能用于生产。 14. Enable Security：启用时，会禁用发送脚本的能力，直接进入Jenkins实例。如果用户试图访问Jenkins管理对象实例，将抛出一个安全异常。 15. Content Token Reference：邮件中可以使用的变量，所有的变量都是可选的。 全局邮件变量 email-ext插件允许使用变量来动态插入数据到邮件的主题和内容主体中。变量是一个以$(美元符号)开始，并以空格结束的字符串。当一个邮件触发时，主题和内容主体字段的所有变量都会通过真实的值动态地替换。同样，变量中的“值”能包含其它的变量，都将被替换成真实的内容。 比如，项目配置页的默认主题和内容分别对应的是全局配置页面的DEFAULT_SUBJECT和DEFAULT_CONTENT，因此它会自动地使用全局的配置。同理，触发器中的Subject和Content分别对应的是项目配置页面的DEFAULT_SUBJECT和DEFAULT_CONTENT，所以它也会自动地使用项目的配置。由于变量中的“值”能包含其它的变量，所以就能为变量快速地创建不同的切入点：全局级别(所有项目)，专属级别(单一项目)，触发器级别(构建结果)。 如果你要查看所有可用的变量，你可以点击配置页的Content Token Reference的问号获取详细的信息。 所有的变量都是可选的，每个变量可以如下表示，字符串类型使用name=“value”，而布尔型和数字型使用name=value。如果{和}标记里面没有变量，则不会被解析。示例：$TOKEN,${TOKEN},${TOKEN,count=100},${ENV,var=”PATH”} 提示：用英文逗号分隔变量的参数。 常用的属性如下： ${FILE,path="PATH"} 包括指定文件（路径）的含量相对于工作空间根目录。 path文件路径，注意：是工作区目录的相对路径。 ${BUILD_NUMBER} 显示当前构建的编号。 ${JOB_DESCRIPTION} 显示项目描述。 ${SVN_REVISION} 显示svn版本号。还支持Subversion插件出口的SVN_REVISION_n版本。 ${CAUSE} 显示谁、通过什么渠道触发这次构建。 ${CHANGES } -显示上一次构建之后的变化。 showPaths 如果为 true,显示提交修改后的地址。默认false。 showDependencies 如果为true，显示项目构建依赖。默认为false format 遍历提交信息，一个包含%X的字符串，其中%a表示作者，%d表示日期，%m表示消息，%p表示路径，%r表示版本。注意，并不是所有的版本系统都支持%d和%r。如果指定showPaths将被忽略。默认“[%a] %m\\n”。 pathFormat 一个包含“%p”的字符串，用来标示怎么打印路径。 ${BUILD_ID}显示当前构建生成的ID。 ${PROJECT_NAME} 显示项目的全名。 ${PROJECT_DISPLAY_NAME} 显示项目的显示名称。 ${SCRIPT} 从一个脚本生成自定义消息内容。自定义脚本应该放在"$JENKINS_HOME/email-templates"。当使用自定义脚本时会默认搜索$JENKINS_HOME/email-templatesdirectory目录。其他的目录将不会被搜索。 script 当其使用的时候，仅仅只有最后一个值会被脚本使用（不能同时使用script和template）。 template常规的simpletemplateengine格式模板。 ${JENKINS_URL} 显示Jenkins服务器的url地址（你可以再系统配置页更改）。 ${BUILD_LOG_MULTILINE_REGEX}按正则表达式匹配并显示构建日志。 regex java.util.regex.Pattern 生成正则表达式匹配的构建日志。无默认值，可为空。 maxMatches 匹配的最大数量。如果为0，将匹配所有。默认为0。 showTruncatedLines 如果为true，包含[...truncated ### lines...]行。默认为true。 substText 如果非空，就把这部分文字（而不是整行）插入该邮件。默认为空。 escapeHtml 如果为true，格式化HTML。默认为false。 matchedSegmentHtmlStyle 如果非空，输出HTML。匹配的行数将变为<b style=”your-style-value”> html escaped matched line </b>格式。默认为空。 ${BUILD_LOG} 显示最终构建日志。 maxLines 日志最多显示的行数，默认250行。 escapeHtml 如果为true，格式化HTML。默认false。 ${PROJECT_URL} 显示项目的URL地址。 ${BUILD_STATUS} -显示当前构建的状态(失败、成功等等) ${BUILD_URL} -显示当前构建的URL地址。 ${CHANGES_SINCE_LAST_SUCCESS} -显示上一次成功构建之后的变化。 reverse在顶部标示新近的构建。默认false。 format遍历构建信息，一个包含%X的字符串，其中%c为所有的改变，%n为构建编号。默认”Changes for Build #%n\n%c\n”。 showPaths,changesFormat,pathFormat分别定义如${CHANGES}的showPaths、format和pathFormat参数。 ${CHANGES_SINCE_LAST_UNSTABLE} -显示显示上一次不稳固或者成功的构建之后的变化。 reverse在顶部标示新近的构建。默认false format遍历构建信息，一个包含%X的字符串，其中%c为所有的改变，%n为构建编号。默认”Changes for Build #%n\n%c\n”。 showPaths,changesFormat,pathFormat分别定义如${CHANGES}的showPaths、format和pathFormat参数。 ${ENV} –显示一个环境变量。 var– 显示该环境变量的名称。如果为空，显示所有，默认为空。 ${FAILED_TESTS} -如果有失败的测试，显示这些失败的单元测试信息。 ${JENKINS_URL} -显示Jenkins服务器的地址。(你能在“系统配置”页改变它)。 ${HUDSON_URL} -不推荐，请使用$JENKINS_URL ${PROJECT_URL} -显示项目的URL。 ${SVN_REVISION} -显示SVN的版本号。 ${JELLY_SCRIPT} -从一个Jelly脚本模板中自定义消息内容。有两种模板可供配置：HTML和TEXT。你可以在$JENKINS_HOME/email-templates下自定义替换它。当使用自动义模板时，”template”参数的名称不包含“.jelly”。 template模板名称，默认”html”。 ${TEST_COUNTS} -显示测试的数量。 var– 默认“total”。 total -所有测试的数量。 fail -失败测试的数量。 skip -跳过测试的数量。
