CentOS安装Jenkins全流程指南

文章目录

- [🛠️ 安装前准备](#🛠️ 安装前准备)
- - [1. 检查系统版本](#1. 检查系统版本)
  - [2. 安装依赖工具](#2. 安装依赖工具)
- [🧰 安装 Jenkins](#🧰 安装 Jenkins)
- - [方法一：通过官方 YUM 仓库安装（推荐）](#方法一：通过官方 YUM 仓库安装（推荐）)
  - - [1. 添加 Jenkins 仓库](#1. 添加 Jenkins 仓库)
    - [2. 安装 Jenkins](#2. 安装 Jenkins)
  - [方法二：手动下载 RPM 包安装](#方法二：手动下载 RPM 包安装)
  - - [1. 下载 Jenkins RPM 包](#1. 下载 Jenkins RPM 包)
    - [2. 安装 RPM 包](#2. 安装 RPM 包)
- [⚙️ 配置 Jenkins](#⚙️ 配置 Jenkins)
- - [1. 修改 Jenkins 配置文件](#1. 修改 Jenkins 配置文件)
  - [2. 指定 JDK 路径](#2. 指定 JDK 路径)
- [▶️ 启动 Jenkins 服务](#▶️ 启动 Jenkins 服务)
- - [1. 启动并设置开机自启](#1. 启动并设置开机自启)
  - [2. 检查服务状态](#2. 检查服务状态)
- [🔐 配置防火墙和 SELinux](#🔐 配置防火墙和 SELinux)
- - [1. 开放 Jenkins 端口（8080）](#1. 开放 Jenkins 端口（8080）)
  - [2. 禁用 SELinux（临时解决方案）](#2. 禁用 SELinux（临时解决方案）)
- 以上方法无法修改端口
- [🌐 访问 Jenkins Web 界面](#🌐 访问 Jenkins Web 界面)
- - [1. 获取初始管理员密码](#1. 获取初始管理员密码)
  - [2. 浏览器访问](#2. 浏览器访问)
- [📦 常见问题及解决方法](#📦 常见问题及解决方法)
- - [问题 1：Jenkins 服务启动失败](#问题 1：Jenkins 服务启动失败)
  - [问题 2：无法访问 Jenkins Web 界面](#问题 2：无法访问 Jenkins Web 界面)
  - [问题 3：插件安装缓慢或失败](#问题 3：插件安装缓慢或失败)
- [🧹 卸载 Jenkins（可选）](#🧹 卸载 Jenkins（可选）)
- - [1. 停止服务](#1. 停止服务)
  - [2. 卸载 Jenkins](#2. 卸载 Jenkins)
  - [3. 清理残留文件](#3. 清理残留文件)
- [✅ 总结](#✅ 总结)

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

🛠️ 安装前准备

1. 检查系统版本

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

bash 复制代码

cat /etc/centos-release

2. 安装依赖工具

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

bash 复制代码

sudo yum install -y wget java-1.8.0-openjdk

验证 Java 安装：

bash 复制代码

java -version

🧰 安装 Jenkins

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

1. 添加 Jenkins 仓库

bash 复制代码

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

bash 复制代码

sudo yum install -y jenkins

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

1. 下载 Jenkins RPM 包

bash 复制代码

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

2. 安装 RPM 包

bash 复制代码

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

⚙️ 配置 Jenkins

1. 修改 Jenkins 配置文件

编辑 /etc/sysconfig/jenkins 文件：

bash 复制代码

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 文件：

bash 复制代码

sudo vi /etc/init.d/jenkins

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

bash 复制代码

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

▶️ 启动 Jenkins 服务

1. 启动并设置开机自启

bash 复制代码

sudo systemctl start jenkins
sudo systemctl enable jenkins

2. 检查服务状态

bash 复制代码

sudo systemctl status jenkins

预期输出：

复制代码

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

🔐 配置防火墙和 SELinux

1. 开放 Jenkins 端口（8080）

bash 复制代码

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

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

bash 复制代码

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. 获取初始管理员密码

bash 复制代码

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

示例输出：

复制代码

5d0a1f3c3b8e4b9a8d0e1f2a7c6d5e4f

2. 浏览器访问

打开浏览器，输入：

复制代码

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

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

📦 常见问题及解决方法

问题 1：Jenkins 服务启动失败

现象：

bash 复制代码

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

解决方法：

检查日志：
bash 复制代码
```
sudo journalctl -u jenkins.service
```
根据日志定位错误（如 JDK 路径错误、端口冲突等）。
修改 JDK 路径 ：

确保 /etc/init.d/jenkins 中的 JAVA_HOME 配置正确。
修改端口 ：

如果 8080 被占用，修改 /etc/sysconfig/jenkins 中的 JENKINS_PORT。

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

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

检查防火墙：
bash 复制代码
```
sudo firewall-cmd --list-all
```
确保 8080 端口已开放。
检查 SELinux：
bash 复制代码
```
sudo getenforce
```
如果为 Enforcing，临时禁用：
bash 复制代码
```
sudo setenforce 0
```

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

解决方法：

使用国内镜像 ：

修改 /etc/default/jenkins（或 /etc/sysconfig/jenkins）：
bash 复制代码
```
JENKINS_UC=https://mirrors.tuna.tsinghua.edu.cn/jenkins
```
重启 Jenkins：
bash 复制代码
```
sudo systemctl restart jenkins
```
手动安装插件：
- 下载插件 .hpi 文件：
  bash 复制代码
```
wget https://updates.jenkins-ci.org/latest/<plugin-name>.hpi
```
- 通过 Jenkins Web 界面上传插件。

🧹 卸载 Jenkins（可选）

1. 停止服务

bash 复制代码

sudo systemctl stop jenkins

2. 卸载 Jenkins

bash 复制代码

sudo yum remove -y jenkins

3. 清理残留文件

bash 复制代码

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 官方文档。