📚 课程目录第4章 Jenkins安装与基础配置

4、Jenkins安装与基础配置：在Linux/Windows上安装Jenkins，配置管理员账号和全局工具

说实话，每次接手一个新团队，我第一件事就是先把CI环境搭起来。Jenkins这玩意儿虽然老，但胜在稳定、插件多、社区活跃。今天咱们就走一遍完整的安装和基础配置流程，涵盖Linux和Windows两种环境，顺便聊聊我踩过的坑。

4.1 安装前的准备

先别急着装。你得确认几件事：

Java环境：Jenkins是用Java写的，至少需要Java 8或11。我建议直接用Java 11，兼容性更好。
内存：最低512MB，生产环境建议2GB以上。
硬盘：至少10GB空闲空间，日志和构建产物很吃空间。

⚠️ 我曾经在2GB内存的服务器上跑Jenkins + 10个流水线，结果频繁OOM……后来加了4GB才稳住。你想想看，构建任务多的时候，JVM吃内存特别凶。

4.2 Linux 上安装 Jenkins（以 Ubuntu 为例）

我最常用的是Debian系，这里给出标准步骤：

添加Jenkins官方仓库并导入密钥
安装OpenJDK 11
安装Jenkins
启动并设置开机自启

# 1. 添加仓库和密钥
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo apt-key add -
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

# 2. 更新并安装OpenJDK 11
sudo apt update
sudo apt install openjdk-11-jdk -y

# 3. 安装Jenkins
sudo apt install jenkins -y

# 4. 启动并设置开机自启
sudo systemctl enable --now jenkins

装完之后，访问 http://你的服务器IP:8080。首次进来会看到解锁页面——需要读取初始密码。

💡 查找初始密码： sudo cat /var/lib/jenkins/secrets/initialAdminPassword。我习惯把这串密码存到密码管理器里，省得忘。

4.3 Windows 上安装 Jenkins

Windows下有两种方式：安装程序或WAR包。我个人推荐用安装程序，省事。

安装程序方式：去官网下载Windows安装包（.msi），双击一路Next。记得勾选“Run Jenkins as a local system account”。安装完后会自动启动服务，默认端口还是8080。
WAR包方式：下载jenkins.war，然后 java -jar jenkins.war --httpPort=8080。适合不想装服务的临时测试。

首次启动后，解锁步骤和Linux一样。初始密码在 C:\ProgramData\Jenkins\.jenkins\secrets\initialAdminPassword 里。

  ‼️ 注意：Windows下如果端口被占用（比如IIS），可以改端口：

  修改 C:\ProgramData\Jenkins\jenkins.xml 中的 --httpPort=8080 为其他端口，然后重启服务。

4.4 配置管理员账号

解锁完成后，Jenkins会引导你创建第一个管理员账号。我个人习惯：

用户名：admin
密码：使用强密码（至少12位，含大小写+数字+特殊符号）
全名：写自己名字，方便团队识别
邮箱：一定要填真实邮箱！Jenkins任务失败时会发通知，没有邮箱你会错过很多关键告警

创建完成后，点击“开始使用Jenkins”。你也可以之后在「Manage Jenkins → Manage Users」里添加更多用户。

4.5 全局工具配置

作为一个CI/CD工具，你不配好JDK、Git、Maven，那什么事都干不了。来这里配：Manage Jenkins → Tools。

工具名称	配置要点	个人经验
JDK	勾选「Install automatically」，选择版本（如JDK 11）。或者添加本地已安装的路径。	我项目中曾因JDK版本和项目不匹配导致编译失败。建议锁定一个稳定版本，比如11.0.12。
Git	输入git可执行文件路径（Linux: `/usr/bin/git`；Windows: `C:\Program Files\Git\bin\git.exe`）。	Windows下一定要勾选「Check if Git is available」，否则构建时可能找不到git命令。
Maven	自动安装选择Maven 3.8.x，或指定本地 `M2_HOME`。	设置时建议加上 `MAVEN_OPTS: -Xmx1024m`，避免大项目构建OOM。
Gradle	如果需要Gradle，同理自动安装即可。	我习惯把Gradle Wrapper放进项目里，Jenkins直接执行 `./gradlew`，省去全局配置。
NodeJS	插件支持自动安装多个Node版本，还可以设置别名。	前端项目一定要装这个，不然npm命令跑不了。

🎯 技巧： 配置完所有工具后，建一个简单freestyle job，加一个「Execute shell / Windows batch command」步骤，分别执行 java -version、git --version、mvn -version，跑一次看是否正常输出。这叫“冒烟验证CI本身”，我每次新环境都会跑一遍。

4.6 安装常用插件

全局工具配好后，别忘了装插件。在「Manage Jenkins → Plugins → Available plugins」里搜索安装：

Pipeline：核心中的核心，支持声明式流水线。
Git Parameter：可以在构建时选择分支。
Blue Ocean：好看的流水线可视化界面。
Email Extension：邮件通知增强。
SSH Agent：用于git私钥认证。

装完之后重启Jenkins，让插件生效。嗯，这里要注意，有些插件依赖其他插件，Jenkins会自动安装，但偶尔会冲突。我曾经遇到过某个老旧插件导致Jenkins崩溃，后来果断放弃，改用替代插件。

4.7 整体流程回顾

4.8 验证安装是否成功

当你能看到Jenkins首页（带蓝色闪电logo），并且点击「Manage Jenkins」没有异常报错，说明安装成功了。我个人还会额外做一步：

用管理员账号登录
创建一个空Pipeline job，写一句 echo "Hello, Jenkins"
手动执行一次，查看控制台输出

输出正常的话，就证明整个环境已经可用。如果不正常，优先检查日志：/var/log/jenkins/jenkins.log（Linux）或事件查看器（Windows）。

  ✅ 核心检查清单：

  ✔ Java版本正确

  ✔ 初始密码能解锁

  ✔ 管理员能登录

  ✔ 全局工具（至少JDK、Git、Maven）已配置

  ✔ 至少安装Pipeline插件

  ✔ 简单Job可以运行

好了，到这为止，你的Jenkins环境就整装待发了。接下来就可以开始创建真正的CI流水线，跑冒烟测试了——不过那是后面章节的事，今天先把基础打扎实。