CentOS 7 安装和配置 Jenkins Server

封面图 • 2025-09-18 • Linux

在 CentOS 7 上安装和配置 Jenkins Server 的步骤如下。Jenkins 是一个开源的持续集成工具，可以用于自动化构建、测试和部署项目。

---

## 📌 环境准备

- **操作系统**：CentOS 7（推荐使用最小化安装）
- **Java**：Jenkins 需要 Java 环境（建议使用 OpenJDK 8 或更高版本）

---

## ✅ 步骤 1：安装 Java 环境

Jenkins 需要 Java 运行时环境（JRE）或 JDK。

### 安装 OpenJDK 8：

```bash
sudo yum install -y java-1.8.0-openjdk
```

验证 Java 安装：

```bash
java -version
```

输出应类似：

```
openjdk version "1.8.0_292"
OpenJDK Runtime Environment (build 1.8.0_292-b10)
OpenJDK 64-Bit Server VM (build 25.292-b10, mixed mode)
```

---

## ✅ 步骤 2：添加 Jenkins 仓库

Jenkins 提供了自己的 YUM 仓库，方便通过 `yum` 安装。

```bash
sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key
sudo curl -fsSL https://pkg.jenkins.io/redhat/jenkins.repo -o /etc/yum.repos.d/jenkins.repo
```

---

## ✅ 步骤 3：安装 Jenkins

```bash
sudo yum install jenkins
```

> 注意：安装完成后，Jenkins 服务不会自动启动。你需要手动启动它。

---

## ✅ 步骤 4：启动并设置 Jenkins 开机自启

```bash
sudo systemctl start jenkins
sudo systemctl enable jenkins
```

检查状态：

```bash
sudo systemctl status jenkins
```

如果看到 `active (running)` 表示 Jenkins 已成功运行。

---

## ✅ 步骤 5：开放防火墙端口（默认 8080）

CentOS 7 使用的是 `firewalld` 防火墙，需要开放 8080 端口：

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

---

## ✅ 步骤 6：访问 Jenkins Web 界面

打开浏览器，访问：

```
http://<your-server-ip>:8080
```

首次访问会提示你输入初始管理员密码。

---

## ✅ 步骤 7：获取初始管理员密码

Jenkins 初始密码位于以下路径：

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

复制这个密码，粘贴到网页中完成初始化。

---

## ✅ 步骤 8：创建第一个管理员用户

按照页面提示创建一个管理员账户，然后进入 Jenkins 主界面。

---

## ✅ 步骤 9：安装推荐插件（可选）

Jenkins 会提示你选择“Install suggested plugins”，这会安装常用的插件如 Git、Pipeline、Docker 等。

如果你不想自动安装，可以选择“Customize”来选择插件。

---

## ✅ 步骤 10：配置 Jenkins（可选）

- 添加节点（Agent）：用于构建任务
- 配置 Git、Maven、Node.js 等工具
- 设置全局凭据（如 GitHub、GitLab 凭据）
- 创建第一个 Job（Pipeline 或 Freestyle Project）

---

## 🔧 常见问题解决

### 1. 如果无法访问 Jenkins 页面：
- 检查防火墙是否放行 8080 端口
- 检查 Jenkins 是否正在运行：`systemctl status jenkins`
- 检查 SELinux 是否阻止了 Jenkins：可以临时关闭 SELinux 测试：

```bash
sudo setenforce 0
```

或者修改 `/etc/selinux/config` 文件，将 `SELINUX=enforcing` 改为 `SELINUX=permissive`。

---

### 2. 如果安装失败：
- 检查系统更新：

```bash
sudo yum update -y
```

- 确保你的系统时间正确：

```bash
sudo timedatectl set-timezone Asia/Shanghai
sudo ntpdate pool.ntp.org
```

---

## 📦 可选：使用 Jenkins Pipeline 自动化构建

Jenkins 支持多种构建方式，包括：

- Freestyle Project（传统方式）
- Pipeline（基于脚本的构建流程）

你可以通过 Jenkins 的 Web 界面创建项目，并编写 `Jenkinsfile` 来定义构建流程。

---

## 📝 总结

| 步骤 | 内容 |
|------|------|
| 安装 Java | `yum install java-1.8.0-openjdk` |
| 添加 Jenkins 仓库 | `curl` 导入 repo |
| 安装 Jenkins | `yum install jenkins` |
| 启动 Jenkins | `systemctl start jenkins` |
| 配置防火墙 | 允许 8080 端口 |
| 访问 Web 界面 | `http://<IP>:8080` |

---

如果你需要进一步配置 Jenkins（例如集成 Git、Docker、Maven、Jenkins Pipeline 等），欢迎继续提问！