2、Jenkins环境搭建：在Linux（Ubuntu/CentOS）上安装Jenkins，配置JDK与Maven，初始设置与插件管理

好，咱们正式开始动手了。

这一章，我带你把 Jenkins 跑起来。说白了，就是在一台干净的 Linux 服务器上，把 Jenkins 装好、配好 JDK 和 Maven，再做点初始设置和插件管理。

嗯，这里要注意：环境搭得好，后面少踩坑。我在项目中见过太多因为环境不一致导致的诡异问题，所以咱们一步到位。

2.1 环境准备：Ubuntu vs CentOS

我个人习惯用 Ubuntu 20.04 或 CentOS 7/8。两个系统差别不大，但包管理器不同。你根据自己手头的机器选一个就行。

系统 包管理器 默认 JDK 版本 我推荐
Ubuntu 20.04+ apt OpenJDK 11 适合新手，社区活跃
CentOS 7/8 yum/dnf OpenJDK 8/11 生产环境常见，稳定
我的建议：如果你只是学习，用 Ubuntu 更省心。如果是公司生产环境，CentOS 7 依然很稳。

2.2 安装 JDK（必须第一步）

Jenkins 是 Java 写的，所以 JDK 是前提。我建议用 OpenJDK 11，兼容性最好。

Ubuntu 上安装：

sudo apt update
sudo apt install openjdk-11-jdk -y
java -version

CentOS 上安装：

sudo yum install java-11-openjdk-devel -y
java -version

输出应该类似这样：

openjdk version "11.0.18" 2023-01-17 LTS
OpenJDK Runtime Environment (build 11.0.18+10-post-Ubuntu-0ubuntu122.04)
OpenJDK 64-Bit Server VM (build 11.0.18+10-post-Ubuntu-0ubuntu122.04, mixed mode)
注意：我曾经遇到过 Jenkins 启动后报错 "No such file: java"，就是因为 JDK 没装对。一定要确认 java -version 能正常输出。

2.3 安装 Jenkins

Jenkins 官方提供了稳定的 apt/yum 源。我建议用 LTS 版本，别追新。

Ubuntu 安装步骤：

# 导入 Jenkins 官方 GPG 密钥
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee \
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

# 添加 Jenkins 源
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \
  /etc/apt/sources.list.d/jenkins.list > /dev/null

# 安装
sudo apt update
sudo apt install jenkins -y

CentOS 安装步骤：

# 添加 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-2023.key

# 安装
sudo yum install jenkins -y

安装完成后，启动 Jenkins：

sudo systemctl start jenkins
sudo systemctl enable jenkins
sudo systemctl status jenkins

看到 active (running) 就对了。

默认端口：Jenkins 默认监听 8080 端口。如果你服务器上已经有其他服务占用了 8080，可以修改 /etc/default/jenkins（Ubuntu）或 /etc/sysconfig/jenkins（CentOS）中的 HTTP_PORT 参数。

2.4 初始设置：解锁 Jenkins

打开浏览器，访问 http://你的服务器IP:8080。

你会看到一个页面，要求输入初始管理员密码。这个密码在服务器上：

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

复制出来，粘贴进去，点继续。

一个小技巧：我习惯用 SSH 登录服务器，直接 cat 这个文件。别用记事本打开再复制，容易多出空格或换行符。

2.5 插件管理：别贪多

解锁后，Jenkins 会问你要安装哪些插件。这里有两个选项：

  • 安装建议插件——适合新手，但会装一堆你可能用不上的东西
  • 选择插件来安装——我推荐这个

我个人习惯只装这几个核心插件：

插件名称 作用 必装？
Pipeline 流水线核心，没有它寸步难行 ✅ 必须
Git 拉取代码用 ✅ 必须
Maven Integration 集成 Maven 构建 ✅ 必须
Blue Ocean 可视化流水线界面，看着舒服 推荐
Credentials Binding 管理密码、Token 等敏感信息 推荐

安装完成后，创建一个管理员用户。记住账号密码，后面登录要用。

避坑指南：我曾经在插件安装这一步选了「全部安装」，结果 Jenkins 直接卡死。插件之间也有依赖冲突，所以别贪多。后面需要什么再装什么。

2.6 配置 JDK 与 Maven

Jenkins 本身不绑定 JDK 和 Maven，你得告诉它「用哪个」。进入 系统管理 → 全局工具配置。

配置 JDK：

  1. 找到「JDK」部分
  2. 点击「新增 JDK」
  3. 别名填 JDK11
  4. 勾选「自动安装」或手动填入 JAVA_HOME 路径

如果你用自动安装，Jenkins 会自己去下载。我建议手动指定路径，更可控：

# 查看 JDK 安装路径
update-alternatives --list java
# 输出类似：/usr/lib/jvm/java-11-openjdk-amd64/bin/java
# 去掉 /bin/java，就是 JAVA_HOME
JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

配置 Maven：

  1. 找到「Maven」部分
  2. 点击「新增 Maven」
  3. 别名填 Maven3.9
  4. 勾选「自动安装」，选择版本 3.9.x

为什么 Maven 我推荐自动安装？因为 Maven 版本更新快，手动维护路径麻烦。自动安装 Jenkins 会帮你搞定。

验证配置：配置完成后，创建一个自由风格项目，在构建步骤里加一个「执行 shell」，输入 mvn -version 和 java -version。构建一次，看控制台输出。如果能看到版本号，说明配置成功。

2.7 常用配置调优

安装完别急着用，先做几个小调整：

  • 修改端口：如果 8080 被占用，改 /etc/default/jenkins 里的 HTTP_PORT
  • 加大内存：在 /etc/default/jenkins 中设置 JAVA_ARGS="-Xmx2048m"，防止构建任务多时 OOM
  • 设置时区：在「系统管理 → 系统配置」中，找到「时区」，设为 Asia/Shanghai
我的经验：Jenkins 默认的 JVM 堆内存只有 256m，跑两个流水线就卡。我一般直接给到 2g，省心。

2.8 本章小结

到这，你的 Jenkins 环境就搭好了。JDK 配了，Maven 配了，插件也装了几个核心的。

下一章，我会带你创建第一条流水线。嗯，就是那种「代码一提交，自动构建、自动测试」的流水线。

到时候你会发现，前面这些配置工作，值了。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →