4. Jenkins全局工具配置

在 Jenkins 流水线或自由风格任务中，构建工具（JDK、Maven、Node.js 等）的版本管理是 CI/CD 稳定性的基石。Jenkins 通过 全局工具配置（Manage Jenkins → Tools）统一管理这些运行时的安装路径、版本切换与自动下载策略，避免每个任务重复定义环境变量。

4.1 全局工具配置的核心概念

全局工具配置的本质是建立一个 工具名称 → 安装策略 → 实际路径 的映射表。Jenkins 支持三种安装方式：

4.2 各工具的全局配置详解

4.2.1 JDK 配置

JDK 是 Java 构建的基础。配置时需注意：

• 名称： 建议使用语义化别名，如 JDK11、JDK17。
• 自动安装： 选择 Install automatically，从 Adoptium / Eclipse Temurin 或 Oracle 源下载。
• 版本过滤： 支持按架构（x64、arm64）和操作系统（Linux、Windows、macOS）过滤。

# 流水线中引用 JDK 工具
pipeline {
    agent any
    tools {
        jdk 'JDK11'
    }
    stages {
        stage('Build') {
            steps {
                sh 'java -version'
            }
        }
    }
}

4.2.2 Git 配置

Git 是源码拉取的核心工具。Jenkins 默认使用系统 PATH 中的 Git，但显式配置可确保版本一致性：

• 自动安装： 从 git-scm.org 下载 Git for Windows 或 Linux 二进制包。
• 本地路径： 填写 git 可执行文件路径，如 /usr/bin/git。
• 验证： 配置后可在 Manage Jenkins → System Information 中查看 Git 版本。

4.2.3 Maven 配置

Maven 是 Java 项目最常用的构建工具。全局配置包括：

• 名称： 如 Maven3.9。
• 自动安装： 从 Apache 官方镜像下载指定版本。
• settings.xml 管理： 可在 Managed files 中上传全局 settings.xml，统一管理仓库镜像和认证信息。

4.2.4 Gradle 配置

Gradle 配置与 Maven 类似，但需注意：

• 自动安装： 从 Gradle 官方发行版下载。
• Wrapper 优先： 如果项目包含 gradlew，Jenkins 会优先使用 Wrapper 指定的版本，全局配置作为 fallback。
• 缓存目录： 建议在 Agent 上挂载 ~/.gradle/caches 持久卷，避免每次构建重新下载依赖。

4.2.5 Node.js 配置

Node.js 是前端和全栈项目的核心运行时。配置要点：

• 自动安装： 从 nodejs.org 下载 LTS 版本。
• npm 全局包： 可在 Global npm packages to install 中预装 yarn、pnpm、typescript 等。
• 版本切换： 流水线中可同时引用多个 Node 版本，如 nodejs 'Node18' 和 nodejs 'Node20'。

// 流水线中引用 Node.js 并安装依赖
pipeline {
    agent any
    tools {
        nodejs 'Node18'
    }
    stages {
        stage('Install & Build') {
            steps {
                sh 'npm ci'
                sh 'npm run build'
            }
        }
    }
}

4.3 全局工具配置的架构流程

下图展示了 Jenkins Master 如何根据全局工具配置，在 Agent 节点上完成工具的自动安装与缓存复用：

# 自定义下载 URL 示例（JDK）
# 在全局工具配置中，选择 "Install automatically" → "Install from URL"
# URL 格式：https://内网镜像/jdk-11.0.21_linux-x64_bin.tar.gz
# 子目录：jdk-11.0.21