Docker Hub自动构建参数查询及构建失败问题排查

我看到你碰到了一个挺棘手的问题：本地构建Docker镜像完全正常，但Docker Hub自动构建时，明明已经通过npm全局装好了yarn，执行yarn global add却提示找不到可执行文件。结合你给出的日志和Dockerfile，我来帮你分析原因并给出解决方案。

问题核心分析 #

从两份日志对比能看出来：

• 本地用Docker 18.03.1-ce构建时，第三步成功安装yarn后，第四步用RUN ["yarn", ...]能正常运行；
• Docker Hub用Docker 17.06.1-ce构建时，第三步同样把yarn装到了/usr/local/bin，但第四步调用yarn时却提示不在$PATH里。

最可能的原因是Docker版本差异导致的exec模式RUN命令环境变量继承问题。Docker 17.06.x版本处理数组形式的RUN命令（exec模式）时，可能没把/usr/local/bin正确加入到PATH中——这个目录是npm全局安装二进制文件的默认位置。虽然第二步的npm命令能执行，但大概率是node镜像本身把npm的路径内置到了exec模式的环境变量里，而后续安装的yarn没被正确识别。

可行解决方案 #

你可以试试下面几种方法来修复：

方法1：改用shell模式执行yarn命令 #

把Dockerfile里的第四步从exec模式（数组形式）改成shell模式：

RUN yarn global add @angular/cli@1.7.4

shell模式会启动一个shell进程，自动加载环境变量配置，能确保/usr/local/bin在PATH中，自然就能找到yarn可执行文件。

方法2：直接用yarn的绝对路径调用 #

绕开PATH依赖，直接指定yarn的完整路径：

RUN ["/usr/local/bin/yarn", "global", "add", "@angular/cli@1.7.4"]

这种方式直接告诉Docker要执行的二进制文件位置，完全不用依赖PATH环境变量。

方法3：显式设置PATH环境变量 #

在安装yarn之后，手动把/usr/local/bin加入环境变量：

RUN ["npm", "i", "-g", "yarn@1.5.1"]
ENV PATH="/usr/local/bin:${PATH}"
RUN ["yarn", "global", "add", "@angular/cli@1.7.4"]

这样不管exec模式下的默认PATH是什么，都能确保包含yarn所在的目录。

额外排查建议 #

如果想彻底搞清楚PATH的差异，可以在Dockerfile里加一个打印PATH的步骤，比如在安装yarn之后：

RUN ["echo", "$PATH"]

这样在Docker Hub的构建日志里就能看到具体的PATH内容，和本地构建日志对比，就能明确差异到底在哪。

内容的提问来源于stack exchange，提问作者Thomas Sablik