Jenkins 基础篇 - 基础设置

站点设置

刚搭建好 Jenkins 环境，你还需要做一些简单设置，让我们的 Jenkins 看起来是这么一回事，特别是你要用于生产环境的时候。首先就是域名配置，如果你为 Jenkins 服务分配了一个域名，通过 Nginx 反向代理的方式来访问 Jenkins 服务的话，当你访问 Jenkins 的【系统管理】界面时就会看到如下警告，提示反向代理设置有误，当前安装的下列组件已有警告发布：



我们需要去到【系统配置】里面做下设置，将 Jenkins URL 由之前默认的 IP 修改成域名：



还是在 Jenkins 的【系统管理】面板中，点击【配置显示哪些警告】，或者去到【全局安全配置】设置里面，找到【隐藏的安全警告】这个地方，在【安全警告...】里面将这些警告隐藏掉：

对于安全警告最好的做法是升级 Jenkins 版本，但是新版 Jenkins 界面管理差异较大，我们暂时就先将这些警告隐藏掉吧，玩透了 Jenkins 后面我们就可以使用新版的 Jenkins。

工具配置

我们利用 Jenkins 构建我们的项目时可能还需要一些其他工具，例如构建 Java 项目需要 JDK，Ant 管理的项目需要 Ant 工具，Maven 管理的项目需要 Maven 工具，Gradle 管理的项目需要 Gradle，nodeJs 项目需要 Node 和 Npm 等。我们要先将这些需要的工具下载离线安装包，解压到 Jenkins 可以访问的目录，特别强调下，不推荐采用系统全局安装我们需要的工具，否则某些项目需要不同的工具版本，那会搞得比较麻烦。采用离线安装包放在不同的目录，对于工具版本的切换非常方便。另外对于 Maven 或者 Gradle 项目，推荐使用 Maven Wrapper 或者 Gradle Wrapper，这样就可以让项目自己决定使用什么版本的工具。

Jenkins 默认运行环境是 OpenJDK，如果我们的项目构建需要用 OracleJDK，那我们就去 Oracle 官网下载具体的 JDK 版本。例如，我这里下载了一个 OracleJDK 1.8.0_241，把它放在了 /var/jenkins_home/software/jdk1.8.0_241 目录，还准备了一个 Maven，在 /var/jenkins_home/software/apache-maven-3.6.3 目录。

如果你不想自己去下载离线包安装，也不想在系统里面全局安装这些工具，还可以选择去到 Jenkins 的【系统管理】中的【全局工具配置】里面，这个界面可以设置需要的软件，目前支持配置安装 JDK、Git、Gradle、Ant、Maven 等工具。例如我这里配置了一个 JDK 的安装，点击【新增 JDK 】按钮，填写好 JDK 别名，选择好 JDK 版本，目前支持的 JDK 版本从 1.4 到 JDK 9 都有，我这里选最新的一个 JDK 8，使用 JDK 需要同意 Oracle 的许可协议，同意许可协议要求登录 Oracle 账号，目前在 Oracle 官网下载 JDK 也都是需要登录的，没有 Oracle 账号就去注册一个，有账号就直接登录，Jenkins 也集成了登录功能。

【全局工具配置】里面可以支持添加以下工具：



添加一个 JDK，选择 JDK 8：



登录 Oracle 账号，同意 JDK 的许可协议：

环境变量

通过【全局工具配置】添加的工具可以在 Jenkins 的任务里面直接使用，不用专门设置环境变量。如果是自己通过离线包解压的方式安装的工具，为了让 Jenkins 能够知道我们的工具在哪里，这就需要用到环境变量。还是在 Jenkins【系统配置】里面的【全局属性】下面，有个【环境变量】复选框，勾选上，增加环境变量键值对，例如我这里就设置了 JDK 和 Maven 的环境变量：



在进行 Maven 构建打包的时候就可以使用 $MAVEN_HOME/bin/mvn clean  package 进行 Maven 打包，也可以用 export 命令临时调整环境变量：

[jenkins@asus-centos ~]$ export MAVEN_HOME=/var/jenkins_home/software/apache-maven-3.6.3
[jenkins@asus-centos ~]$ $MAVEN_HOME/bin/mvn -version

注意事项

在 Jenkins 上用到的工具可以是 【全局工具配置】或者自己离线安装然后配置环境变量，但是这两种方式请二选一，如果你既设置了【全局工具配置】又自己添加了环境变量，可能会产生奇怪问题。

我们的 Maven 和 Gradle 的设置访问一些私有制品仓库时需要配置账号密码，当在 Jenkins 节点上执行打包时 Jenkins 会在配置该节点的系统账号下的 .m2 或者 .gradle 目录去寻找，所以也需要将 Jenkins 主节点的 Maven settings.xml 或者 Gradle init.gradle 配置文件弄一份到其他节点的用户目录下的 .m2 或者 .gradle 目录中。