CentOS安装Jenkins全流程指南

以下是在 CentOS 系统 中安装 Jenkins 的详细步骤，涵盖 JDK 安装、Jenkins 配置、服务启动及常见问题解决方法。(注：我安装的是jenkins-2.516.2-1.1.noarch.rpm这个版本，需要JDK8以上的版本，我用的JDK21)

---

🛠️ 安装前准备

1. 检查系统版本

确保系统为 CentOS 7 或更高版本：

cat /etc/centos-release

2. 安装依赖工具

安装 wget 和 java（JDK 1.8 或以上）：

sudo yum install -y wget java-1.8.0-openjdk

验证 Java 安装：

java -version

---

🧰 安装 Jenkins

方法一：通过官方 YUM 仓库安装（推荐）

1. 添加 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

2. 安装 Jenkins

sudo yum install -y jenkins

---

方法二：手动下载 RPM 包安装

1. 下载 Jenkins RPM 包

wget https://get.jenkins.io/redhat-stable/jenkins-2.346.3-1.1.noarch.rpm

2. 安装 RPM 包

sudo rpm -ivh jenkins-2.346.3-1.1.noarch.rpm

---

⚙️ 配置 Jenkins

1. 修改 Jenkins 配置文件

编辑 /etc/sysconfig/jenkins 文件：

sudo vi /etc/sysconfig/jenkins

关键配置项：

• JENKINS_USER="root"：将 Jenkins 用户设置为 root（避免权限问题）。
• JENKINS_PORT="8080"：设置 Jenkins 服务端口（默认 8080）。
• JENKINS_HOME="/var/lib/jenkins"：Jenkins 数据存储目录（可保留默认）。

2. 指定 JDK 路径

编辑 /etc/init.d/jenkins 文件：

sudo vi /etc/init.d/jenkins

修改 JAVA_HOME 路径（根据实际 JDK 安装路径调整）：

JAVA_HOME="/usr/lib/jvm/java-1.8.0-openjdk"

---

▶️ 启动 Jenkins 服务

1. 启动并设置开机自启

sudo systemctl start jenkins
sudo systemctl enable jenkins

2. 检查服务状态

sudo systemctl status jenkins

预期输出：

● jenkins.service - Jenkins Continuous Integration ServerLoaded: loaded (/usr/lib/systemd/system/jenkins.service; enabled; vendor preset: disabled)Active: active (running) since ...

---

🔐 配置防火墙和 SELinux

1. 开放 Jenkins 端口（8080）

sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

2. 禁用 SELinux（临时解决方案）

sudo setenforce 0

永久禁用：编辑 /etc/selinux/config，设置 SELINUX=disabled。

---

以上方法无法修改端口

修改jenkins.service文件

如果上述方法仍然无效，可以尝试修改jenkins.service文件。具体步骤如下：

进入/usr/lib/systemd/system目录：

cd /usr/lib/systemd/system

打开jenkins.service文件：

vi jenkins.service

在文件中找到Environment=“JENKINS_PORT=8080”，并将端口号修改为你想要的端口号，例如8889。

Environment="JENKINS_PORT=8889"

保存文件并退出编辑器。

重新加载配置文件并重启Jenkins服务：

systemctl daemon-reload
systemctl restart jenkins

---

🌐 访问 Jenkins Web 界面

1. 获取初始管理员密码

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

示例输出：

5d0a1f3c3b8e4b9a8d0e1f2a7c6d5e4f

2. 浏览器访问

打开浏览器，输入：

http://<服务器IP>:8080

• 输入初始密码，点击 继续。
• 选择 安装推荐的插件 或 选择插件。
• 创建管理员账号并完成初始化。

---

📦 常见问题及解决方法

问题 1：Jenkins 服务启动失败

现象：

sudo systemctl status jenkins
● jenkins.service - Jenkins Continuous Integration ServerLoaded: loaded (/usr/lib/systemd/system/jenkins.service; enabled; vendor preset: disabled)Active: failed (Result: exit-code)

解决方法：

1. 检查日志：

   sudo journalctl -u jenkins.service
   

   根据日志定位错误（如 JDK 路径错误、端口冲突等）。

2. 修改 JDK 路径：
   确保 /etc/init.d/jenkins 中的 JAVA_HOME 配置正确。

3. 修改端口：
   如果 8080 被占用，修改 /etc/sysconfig/jenkins 中的 JENKINS_PORT。

---

问题 2：无法访问 Jenkins Web 界面

现象：浏览器提示连接超时。
解决方法：

1. 检查防火墙：

   sudo firewall-cmd --list-all
   

   确保 8080 端口已开放。

2. 检查 SELinux：

   sudo getenforce
   

   如果为 Enforcing，临时禁用：

   sudo setenforce 0
   

---

问题 3：插件安装缓慢或失败

解决方法：

1. 使用国内镜像：
   修改 /etc/default/jenkins（或 /etc/sysconfig/jenkins）：

   JENKINS_UC=https://mirrors.tuna.tsinghua.edu.cn/jenkins
   

   重启 Jenkins：

   sudo systemctl restart jenkins
   

2. 手动安装插件：

   • 下载插件 .hpi 文件：

     wget https://updates.jenkins-ci.org/latest/<plugin-name>.hpi
     

   • 通过 Jenkins Web 界面上传插件。

---

🧹 卸载 Jenkins（可选）

1. 停止服务

sudo systemctl stop jenkins

2. 卸载 Jenkins

sudo yum remove -y jenkins

3. 清理残留文件

sudo rm -rf /var/lib/jenkins
sudo rm -rf /etc/jenkins

---

✅ 总结

步骤	命令	说明
安装 Jenkins	sudo yum install -y jenkins	通过 YUM 仓库安装
修改配置	sudo vi /etc/sysconfig/jenkins	设置用户、端口和 JDK 路径
启动服务	sudo systemctl start jenkins	启动 Jenkins 服务
获取初始密码	sudo cat /var/lib/jenkins/secrets/initialAdminPassword	用于首次登录
访问 Web 界面	http://<IP>:8080	完成初始化配置

---

通过以上步骤，您已成功在 CentOS 系统中安装并配置了 Jenkins。如果需要进一步优化（如配置私有仓库或代理），请参考 Jenkins 官方文档。