以下是安装最新版本 Jenkins + 适配的 Java(OpenJDK 17,Jenkins 官方推荐) 的完整步骤,适配 CentOS 7/8/9 系统,包含「清理残留→安装依赖→配置仓库→验证」全流程,确保版本最新且兼容:
前置说明
Jenkins 最新版本(2025 年稳定版)强制要求 Java 17/11(优先 Java 17,LTS 长期支持);
以下步骤会彻底清理旧版 Java/Jenkins 残留,避免版本冲突;
所有操作以
root用户执行。
步骤 1:彻底清理旧版本(避免冲突)
# 1. 卸载旧版Java
yum remove -y java* openjdk* || true
# 2. 卸载旧版Jenkins
yum remove -y jenkins || true
rm -rf /var/lib/jenkins /etc/jenkins /usr/lib/jenkins || true
# 3. 清理YUM缓存
yum clean all && rm -rf /var/cache/yum
步骤 2:安装 Java 17(OpenJDK,Jenkins 官方适配)
场景 1:CentOS 7
CentOS 7 默认仓库无 Java 17,需添加 Adoptium 仓库:
# 1. 安装Adoptium仓库(Java 17)
yum install -y wget
wget -O /etc/yum.repos.d/adoptium.repo https://packages.adoptium.net/artifactory/rpm/centos/adoptium.repo
# 2. 安装Java 17 OpenJDK
yum install -y temurin-17-jdk
# 3. 验证Java版本(关键:输出17.x)
java -version
# 成功输出示例:
# openjdk version "17.0.10" 2024-01-16 LTS
# OpenJDK Runtime Environment Temurin-17.0.10+7 (build 17.0.10+7-LTS)
# OpenJDK 64-Bit Server VM Temurin-17.0.10+7 (build 17.0.10+7-LTS, mixed mode, sharing)
场景 2:CentOS 8/9
CentOS 8/9 默认仓库含 Java 17,直接安装:
# 1. 安装Java 17 OpenJDK
dnf install -y java-17-openjdk-devel
# 2. 验证Java版本
java -version
# 成功输出示例:
# openjdk version "17.0.9" 2023-10-17 LTS
# OpenJDK Runtime Environment (Red_Hat-17.0.9.0.9-1.el9_2) (build 17.0.9+9-LTS)
# OpenJDK 64-Bit Server VM (Red_Hat-17.0.9.0.9-1.el9_2) (build 17.0.9+9-LTS, mixed mode, sharing)
步骤 3:配置 Java 环境变量(全局生效)
# 1. 写入环境变量
cat >> /etc/profile << EOF
# Java 17 Environment
export JAVA_HOME=$(dirname $(dirname $(readlink -f $(which java))))
export PATH=\$PATH:\$JAVA_HOME/bin
EOF
# 2. 生效环境变量
source /etc/profile
# 3. 验证环境变量
echo $JAVA_HOME
# 成功输出示例:/usr/lib/jvm/temurin-17-jdk(CentOS7) /usr/lib/jvm/java-17-openjdk(CentOS8/9)
步骤 4:安装最新版本 Jenkins
4.1 添加 Jenkins 最新官方仓库
# 1. 安装仓库依赖
yum install -y wget curl
# 2. 添加Jenkins最新仓库(适配所有CentOS版本)
wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo
# 3. 导入最新GPG密钥(验证安装包完整性,关键!)
rpm --import https://pkg.jenkins.io/redhat/jenkins.io-2023.key
4.2 安装最新 Jenkins
# 1. 安装最新版Jenkins(自动拉取最新稳定版)
yum install -y jenkins
# 2. 验证Jenkins版本(确认是最新版)
jenkins --version
# 成功输出示例:2.451.1(2025年最新稳定版)
# 3. 验证jenkins用户自动创建
id jenkins
# 成功输出:uid=997(jenkins) gid=994(jenkins) groups=994(jenkins)
步骤 5:启动 Jenkins 并配置自启
# 1. 启动Jenkins服务
systemctl start jenkins
# 2. 设置开机自启
systemctl enable jenkins
# 3. 验证Jenkins状态(必须显示active (running))
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 Thu 2025-12-18 10:00:00 CST; 30s ago
# Main PID: 12345 (java)
# Tasks: 50
# Memory: 1.2G
# CGroup: /system.slice/jenkins.service
# └─12345 /usr/bin/java -Djava.awt.headless=true -jar /usr/lib/jenkins/jenkins.war --webroot=/var/cache/jenkins/war --httpPort=8080
步骤 6:Jenkins 初始化准备
6.1 开放 Jenkins 默认端口(8080,可选)
# 临时开放8080端口(立即生效)
firewall-cmd --add-port=8080/tcp --permanent
firewall-cmd --reload
# 验证端口开放
firewall-cmd --list-ports | grep 8080
6.2 获取 Jenkins 初始密码
# 查看初始密码(初始化Jenkins时需要)
cat /var/lib/jenkins/secrets/initialAdminPassword
# 输出示例:8a7b6c5d4e3f2g1h0i9j8k7l6m5n4b3v2c1x(一串随机字符)
步骤 7:Jenkins 网页端初始化(关键)
访问 Jenkins:
http://你的服务器IP:8080;输入步骤 6.2 获取的初始密码,点击「继续」;
选择「安装推荐的插件」(自动安装 TFS、SSH、Pipeline 等核心插件);
创建第一个管理员用户(用户名 / 密码自行设置);
配置 Jenkins URL(默认即可,或填写服务器 IP+8080);
点击「开始使用 Jenkins」,完成初始化。
关键验证清单
常见问题解决
问题 1:安装 Jenkins 时提示「依赖缺失」
# 强制解决依赖冲突
yum install -y jenkins --allowerasing
问题 2:Jenkins 启动失败(提示 Java 版本不兼容)
# 检查Jenkins配置的Java路径
cat /etc/sysconfig/jenkins | grep JENKINS_JAVA_CMD
# 若路径不是Java 17,手动修改:
sed -i 's|JENKINS_JAVA_CMD=.*|JENKINS_JAVA_CMD=/usr/bin/java|' /etc/sysconfig/jenkins
# 重启Jenkins
systemctl restart jenkins
问题 3:Jenkins 插件安装缓慢 / 失败
进入 Jenkins → 「系统管理」→「插件管理」→「高级」;
将「升级站点」改为国内镜像:
https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json;点击「提交」→「立即升级」,重新安装插件。
完成以上步骤后,你将拥有最新版本的 Jenkins + 适配的 Java 17,且环境无冲突,可继续推进「SSH 免密配置、TFS 凭据配置、Pipeline 脚本部署」等后续流程。