如何在CentOS上快速部署Jenkins以实现高效的持续集成解决方案？

在 CentOS 环境中快速部署 Jenkins 并不是一件难事。但如果不注意常见陷阱，整个过程很容易变得繁琐且低效。

1️⃣ 准备工作：程序更新 & 安装 OpenJDK

# 更新程序软件包列表
sudo yum update -y
# 安装 OpenJDK 8
sudo yum install -y java-1.8.0-openjdk-devel
# 验证 Java 是否安装成功
java -version

痛点：

• 如果没有先安装 Java，后续启动 Jenkins 时会报 “Error loading configuration file /etc/sysconfig/jenkins” 等错误。怎么说呢，
• 某些 CentOS 镜像默认没有 JDK。直接运行 `yum install java` 会失败，需要手动指定版本。

2️⃣ 添加官方 Jenkins 仓库

# 创建仓库文件 /etc/yum.repos.d/jenkins.repo
sudo tee /etc/yum.repos.d/jenkins.repo 

• 若网络受限或镜像失效。可尝试更换国内镜像，例如清华大学、阿里云等。
• 忘记导入 GPG key 会导致 “GPG check failed” 的安全错误。说起来，

3️⃣ 安装 Jenkins

# 安装 jenkins 包
sudo yum install -y jenkins
# 检查安装是否成功
rpm -qi jenkins | grep Version | awk '{print $NF}'

4️⃣ 启动并设置开机自启

# 启动 jenkins 服务
sudo systemctl start jenkins
# 设置开机自启
sudo systemctl enable jenkins
# 查看服务状态确认已运行
systemctl status jenkins | grep Active:

• 启动失败常见原因包括端口冲突或 SELinux 强制模式下权限不足。老实说，
• `systemctl status` 可以快速定位错误日志；老实说，若出现 “Failed to start” 请查看 `/var/log/messages` 或 `/var/log/jenkins/jenkins.log`。

5️⃣ 配置防火墙开放 8080 端口

# 打开永久端口规则
sudo firewall-cmd --permanent --zone=public --add-port=8080/tcp
# 重载防火墙配置使之生效
sudo firewall-cmd --reload
# 验证端口已开放
firewall-cmd --list-all | grep ports |
sed 's/,//g'

说到痛点提示，

• If your environment uses iptables instead of firewalld。replace above commands accordingly.
• A missing port rule will cause browsers to hang on “connection refused”. Always double‑check with `curl http://localhost:8080`.

6️⃣ 第一次登录前先解锁 Jenkins 主密码

# 查看初始管理员密码文件方法：
cat /var/lib/jenkins/secrets/initialAdminPassword
# 将输出复制到浏览器的 Unlock 页面
# 粘贴后点击 Unlock 按钮完成解锁流程。话说回来，

• If password file is missing or unreadable due to permission errors。ensure `jenkins` user owns `/var/lib/jenkins`. Use `chown -R jenkins:jenkins /var/lib/jenkins` if necessary.
• A blank password field indicates server has already been unlocked;skip this step but remember to reset any forgotten credentials.

7️⃣ 自动化插件推荐安装

Spark 和 Pipeline 是最常用的两大插件，下面演示自动化批量安装：

# 在命令行下使用 pipline script 安装插件
cat <'EOF' | sudo tee /tmp/plugins.txt
git
pipeline-milestone-step
pipeline-stage-view
blueocean
EOF

while read plugin;do sudo java -jar /usr/share/java/jenkins-cli.jar -s http://localhost:8080 install-plugin "$plugin" done

sudo systemctl restart jenkins EOF "

痛点提示的观点是，

• 未正确设置 JA_HOME 或缺少 java 可执行文件会导致 CLI 工具报错。
• 插件下载失败时请检查网络代理或镜像源。

---

8️⃣ 基础 Job 配置示例 – 建立一个 Maven 项目

• Create → New Item → Freestyle project → Name it “MavenBuild”.
• Add Source Code Management → Git → Repository URL & Credentials.
• Add Build Triggers → Poll SCM .
• Add Build Steps → Invoke top-level Maven targets → Goals = clean install.
• Add Post-build Actions → Archive artifacts .
• SE 并点击 Build Now 测试建立成功与否。

Job 配置痛点：

• Maven 本地仓库被代理或缓存失效时建立会卡住建议使用 `` 指向持久化目录。
• `Git clone failed` 通常是凭据错误或仓库 URL 错误；话说回来，先在终端手工克隆验证无误后再配置到 Jenkins。

---

再看一下，

1. 先准备好 JDK 与必需工具；• 若未提前准备好会导致“Java not found”等致命错误。② 添加官方仓库并校验 GPG key；不过，• 错误配置会让后续所有依赖下载失效。③ 正确安装与开启服务，• 服务未开启即使服务器跑起来也无法访问 Web UI。④ 防火墙开放必要端口，• 不打开端口会让外部请求一直超时。⑤ 解锁并初始化管理员账号；• 跳过此步骤会导致第一次访问页面报错 “Please unlock”。⑥ 根据项目需求自动化插件与 Job 设置就可以 CI/CD 流程闭环。

遇到任何异常？话说回来，可以看日志文件： `/var/log/jenkins/jenkins.log` 或程序日志 `/var/log/messages` 来定位问题所在。祝你部署顺利、持续集成高效！