4. Jenkins 安装与初始配置：安装方式（WAR/Docker/K8s）、初始解锁、插件安装建议、全局工具配置（JDK/Git/Maven/Node.js）

Jenkins 作为 CI/CD 流水线的核心调度引擎，其安装方式与初始配置直接影响后续流水线的稳定性与扩展性。本章将系统讲解三种主流安装方式、首次解锁流程、插件选型策略以及全局工具链配置，帮助你在不同基础设施场景下快速搭建可用的 Jenkins 环境。

4.1 安装方式对比与选型

根据团队规模、基础设施成熟度与运维能力，Jenkins 安装可分为以下三种模式：

4.1.1 WAR 包安装（快速入门）

1. 下载最新稳定版 WAR 包：jenkins.war（官方镜像源或国内镜像）
2. 确保已安装 JDK 11 或 JDK 17
3. 启动命令：java -jar jenkins.war --httpPort=8080
4. 访问 http://localhost:8080 进入解锁页面

# 示例：使用 JDK 17 启动 Jenkins
java -jar jenkins.war --httpPort=8080 --prefix=/jenkins

4.1.2 Docker 容器安装（推荐）

# 拉取官方 LTS 镜像
docker pull jenkins/jenkins:lts-jdk17

# 运行容器（挂载数据卷）
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts-jdk17

4.1.3 Kubernetes 部署（企业级）

使用 Helm Chart 是最推荐的 K8s 部署方式，可一键完成 Jenkins Master 与动态 Agent 的配置：

# 添加 Jenkins Helm 仓库
helm repo add jenkins https://charts.jenkins.io
helm repo update

# 安装 Jenkins（自定义 values.yaml）
helm install jenkins jenkins/jenkins \
  --namespace jenkins \
  --create-namespace \
  -f values.yaml

以下为 K8s 部署 Jenkins 的核心架构示意：

4.2 初始解锁与插件安装

4.2.1 首次解锁流程

1. 浏览器访问 Jenkins 地址，页面提示输入初始管理员密码
2. 查看密码：docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
3. 输入密码后进入“自定义 Jenkins”页面
4. 选择“安装建议插件”或“选择插件来安装”
5. 创建第一个管理员用户（建议使用强密码）
6. 配置 Jenkins URL（默认使用当前访问地址）

4.2.2 插件安装建议（按优先级分组）

4.3 全局工具配置

全局工具配置是 Jenkins 能够调用 JDK、Git、Maven、Node.js 等构建环境的前提。配置路径：Dashboard → Manage Jenkins → Tools。

4.3.1 JDK 配置

• 自动安装： 选择“Install automatically”，从 adoptium.net 或 oracle 下载
• 手动指定： 填写 JAVA_HOME 路径（适用于已预装 JDK 的 Agent）
• 建议： 配置 JDK 11 和 JDK 17 两个版本，分别用于不同项目

# 手动配置示例（Linux Agent）
Name: JDK17
JAVA_HOME: /usr/lib/jvm/java-17-openjdk-amd64

4.3.2 Git 配置

• 通常无需自动安装，直接使用系统 Git（路径：/usr/bin/git）
• 若 Agent 未预装 Git，可选择“Install from Apache”自动下载
• 验证命令：git --version

4.3.3 Maven 配置

• 自动安装： 选择版本（如 3.9.6），Jenkins 自动下载并缓存
• 手动配置： 指定本地 MAVEN_HOME 路径
• settings.xml： 可在“Managed files”中统一管理，避免每个项目重复配置

# 自动安装配置示例
Name: Maven-3.9
Install automatically: ✅
Version: 3.9.6

4.3.4 Node.js 配置

• 安装 NodeJS 插件后，在 Tools 中新增 NodeJS 安装
• 支持自动安装 LTS 版本（如 20.x）
• 可同时配置 npm 全局包（如 yarn、pnpm）

# NodeJS 配置示例
Name: NodeJS-20
Install automatically: ✅
Version: NodeJS 20.11.0
Global npm packages: yarn pnpm

4.4 全局工具配置架构图

以下图示展示了 Jenkins 全局工具配置与 Pipeline 执行时的调用关系：

4.5 配置验证与常见问题

4.5.1 验证工具配置是否生效

创建一个简单的 Pipeline 作业，使用以下脚本验证各工具是否可被正确调用：

pipeline {
    agent any
    tools {
        jdk 'JDK17'
        maven 'Maven-3.9'
        nodejs 'NodeJS-20'
    }
    stages {
        stage('Verify Tools') {
            steps {
                sh 'java -version'
                sh 'git --version'
                sh 'mvn --version'
                sh 'node --version'
                sh 'npm --version'
            }
        }
    }
}

4.5.2 配置持久化与备份

全局工具配置存储在 JENKINS_HOME/config.xml 中，建议定期备份该文件。若使用 Docker 或 K8s 部署，确保 JENKINS_HOME 挂载到持久化存储，避免配置丢失。