Linux 搭建 Jenkins

环境准备

安装JDK

安装 JDK 之前写过一篇文章，本文就不具体讲了：

Linux 安装 JDK

注意：Java版本不能是gcj，会导致Jenkins有问题，centos7搭建jenkins小记文章中提到的java版本问题导致CentOS下的Jenkins有问题。

安装Git

yum install git

规避磁盘过满问题

1.方法1：创建软连接，准备较大空间

/data挂在了较大空间，然后在其中创建相关目录：

mkdir -p /data/jenkins

ln -s /data/jenkins/ /var/lib/jenkins

chown -R root:root /data/jenkins

2.方法2：丢弃构建

设置构建最大保留天数或者保留个数，实现自动删除构建结果。

参考：

Jenkins服务器磁盘空间管理策略

CentOS

离线安装-推荐

## http://pkg.jenkins-ci.org/redhat-stable/

wget http://pkg.jenkins-ci.org/redhat/jenkins-2.39-1.1.noarch.rpm ## 下载(也可以Windows下载再转过来)

sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key ## 导入公钥，发现离线安装，不需要导入公钥就能安装

rpm -ih jenkins-2.7.2-1.1.noarch.rpm

自动安装完成之后：

/usr/lib/jenkins/jenkins.war WAR包
/etc/sysconfig/jenkins 配置文件
/var/lib/jenkins/ 默认的JENKINS_HOME目录
/var/log/jenkins/jenkins.log Jenkins日志文件

在线安装

# 添加Jenkins源

sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo

sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

yum repolist # Update your package manager list to get the latest packages

# 安装

yum install java-1.8.0-openjdk jenkins

service jenkins start # 启动

基于Tomcat安装

在Tomcat官网下载tar包
将tar包拷贝至/usr/local目录并解压：cd /usr/local/ && tar zxvf apache-tomcat-9.0.12.tar.gz
访问jenkins官网下载长期维护版本的jenkins.war拷贝至/usr/local/apache-tomcat-9.0.12/webapps，启动tomcat：`cd /usr/local/apache-tomcat-9.0.12
访问：http://IP:8080/jenkins

管理员密码访问：

cat /root/.jenkins/secrets/initialAdminPassword

基于这种方式安装的Jenkins位置处于/root/.jenkins，因此，为了避免Job占用空间过大，需要执行如下命令创建软连接：

ln -s /data/jenkins_jobs/ /root/.jenkins/jobs

Jenkins设置

为了不因为权限出现各种问题，这里直接使用root

## sudo vim /etc/sysconfig/jenkins

JENKINS_USER="root" ## 原值 "jenkins" 必须修改，否则权限不足

JENKINS_PORT="8080" ## 原值 "8080" 可以不修改

修改目录权限

chown -R root:root /var/lib/jenkins

chown -R root:root /var/cache/jenkins

chown -R root:root /var/log/jenkins

Jenkins 启动

启动Jenkins:

sudo systemctl enable jenkins # 开机自启动Jenkins

sudo systemctl start jenkins # 启动Jenkins

查看服务细节：

systemctl status jenkins.service

验证Jenkins Server访问链接：

telnet IP 8080

如果访问有问题，需要把防火墙关了：

systemctl stop firewalld

systemctl disable firewalld.service #重启不自动开启

通过如下两个命令查看防火墙是否关闭：

systemctl list-unit-files|grep firewalld.service

iptables -t nat -S

Centos安装参考：

Ubuntu

下载https://pkg.jenkins.io/debian/jenkins.io.key
apt-key add jenkins.io.key

以上两步，可以合二为一：

wget -q -O - https://pkg.jenkins.io/debian/jenkins-ci.org.key | sudo apt-key add -

sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
apt-get update
apt-get install jenkins
/etc/init.d/jenkins start。或者service start jenkins。启动Jenkins。
通过：http://{ip}:8080 访问jenkins。

cat /var/lib/jenkins/secrets/initialAdminPassword得到默认密码填入下面的密码框中

安装好之后，可以修改相关配置改变默认端口：

/etc/default/jenkins

Ubuntu安装参考：

Jenkins master优化

增加同时打开文件句柄数

增加同时打开文件句柄数，linux默认一个进程能同时打开的文件句柄是1024个，在jenkins master肯定是不够的，需要调整成65535

CentOS系统，修改/etc/security/limits.conf，在文件最后增加一行:

root             -       nofile          65535

重启后生效，可以通过命令ulimit -a查看

设置tomcat 日志循环，限制日志的大小

https://stackoverflow.com/questions/8342336/how-to-set-maximum-number-of-rolls-and-maximum-log-size-for-tomcat

Jenkisn配置

Jenkins用户

admin账号初始密码：

cat /var/lib/jenkins/secrets/initialAdminPassword

Jenkins使用 -- 用户设置

Jenkins使用

Jenkins关闭、重启、重载

http://localhost:8080/[exit/restart/reload]

参考：

Jenkins Job指定执行节点

关联job，进入job的配置页面，勾选Restrict where this project can be run

利用了标签的功能

参考：

Jenkins使用教程之管理节点

Jenkins升级

可以通过系统管理(System management)--> 系统信息(System Info)查找.war的文件

executable-war	/usr/lib/jenkins/jenkins.war

先列出官网地址：https://jenkins.io/download/

升级之前，停止Jenkins服务（记得备份原来的jenkins.war，以防万一）

http://jenkinsIP:port/exit

从官网下载最新的war包，然后替换掉上面路径下的war。

替换完成后，重启：

systecmctl start jenkins # centos

service jenkins start # ubunutu

参考：

Jenkins技巧：如何更新Jenkins到最新版本

Jenkins插件

dashboard view：Dashboard-view自定义jenkins任务集视图
Workspace Cleanup：这个插件可以再每次build之前清空workspace
Monitoring：监控一些机器的状态信息了
Folders：新建任务时，支持创建文件夹，可嵌套地定义文件夹来级别 views / jobs
SSH Slaves：添加节点时，可以采用SSH方式链接；
PostBuildScript：根据 Build 状态执行脚本
Post Build Task
Pipeline：必须【请勾选】
Build Pipeline：用于创建pipline视图
Configuration Slicing：主要功能是可以批量设置job的属性，比如设置保留多少天的构建记录，神器之一，有效解决Jenkins磁盘过满的问题
Multijob：配置Multijob必备的插件；
Timestamper
Build Timeout plugin：构建超时插件
Custom Tools
Git：Git插件【请勾选】
Git Parameter
GitLab
Gitlab Hook
Gitlab Authentication
Parameterized Trigger plugin：插件可以让你在构建完成时触发新的Job构建，并以各种方式为新Job构建指定参数。
Node and Label parameter
Publish Over SSH
Groovy plugins：并发任务解决
Windows Slaves Plugin：连接Windows Slaves，默认安装了
Matrix Authorization Strategy Plugin：矩阵形式认证策略插件，默认安装了

插件使用参考：

Jenkins Slave

Slave机器上需要安装好git、配置好Java环境（尤其是一些类似JAVA_HOME的变量）。

通过SSH连接node--推荐

先安装SSH Slaves插件，这样在新增节点时，ssh配置将更加友好。
点击 Credentials，点击 Jenkins -> Global credentials -> Add Credentials，Username 和 Password 表示执行机的账号和密码。
新建节点，「启动方式」选择 Launch slave agents via SSH。Credentials 选择刚刚新建的钥匙，Host Key Verification Strategy 选择 Manually trusted Key Verification Stragegy。

最后Launch agent即可；

通过JNLP连接node

该方法比较麻烦，不详细介绍了。

注意：需要下载两个文件到agent机器上：

agent.jar
slave-agent.jnlp

参考：

Jenkins FAQ

Q1: 忽略Jenkins升级提醒

对于轻微强迫症的我来说，看着升级提醒，还不能叉掉，实在忍不了，Google之后，有解决方法：

Manage Jenkins => Configure System => Administrative monitors configuration

系统管理-》系统设置-》管理监控配置

去掉“Jenkins更新通知”

UnCheck "Jenkins Update Notification" and apply

How to disable displaying “New version of Jenkins (2.62) is available for download (changelog)”?

Q2: Cannot run program "java": error=2, No such file or directory

虽然登录到master机器或者执行机上，java都配置好了，但是仍然遇到了错误，后来看到一篇博客中提到的方法，在usr/bin下创建了一个Java的软连接，就解决了。

ln -s /usr/java/jdk1.8.0_171/bin/java /usr/bin

enkins cannot run program mvn error 2 - No such file or directory Posted by Echo Yuan on July 2

Q3: jenkins.JenkinsException: Error in request. Possibly authentication failed [500]: Internal Server Error

在JJB项目中，发生了上面的错误，定位问题了半天，发现可能是Jenkins本身出问题了，而不是项目出问题。以前运行OK的Jenkins怎么突然发生这个问题了呢？可能是如下原因造成：

var/lib/jenkins/jobs：目录下Job占据过多空间。在Jenkins中的节点管理里查看master机器的剩余磁盘空间`也可以观察到。

du -ah --max-depth=1

/etc/rc.local是啥？

参考：

【Jenkins学习】解决jenkins运行磁盘满的问题

Q4: starting jenkins bash /usr/bin/java permission denied

解决办法主要分了两步：

将原本位于/root/buildbox/javaxxx/下的目录移到了/usr/java/下，重新配置java环境；
在vim /etc/init.d/jenkins中的candidates字段补充上java路径/usr/java/jdk1.8.0_151/bin/java。

参考：

Q5: 执行Jenkins服务器界面运行一段时间后就会卡死，界面显示空白

原因：tomcat的日志（/home/apache-tomcat-8.0.30/logs）查看catalina.out日志，得知是java虚拟机内存空间溢出。

解决：到后台tomcat的bin目录下，修改 tomcat的启动脚本：startup.sh，在最上面添加 export JAVA_OPTS=“-XX:MaxPermSize=1024m -Xms1024m -Xmx3096m”

Q6: 构建完成后需要清除workspace

需要安装“Workspace Cleanup Plugin插件”，在构建任务配置时，可以在“增加构建后操作步骤”中选择Delete workspace when build is done

Q7: Linux环境变量问题，没有加载/etc/profile文件，获取不到需要的环境变量。

添加节点时，Prefix Start Slave Command 选择输入 source /etc/profile &&

加一个前置动作。注意&&之后要有空格！！！

Q8：Jenkins定时构建用法

Jenkins定时构建

Q9：Error 403 No valid crumb was included in the request

jenkins 出现“Error 403 No valid crumb was included in the request ”的解决方案 https://blog.csdn.net/wanglin_lin/article/details/73849146

Q10：Jenkins Master-Slave: Key exchange was not finished, connection is closed

挂载执行机时，报错，通过编辑 /etc/sshd_config 文件，注释 MACs 和 Kex 所在的行，解决了问题，记得注释之后，systemctl restart sshd。

Q11：清理过期的 Jobs

#clear jenkins jobs logs

@hourly find /var/lib/jenkins/jobs/ -mindepth 1 -maxdepth 1 -mtime +30 -type d -exec rm -rf {} \; -o -type f -exec rm -rf {} \;

参考：

Jenkins Master-Slave: Key exchange was not finished, connection is closed

说明

博客原文：CICD-Jenkins搭建笔记一