CentOs7.8安装Jenkins教程
前提:
CentOs7,安装jdk17,本文就不再介绍了,随便找个帖子就能安装,本文主要介绍疑Jenkins安装疑难杂症(非常详细),多说一句,能在windows装还是在windows吧,windows只需要下载一个war包,然后运行war包就行了,可以说是非常轻松。
1、下载安装包
随便找个路径,安装2.387.1版本,执行该链接会在目录下得到一个rpm的安装包
wget --no-check-certificate https://mirrors.tuna.tsinghua.edu.cn/jenkins/redhat-stable/jenkins-2.387.1-1.1.noarch.rpm
注意,本教程只针对这个版本,因为Jenkins从10月份已经不再支持centos7,包括2.4+版本都是很难在centos7上安装的,2.2版本的安装配置方式和2.3不同,担心小版本之间也有不同,所以本文只针对2.387.1版本
如果url404失效了,说明该网站调整了,可自行访问https://mirrors.tuna.tsinghua.edu.cn/jenkins,选择尽可能相近的版本
2、安装:
yum -y localinstall jenkins-2.387.1-1.1.noarch.rpm
3、检验是否安装成功:
rpm -ql jenkins
此条命令返回的是Jenkins的一些安装信息,其中jenkins.service就是它的配置文件(区别于老版本)
4、查询java路径
which java
复制打印的结果,后面用到
5、修改配置文件
vim /usr/lib/systemd/system/jenkins.service
配置java_home
找到其中的# Environment="JAVA_HOME开头的注释,放开注释,修改值为你的java路径(主要要在bin的上一级):
修改运行的默认端口号,默认是8080,很容易与别的起冲突,所以我这里修改为9301
修改java运行源
vim /etc/init.d/jenkins
粘贴上面which java返回的结果(一定要到bin/java,java是个文件不是文件夹)
6、创建jenkins用户
从jenkins.service配置文件中可以看出,里面指定了jenkins的执行用户,默认是jenkins,若改成root,可能会给生产环境或者jenkins运行带来问题,所以本文这里手动创建用户
创建用户命令,并指定系统重要文件不可随意修改
chattr -i /etc/group;chattr -i /etc/gshadow;chattr -i /etc/passwd;chattr -i /etc/shadow
groupadd jenkins
useradd -g jenkins jenkins
chattr +i /etc/group;chattr +i /etc/gshadow;chattr +i /etc/passwd;chattr +i /etc/shadow
7、给jenkins用户授权
chown -R jenkins:jenkins /var/lib/jenkins
chown -R jenkins:jenkins /var/cache/jenkins
chown -R jenkins:jenkins /var/log/jenkins
8、开放防火墙端口
firewall-cmd --zone=public --add-port=你之前配置的端口(本文的9301)/tcp --permanent
firewall-cmd --reload
如果是阿里云服务器,需要配置安全组9301->0.0.0.0/0
9、运行和其他jenkins相关命令
# 启动
systemctl start jenkins
# 停止
systemctl stop jenkins
# 查看状态
systemctl status jenkins
# 刷新配置(每次配置文件修改后都需要执行这个才能生效,否则运行时会报错)
systemctl daemon-reload
# 查询jenkins运行日志,执行后通过长按上下键查询完整上下文日志,可用于启动报错的排查
journalctl -xe
# 判断jenkins是否运行成功
netstat -tunlp |grep 输入配置的运行端口
运行后如下图所示就代表成功了
10、异常情况
异常情况有很多,我把我遇到的坑列出来,但还是得靠各位的查日志排错能力。
10.1 提示超时,查询status一直是start(启动中)
Job for jenkins.service failed because a timeout was exceeded.
若观察journalctl -xe发现有java.lang.RuntimeException: Fontconfig head is null, check your fonts or fonts configuration,可以尝试执行,之后再stop、start即可
yum install -y fontconfig
还有一种可能性是用户没有第7步那几个文件夹的权限
10.2 直接运行失败,status查询后提示:Failed to start jenkins Continuous Integration Server
原因1:
jenkins.service配置文件中,java_home没配对,再仔细阅读我上面写的
原因2:
Linux安装的jdk版本过低,我用的jdk17是没问题的
10.3 彻底卸载Jenkins
有些时候可能哪里错乱了,想重装一下,可以执行此命令彻底卸载
rpm -e jenkins
find / -iname jenkins | xargs -n 1000 rm -rf
卸载完可再执行第3步的命令,若提示未安装证明卸载完成
11、打开网页访问
浏览器访问你的IP和你配置的端口(本文是9301),看到如下画面证明你成功了一大步了,后面都是傻瓜式操作
http://xx.xxx.xxx.xxx:9301
12、配置密码
第一次进入会要求输入密码,而这个密码就在你服务器上
cat /var/lib/jenkins/secrets/initialAdminPassword
拷贝返回的结果至网页即可,如果输入完点继续没反应,不用惊慌,刷新页面重新点,或者换个火狐浏览器就行了
13、安装插件
下一步我选择安装推荐的插件
自动安装
14、配置用户名密码
创建你能记得住的用户名和密码
url就填访问路径
看到这个页面就代表你成功了!