怎样调试centos的jenkins

下面从常见场景出发，系统说明在 CentOS 上调试 Jenkins 的方法，从“看日志 → 定位问题 → 常见故障 → 高级调试”逐步讲。

一、最基础：先看 Jenkins 日志（90% 问题在这里）

1. systemd 方式运行的 Jenkins（最常见）

# 查看服务状态
systemctl status jenkins

# 实时查看日志
journalctl -u jenkins -f

2. Jenkins 自身日志

tail -f /var/log/jenkins/jenkins.log

常见错误关键词：

Permission denied → 权限问题
Java not found → JDK 问题
port already in use → 端口冲突
Failed to connect to repository → Git / 网络问题

二、确认 Jenkins 是否正常运行

systemctl status jenkins

如果失败：

systemctl restart jenkins
journalctl -u jenkins -xe

检查端口：

ss -lntp | grep 8080

访问测试：

curl http://localhost:8080

三、Java 环境问题（CentOS 常见坑）

1. 查看 Java

java -version
which java

2. Jenkins 使用的 Java

cat /etc/sysconfig/jenkins | grep JENKINS_JAVA_CMD

如果 Java 路径不对：

vi /etc/sysconfig/jenkins

修改：

JENKINS_JAVA_CMD="/usr/java/jdk/bin/java"

四、权限问题调试（非常常见）

1. Jenkins 用户

ps -ef | grep jenkins

默认用户是 jenkins

2. 目录权限

ls -ld /var/lib/jenkins
ls -ld /var/log/jenkins

修复示例：

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

3. 执行 shell 脚本没权限

在 Jenkins 中：

使用 sudo 要配置免密
或直接用 jenkins 用户测试命令

五、插件 / 启动失败调试

1. 安全模式启动（禁用插件）

systemctl stop jenkins
java -jar /usr/lib/jenkins/jenkins.war --safe

2. 删除问题插件

cd /var/lib/jenkins/plugins
mv 插件名 插件名.bak
systemctl start jenkins

六、Pipeline / Job 调试技巧

1. 打开 Pipeline 日志

node {
    sh 'set -x'
}

2. 输出环境变量

sh 'env'

3. 手动在 Jenkins 机器执行

sudo -u jenkins bash
cd /var/lib/jenkins/workspace/你的任务

七、防火墙 & SELinux（CentOS 特有）

1. 防火墙

firewall-cmd --list-ports
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload

2. SELinux（常见坑）

临时关闭测试：

setenforce 0

如果好了，说明是 SELinux：

ausearch -m avc -ts recent

八、高级调试

1. 开启 Jenkins 调试日志

Manage Jenkins → System Log → Add Logger

Logger: hudson
Level: ALL

2. 远程调试（开发插件用）

JAVA_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=5005"

九、快速排查清单（建议保存）

✅ Jenkins 服务状态
✅ Java 版本
✅ 端口占用
✅ 日志文件
✅ 文件权限
✅ 防火墙 / SELinux
✅ 插件冲突

如果你愿意，可以告诉我：

Jenkins 版本
CentOS 版本
具体报错日志

我可以直接帮你精准定位问题。