3、Jenkins入门：Jenkins的安装与启动

好，咱们正式开始动手了。这一章我带你搞定 Jenkins 的安装和启动。

说实话，Jenkins 的安装方式有好几种。我个人最常用的是两种：War 包方式和 Docker 方式。前者适合在已有服务器上快速部署，后者适合容器化环境，干净利落。

3.1 安装前的准备

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

  • Java 环境：Jenkins 是 Java 写的，必须要有 JDK 或 JRE。我建议用 JDK 11 或 17。
  • 内存：至少 2GB，推荐 4GB 以上。我在项目中遇到过内存不够导致构建卡死的情况，嗯，那滋味不好受。
  • 磁盘空间：至少 10GB 空闲。Jenkins 会存构建产物和日志，时间长了很占地方。
⚠️ 注意： 千万别用 JDK 8 了。Jenkins 新版本已经不再支持。我曾经踩过这个坑，折腾了半天才发现是版本问题。

3.2 方式一：War 包安装

这种方式最传统，也最灵活。说白了就是下载一个 war 包，扔到 Tomcat 里或者直接用 java -jar 启动。

3.2.1 下载 War 包

去 Jenkins 官网下载最新的稳定版 war 包。我习惯用 wget 直接拉：

# 下载 Jenkins LTS 版本
wget https://get.jenkins.io/war-stable/latest/jenkins.war

3.2.2 启动 Jenkins

下载完后，直接运行：

# 默认端口 8080
java -jar jenkins.war

# 如果你想换个端口，比如 9090
java -jar jenkins.war --httpPort=9090

启动后，你会看到控制台输出一段日志。注意找一行：

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

这串密码就是你的「入场券」。复制下来，后面要用。

💡 小技巧： 密码其实也保存在服务器上。路径是 /root/.jenkins/secrets/initialAdminPassword。忘了的话可以直接 cat 出来。

3.3 方式二：Docker 安装

如果你在用 Docker，那这种方式更省心。一条命令搞定：

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

解释一下参数：

  • -p 8080:8080：Web 访问端口
  • -p 50000:50000：Jenkins 与 agent 通信的端口
  • -v jenkins_home:/var/jenkins_home：数据持久化。容器删了数据还在，这个很重要！

启动后，用 docker logs jenkins 也能看到初始密码。

⚠️ 注意： 用 Docker 方式时，记得把时区挂载进去。不然 Jenkins 日志时间全是 UTC，排查问题很痛苦。我加个 -e TZ=Asia/Shanghai 就解决了。

3.4 初始配置

安装完只是第一步。接下来要做三件事：插件管理、系统设置、全局工具配置。这三件事搞定了，Jenkins 才算真正能用。

3.4.1 插件管理

浏览器打开 http://你的IP:8080，输入刚才的密码。然后会进入插件安装界面。

我建议选「安装推荐插件」。Jenkins 官方已经帮你挑好了常用的插件，比如 Git、Pipeline、Blue Ocean 等。省心。

当然，你也可以自定义。我个人习惯先装这几个：

插件名称 用途
Git 拉取代码
Pipeline 流水线编排
Blue Ocean 可视化流水线
Credentials Binding 管理凭证
Docker Pipeline Docker 构建

安装过程可能会有点慢，耐心等。如果卡住了，可以点「重试」。

💡 小技巧： 如果网络不好，可以离线安装。去 Jenkins 官网下载插件 .hpi 文件，然后上传到「高级」页面手动安装。我在内网环境经常这么干。

3.4.2 系统设置

插件装完后，进入「系统管理」→「系统配置」。这里有几个关键项：

  • Jenkins URL：填你的 Jenkins 访问地址。比如 http://192.168.1.100:8080
  • 系统管理员邮件地址：填一个邮箱，用于发送构建通知
  • 全局属性：可以添加环境变量，比如 JAVA_HOME、MAVEN_HOME

其他设置保持默认就行。别急着改太多，后面用到了再调。

3.4.3 全局工具配置

这一步很关键。进入「系统管理」→「全局工具配置」。你需要配置：

  • JDK：添加你安装的 JDK 路径，或者让 Jenkins 自动下载
  • Git：指定 git 可执行文件路径。一般填 /usr/bin/git
  • Maven：如果你用 Maven 构建，这里配置一下

举个例子，配置 JDK：

名称：JDK11
JAVA_HOME：/usr/lib/jvm/java-11-openjdk-amd64

配置 Git：

名称：Default
Path to Git executable：/usr/bin/git
⚠️ 注意： 如果你让 Jenkins 自动安装工具，它会去官网下载。国内网络可能很慢。我建议手动下载好，然后指定本地路径。这样又快又稳。

3.5 验证安装

配置完成后，创建一个简单的自由风格项目测试一下：

  1. 点「新建任务」→ 输入任务名 → 选择「自由风格项目」
  2. 在「构建」步骤中，选择「执行 shell」
  3. 输入 echo "Hello Jenkins!"
  4. 保存并点击「立即构建」

如果控制台输出显示 Hello Jenkins!，恭喜你，Jenkins 安装成功了！

🎯 核心要点：
  • War 包方式适合传统服务器，Docker 方式适合容器化环境
  • 初始密码在控制台日志或 initialAdminPassword 文件中
  • 插件管理、系统设置、全局工具配置是三大基础配置
  • 工具配置建议用本地路径，避免网络问题

好了，这一章就到这里。Jenkins 装好了，配置也搞定了。下一章咱们开始写第一条流水线，真正跑起来！

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