jenkins简介

Jenkins LTS 从零安装：macOS 上 5 分钟跑通第一个构建

刚接触 Jenkins 的时候，我也挺懵的——这东西到底是干啥的？

简单说：你代码 push 上去，它自动帮你拉代码、编译、跑测试、打包。省掉每次手动操作的重复劳动，把”人工 trigger”变成”自动事件驱动”。

这篇是 macOS 上的安装教程，Windows / Linux 用户可以直接去官网下载对应版本。

---

前置条件

Jenkins 是 Java 应用，依赖 JDK 21（当前 LTS 版本强依赖）。

用 Homebrew 安装会自动拉 openjdk@21，不用操心。但如果打算手动部署 .war，请先确认本机有 Java 21。

java -version
# 预期输出包含 openjdk version "21"

安装 Homebrew

macOS 上的包管理工具，不确定装没装的话：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Apple Silicon（M 系列芯片）用户装完后留意终端提示，需要把 /opt/homebrew/bin 加入 PATH。

---

安装 Jenkins

Homebrew 提供两个版本：

• jenkins —— 普通最新版，跟随上游快速迭代
• jenkins-lts —— 长期支持版，每 12 周发一个稳定分支

建议选 LTS，稳定第一。

brew install jenkins-lts

Homebrew 会自动处理依赖（包括 openjdk@21），等跑完就行。

💡 如果确实需要特定历史版本（比如迁移项目需对齐版本），Homebrew 不提供 jenkins-lts@x.x.x 这种版本化 formula，只能去 Jenkins 官网 或 GitHub Releases 下载对应版本的 .war 手动部署。

所以像 brew install jenkins-lts@2.440.1 这种写法会直接报错，不要照敲。

---

启动 Jenkins

装完后有两种启动方式。

方式一：后台服务（推荐）

brew services start jenkins-lts

Jenkins 作为 launchd 服务在后台运行，重启电脑自动拉起。

常用管理命令：

brew services stop jenkins-lts    # 停止
brew services restart jenkins-lts # 重启

方式二：前台进程（调试用）

jenkins-lts

终端一关进程就没了，只适合临时验证。

---

验证启动

Jenkins 默认监听 8080 端口。如果该端口已被其他服务占用（Tomcat、Nginx、Adobe Creative Cloud 等），Jenkins 会启动失败且 brew services 模式下的错误提示不明显。

启动后访问：

http://localhost:8080

页面提示输入初始密码。在终端执行：

cat ~/.jenkins/secrets/initialAdminPassword

把输出的一串 UUID 粘进去就行。

---

初始化配置

进入后选“安装推荐的插件”，Git、Pipeline、Credentials 等核心插件会自动装上。

⚠️ 不同 LTS 版本的”推荐列表”有差异。装完后检查一下是否缺少你需要的插件（如 Maven Integration、Docker Pipeline），缺的话在插件管理里手动补充。

进度条走完后，设置管理员账号密码，完成。

---

接下来

你已经有一个可运行的 Jenkins 实例了。下一步可以：配置第一个 Freestyle job、写 Jenkinsfile 做 Pipeline-as-Code、接入 Webhook 实现 push 自动触发。

后面我会陆续写这些内容。