Jenkins技术问询：如何将自定义工具添加至作业构建环境？

别急，我来帮你捋清楚这个问题！首先咱们先确认几个基础前提，再一步步找选项，实在不行还有替代方案。

先确认插件状态 #

首先要确保你已经正确安装了Custom Tools Plugin，而且安装后Jenkins已经重启过——很多插件安装后必须重启才会在界面上显示对应的选项，这一步很容易被忽略！

找到“工具需求”选项的正确位置 #

如果插件没问题，那大概率是你在作业配置里找错地方了，跟着这个步骤走：

1. 打开你的Jenkins作业，点击顶部的配置按钮进入设置页面
2. 往下滚动页面，找到构建环境（Build Environment）区块，点击展开它
3. 在这个区块里，你应该能看到一个名为 "Provide tools"（中文界面会显示“提供工具”）的复选框，勾选它
4. 勾选之后，下面会弹出一个工具选择的下拉菜单，你就能选中之前在全局工具配置里定义好的自定义工具了
5. 保存作业配置后，下次构建时Jenkins就会自动处理这个工具的安装和调用

要是还是找不到选项？试试这两个替代方法 #

如果上面的步骤还是没找到对应的选项，或者插件和Jenkins版本有兼容性问题，可以试试这两种方式：

方法1：Pipeline脚本直接调用（推荐） #

如果你的作业是Pipeline类型，直接在Jenkinsfile里写代码就能调用自定义工具，示例如下：

pipeline {
    agent any
    tools {
        customTool '你的自定义工具名称' // 这里填你之前定义的工具名
    }
    stages {
        stage('运行自定义工具') {
            steps {
                sh 'your-custom-tool-command' // 替换成你的工具执行命令
            }
        }
    }
}

Jenkins会自动处理工具的安装，并且把工具路径加入环境变量，你直接调用命令就行。

方法2：自由风格作业手动配置路径 #

如果是自由风格作业，你可以：

1. 先去Jenkins的全局工具配置里，找到你定义的自定义工具，记下它的安装路径
2. 在作业的构建步骤里（比如“执行shell”或“执行Windows批处理命令”），手动指定工具的完整路径，或者把工具路径加入环境变量：
   比如在shell中：

   export PATH=$PATH:/path/to/your/custom/tool
   your-tool-command
   

额外排查小Tips #

• 检查Jenkins和Custom Tools Plugin的版本兼容性，有些旧版本的插件可能界面位置不同，或者缺少部分功能，建议尽量使用兼容的新版本
• 别搞混了全局工具配置和作业配置：全局工具配置是用来定义工具的地方，而作业配置才是添加工具需求、让构建过程调用工具的地方，你要找的选项肯定在作业配置里！

内容的提问来源于stack exchange，提问作者Ivajlo Iliev