Dockerfile安装Gradle后Jenkins执行gradle -v提示未找到问题

我之前也碰到过一模一样的情况，问题核心出在环境变量的继承差异上：容器内直接启动交互式shell时能找到gradle，但Jenkins执行的是非交互式shell，默认不会加载你可能手动添加的PATH配置，而且如果Dockerfile里没把Gradle的路径加到全局环境变量里，Jenkins的shell进程就找不到这个命令。

先排查你的Dockerfile细节 #

看你给出的安装片段，有两个需要注意的点：

1. wget命令参数有误：你用了小写的-o，这是指定日志输出文件，正确指定下载文件名的参数是大写-O，不过你说容器内能正常运行，可能这个已经修正过了，但还是提一下避免后续踩坑。
2. 最关键的遗漏：没有将Gradle的bin目录加入全局环境变量

两种可行解决方案，任选其一即可 #

方案1：用ENV配置全局PATH

在Dockerfile的Gradle安装代码末尾加上：

ENV GRADLE_HOME=/usr/lib/gradle-3.4.1
ENV PATH=$PATH:$GRADLE_HOME/bin

这样构建出的镜像，所有进程（包括Jenkins启动的shell）都会继承这个PATH环境变量，自然就能找到gradle命令了。

方案2：创建软链接到系统默认PATH目录

如果你不想修改环境变量，可以直接把gradle命令软链接到/usr/bin（这个目录默认在系统PATH里）：

RUN ln -s /usr/lib/gradle-3.4.1/bin/gradle /usr/bin/gradle

这样系统任何位置执行gradle都会指向实际的命令文件。

为什么容器内直接执行没问题？ #

当你直接进入容器的交互式shell时，会自动加载~/.bashrc或者/etc/profile这类配置文件，如果之前手动把Gradle路径加到了这些文件里，shell就能找到命令。但Jenkins执行shell时是非交互式非登录模式，不会加载这些配置文件，所以必须通过Dockerfile把路径写到全局环境变量里，确保所有进程都能获取到。

内容的提问来源于stack exchange，提问作者Abhilash Reddy Bommareddy