【01】Jenkins：安装配置

写在前面的话

从我的工作经历来看，刚出来的时候的第一家公司我们上线采用的是脚本上线。就是那种开发合并完代码以后，在一个固定的时间点，我们上服务器执行更新脚本打包更新。这种方法有一个很大的问题，就是对于整个更新过程，我们并不直观，而且除非服务器之间免密登录互信，否则写脚本也很麻烦。当然那是早期的时候。后来接触的东西多了，在这些东西里面自然也就包含了 Jenkins，当然，Jenkins 不一定最好的，但可以这样说，是我遇到用的最多的。同类产品也有很多，感兴趣的可以去了解。

CI / CD

在我写这篇以前，我们其实已经从传统的 CI / CD 转为 DevOps 了。但我依然写这个，其目的是本文的基础目的其实还是谈 Jenkins 对于我们运维人员的使用意义。当然如果你是运维开发或者纯粹的开发人员。我相信你应该有更合适的方式。

CI（Continuous integration）持续集成，CD（Continuous delivery）持续交付，CD（Continuous Deployment）持续部署。

我们经常能够在网上见到这样一张图（CI 持续集成过程）：

简单的说明就是程序员将代码提交到软件仓库，自动触发 CI Server 进行 Build 检测，以此来发现代码中存在的问题。

我们可以通过这样的操作来达到代码质量管理的目的。

另外一张图（CD 持续交付 / 持续部署）：

其实这本该是两个过程，但是由于处理的都差不多，所以很多时候其实我们是把他当成一步来看待。

最后，关于 CD / CD 的好处我们就没有必要在做过多介绍，我们只需要知道，能够让我们花更少的精力更容易的达成我们的需求。

Jenkins 就是这样的一个可扩展的持续集成引擎，前身为 Hudson，有些 Java 程序员应该听过这个。

安装 Jenkins

在 Jenkins 的安装上，目前是支持多种方法的，包括当前比较流行的 docker 允许。因为我自己维护的一般是 Java 服务，所以为了更多的个性化配置，一般都选择使用 Tomcat，至于 Jar 运行的方式，看个人喜好。我这里主要谈 Tomcat 的方法。

https://jenkins.io/zh/download/

我们可以去 Jenkins 官网去下载长期稳定版的：Generic Java package (.war) 

http://mirrors.jenkins.io/war-stable/latest/jenkins.war

当然，你也可以直接去下载站下载并选择不同的版本：

http://mirrors.jenkins.io/war-stable/

我们这里准备了东西如下：

名称	版本
操作系统	CentOS 7.5
JDK	1.8
Tomcat	8.5
Maven	3.5

其他的我们后面用到的时候再说！这些是我们需要的基础。

为了规范化管理，我们把需要的程序都安装到 /data 目录下，最终解压出来的目录结构如图：

具体设计结构如下图：

为了方便使用，我们把 Maven 和 JDK 都做了软链接，这样配置目录的时候方便些。

另外我们新建了 jenkins 目录，用于存放有关 Jenkins 所有配置，其实 jenkins-8080 是 Tomcat，而 jenkins-data 则是最终的 Jenkins 工作目录。

按照上面的配置完成以后，开始我们的 Jenkins 设置！

1. 配置 Tomcat：/data/jenkins/jenkins-8080/bin/catalina.sh 的 110 行左右加入配置：

# JDK & JENKINS SETTING
export JAVA_HOME=/data/jdk8
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$JAVA_HOME/bin:$PATH
export JAVA_OPTS="$JAVA_OPTS -server -Xmn2000m -Xms4000m -Xmx4000m -XX:PermSize=128m -XX:+UseConcMarkSweepGC -XX:MaxPermSize=512m -Dhudson.DNSMultiCast.disabled=true -Dhudson.udp=-1"
export JENKINS_HOME=/data/jenkins/jenkins-data

该配置制定了 JDK 的路径，因为我们 JDK 是没有环境变量的。

另外就是简单的 Tomcat 优化，其中有个重要的配置是关于 DNS 的配置，我们这里关闭了该功能。开启该功能可能造成 Jenkins 哪天抽风，疯狂的写日志，后面我会单独的说说这个问题，遇到过两次，服务器磁盘直接写爆。

最后就是指定 Jenkins home 目录，该目录是 Jenkins 启动后存放配置以及我们打包拉去代码的目录，之所以把它独立出来，就是为了方便管理。默认的话会是加目录下的一个隐藏目录，不方便我们管理。

至于 Tocmat conf 配置优化我们这里就不做了，如果感兴趣自己可以去了解。这也是我们选择 Tomcat 的原因，可控性强。

特别说明：Jenkins 其实是很消耗系统资源的服务，所有我们还是应该尽可能的多分配资源。

2. 删除 Tomcat 默认的包，将 Jenkins 的 war 包传上去解压启动：

# 删除原来的包
cd /data/jenkins/jenkins-8080/webapps
rm -rf *

# 上传后解压，完成后删除
unzip jenkins.war -d jenkins
rm -f jenkins.war 

# 启动
/data/jenkins/jenkins-8080/bin/startup.sh

结果如图：

3. 访问 Jenkins：这是我的地址

http://192.168.10.202:8080/jenkins

结果如图：

初次打开会有一个验证，相当于验证你是不是管理员本人的作用，我们需要去服务器上面查看该文件，然后将里面的内容粘贴到密码框。继续

4. 插件安装：

继续之后会进入插件安装界面，但是对于国内的网站，打开插件页面是随缘的，所有不仅加载慢，而且还可能出现离线的字样。

解决办法：

先 kill 掉 Jenkins 的 Tomcat 进程，然后修改 Jenkins 源的配置：/data/jenkins/jenkins-data/hudson.model.UpdateCenter.xml

将里面配置的 jenkins.io 的源地址更换成国内的，例如：清华源

http://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

然后重新启动 Tomcat，访问 Jenkins，此时会再度要求我们输入文件中的密码，输入后点击继续。

此时页面变成如下：

我们选择安装推荐插件即可，当然你可以选择自定义，推荐的好处就是很多还是很好用的。

到这一步，我们可以顺手将 /data/jenkins/jenkins-data/updates/default.json 中开头的：

{"connectionCheckUrl":"http://www.google.com/"

谷歌地址变更为 baidu 地址，避免在 Jenkins 中会报错很多 google 无法访问的错误，逼死强迫症。

之所以现在才做这一步，是因为之前该目录并没有生成。先不用急着重启，等我配置完成后再统一重启。

有些时候，我们使用类似清华源会因为某些不可描述的原因，在该页面中初选多个插件安装失败的情况。此时我们可以把源换回官方的：

http://updates.jenkins.io/update-center.json

不一样的是，我们把官方的 https 换成了 http，虽然慢一点，但是一般都没问题。

5. 创建管理员账户：

6. 配置访问地址，我们默认就行，你要是用域名可以配置成域名：

7. 安装完成：

点击开始使用 Jenkins 后如果界面一片空白，是因为没有登录的原因，我们可以访问如下地址重启 Jenkins，重启完成自动到登录页面：

http://192.168.10.202:8080/jenkins/restart

在地址就后面加个 restart。

8. 主界面：

至此，Jenkins 安装完成！但是由于版本问题，可能存在汉化不完全的情况。这一般是使用最新版的才会出现的情况。建议在最新版的基础上回退 1 到两个版本。

比如后来我更换成为了：Jenkins ver. 2.164.3

该版本没有出现汉化不完全的问题！

更换方法也很简单，由于我们是新安装，只需要删除 tomcat 下 webapps 下的 jenkins 包，删除掉 jenkins-data 下旧数据，换成新的包重新初始化即可。

小结

Jenkins 安装其实很简单，就是 war 包启动的过程，但是作为运维，我们把很多东西都给他定制化了，其最终的目的还是为了规范化管理。

规范化是我们使用 Jenkins 批量管理的前提，也是我们作为运维的最终目的。

整个安装过程中麻烦点在于 Jenkins 的很多东西都不在国内，所以容易出现各种请求不通的情况，文中我都在各种采用方法来规避这方面的问题。