usky-dev-doc/技术分享/Jenkins存储目录变更及问题解决记录

一、修改Jenkins存储目录，并创建软连接到原目录
1.停止服务器上的Jenkins服务
[root@172 ~]# systemctl stop jenkins
2.保全期间原目录Jenkins存储目录（/var/lib/jenkins）保留，将数据复制到新存储目录（/home/jenkins）后，修改原目录Jenkins存储目录（/var/lib/jenkins）的名字
[root@172 ~]# cp -rf /var/lib/jenkins /home/jenkins    #确认复制完成
[root@172 ~]# mv /var/lib/jenkins /var/lib/jenkins.bak  #重命名原存储目录
3.创建软链接
[root@172 ~]# ln -s /home/jenkins /var/lib/jenkins
4.启动Jenkins
[root@172 ~]# systemctl start jenkins



二、启动jenkins报错问题记录

1、报错信息：Job for jenkins.service failed because the control process exited with error code. See "systemctl status jenkins.service" and "journalctl -xe" for details.
[root@172 ~]# systemctl start jenkins
Job for jenkins.service failed because the control process exited with error code. See "systemctl status jenkins.service" and "journalctl -xe" for details.
[root@172 ~]# systemctl status jenkins
● jenkins.service - Jenkins Continuous Integration Server
Loaded: loaded (/usr/lib/systemd/system/jenkins.service; disabled; vendor preset: disabled)
Active: failed (Result: start-limit) since Tue 2023-02-21 18:59:14 CST; 30s ago
Process: 9388 ExecStart=/usr/bin/jenkins (code=exited, status=1/FAILURE)
Main PID: 9388 (code=exited, status=1/FAILURE)
Feb 21 18:59:14 localhost.localdomain systemd[1]: Failed to start Jenkins Continuous Integration Server.
Feb 21 18:59:14 localhost.localdomain systemd[1]: Unit jenkins.service entered failed state.
Feb 21 18:59:14 localhost.localdomain systemd[1]: jenkins.service failed.
Feb 21 18:59:14 localhost.localdomain systemd[1]: jenkins.service holdoff time over, scheduling restart.
Feb 21 18:59:14 localhost.localdomain systemd[1]: Stopped Jenkins Continuous Integration Server.
Feb 21 18:59:14 localhost.localdomain systemd[1]: start request repeated too quickly for jenkins.service
Feb 21 18:59:14 localhost.localdomain systemd[1]: Failed to start Jenkins Continuous Integration Server.
Feb 21 18:59:14 localhost.localdomain systemd[1]: Unit jenkins.service entered failed state.
Feb 21 18:59:14 localhost.localdomain systemd[1]: jenkins.service failed.</code>

解决方法：
排查jenkins安装所需目录是否存在
[root@172 ~]# vim /etc/sysconfig/jenkins

/var/lib/jenkins
/var/log/jenkins
/var/cache/jenkins
若不存在，创建后重新执行yum install jenkins
并重新加载服务 systemctl daemon-reload
启动Jenkins  systemctl start jenkins

原因分析
可能出现Jenkins目录不全，或问题2权限不同问题需确认

2、报错信息：Jenkins throwing error: jenkins.model.InvalidBuildsDir: ${ITEM_ROOTDIR}/builds does not exist and probably cannot be created

解决方式：
统一修改jenkins相关目录权限（上个问题查看用户为jenkins）
[root@172 ~]# chown -R jenkins:jenkins /var/lib/jenkins
[root@172 ~]# chown -R jenkins:jenkins /var/log/jenkins
[root@172 ~]# chown -R jenkins:jenkins /var/cache/jenkins
[root@172 ~]# chown -R jenkins:jenkins /home/jenkins

原因分析
使用不通用户移动Jenkins相关目录造成的用户不同问题，统一用户后正常

3、报错信息：java.lang.IllegalStateException: An attempt to save the global configuration was made before it was loaded




解决方式：
1. 下载role-strategy.hpi（最新），下载地址：https://updates.jenkins.io/download/plugins/role-strategy/
2. 将role-strategy.hpi复制到jenkins安装目录的plugins目录下面
3. 重启jenkins的服务

原因分析
升级Jenkins版本后，/var/lib/jenkins/plugins/文件夹中的hpi文件异常，需下载下载hpi文件，并将其放到/var/lib/jenkins/plugins/文件夹.


4、报错信息：
[root@172 ~]# systemctl start jenkins
Job for jenkins.service failed because the control process exited with error code.
See "systemctl status jenkins.service" and "journalctl -xe" for details.
[root@172 ~]# systemctl status jenkins


解决方式：
如果通过 systemctl 不能解决Jenkins重启的问题，那就用Jenkins自带的启停来解决
[root@172 ~]#  cd /etc/init.d  # 一般在这里
[root@172 ~]#  ./jenkins stop   #停止jenkins服务
[root@172 ~]#  ./jenkins status   #检查jenkins状态
[root@172 ~]#  ./jenkins start    #启动jenkins


原因分析
Jenkins 如果使用 Systemd 来管理服务，通常会在 /etc/systemd/system/ 目录中找到 Jenkins 的 Systemd 单元文件 jenkins.service ，但是，我并没有在 /etc/systemd/system/ 下看到 jenkins.service ，说明 Jenkins 并没有使用 Systemd 来管理服务，所以 sudo systemctl restart jenkins命令就无法执行Jenkins 安装目录中的脚本 。

操作    命令
启动 Jenkins 服务    /etc/init.d/jenkins start
停止 Jenkins 服务    /etc/init.d/jenkins stop
重启 Jenkins 服务    /etc/init.d/jenkins restart
检查 Jenkins 服务的 状态    /etc/init.d/jenkins status
强制重新加载 Jenkins 服务配置    /etc/init.d/jenkins force-reload



三、修改Jenkins存储目录，指定新目录为存储目录
1.停止服务器上的Jenkins服务
[root@172 ~]# systemctl stop jenkins
2.保全期间原目录Jenkins存储目录（/var/lib/jenkins）保留，将数据复制到新存储目录（/home/jenkins）
[root@172 ~]# cp -rf /var/lib/jenkins /home/jenkins    #确认复制完成
3.修改Jenkins配置文件中指定存储目录参数
[root@172 ~]# vim /etc/sysconfig/jenkins
将JENKINS_HOME="/var/lib/jenkins"修改为将JENKINS_HOME="/home/jenkins"

4.修改全局环境变量配置使新存储目录生效
[root@172 ~]# vim /etc/profile
export JENKINS_HOME=/home/jenkins  #在末尾添加

[root@172 ~]# source /etc/profile   #重新加载全局变量生效
[root@172 ~]# systemctl start jenkins #启动jenkins，如出现问题参考二

四、Jenkins迁移至新服务器
1.在新服务器中安装jenkins并首次启动，可访问Jenkins后直接停止jenkins（不用登陆，主要为生成存储目录）
2.备份旧服务器存储目录中config.xml文件，jobs文件夹，users文件夹和plugins文件夹。
config.xml是存放配置信息的
jobs是存放创建的工程项目的
users是存放用户账信息的
plugins是存放插件的
3.将备份的config.xml文件，jobs文件夹，users文件夹和plugins文件夹放到新服务器Jenkins存储目录
4.再次启动新服务器Jenkins，使用与旧服务器相同用户登录