Jenkins镜像构建报错：无法创建/访问指定目录求助

一、解决chown: cannot access '/var/jenkins_home/files': No such file or directory错误 #

这个问题的核心原因是官方Jenkins镜像将/var/jenkins_home定义为VOLUME。在Docker构建阶段，对VOLUME目录的修改不会被持久化到镜像中——你用mkdir创建的目录实际上是在临时挂载的volume里，后续步骤切换用户后就无法访问这个临时路径了。

正确的做法是利用Jenkins官方镜像的初始化机制：/usr/share/jenkins/ref目录下的所有内容，会在Jenkins容器启动时自动复制到/var/jenkins_home，并自动设置jenkins用户的权限。修改后的Dockerfile如下：

FROM jenkins/jenkins:2.107.3
ENV JAVA_OPTS="-Djenkins.install.runSetupWizard=false"
USER root

# 在/usr/share/jenkins/ref下创建需要的目录，Jenkins启动时会同步到/var/jenkins_home
RUN mkdir -p /usr/share/jenkins/ref/files
RUN mkdir -p /usr/share/jenkins/ref/.groovy/grapes/org.yaml/snakeyaml/jars
# 给这些目录设置正确权限
RUN chown -R jenkins:jenkins /usr/share/jenkins/ref/files
RUN chown -R jenkins:jenkins /usr/share/jenkins/ref/.groovy/grapes

USER jenkins
COPY plugins.txt /usr/share/jenkins/ref/plugins.txt
RUN /usr/local/bin/install-plugins.sh < /usr/share/jenkins/ref/plugins.txt

# 将初始化脚本、配置文件、依赖文件放到ref目录对应位置
COPY 03security.groovy /usr/share/jenkins/ref/init.groovy.d/03security.groovy
COPY ivy-1.21.xml /usr/share/jenkins/ref/.groovy/grapes/org.yaml/snakeyaml/ivy-1.21.xml
COPY snakeyaml-1.21.jar /usr/share/jenkins/ref/.groovy/grapes/org.yaml/snakeyaml/jars/snakeyaml-1.21.jar
COPY mainConfig.yml /usr/share/jenkins/ref/files/mainConfig.yml
COPY 03mainConfig.groovy /usr/share/jenkins/ref/init.groovy.d/03mainConfig.groovy

这样修改后，构建过程中不会再出现找不到目录的错误，启动Jenkins时所有文件都会被正确同步到/var/jenkins_home并设置好权限。

二、加载snakeyaml或其他库到Jenkins Docker镜像的可行方案 #

方案1：预加载Groovy Grapes缓存（你当前思路的优化版） #

上面的修改已经实现了这个方案：提前将snakeyaml的jar包和对应的ivy描述文件放到/usr/share/jenkins/ref/.groovy/grapes的对应路径下。这样你的Groovy初始化脚本中使用@Grab('org.yaml:snakeyaml:1.21')时，Grapes会直接使用本地缓存的文件，不需要联网下载。

方案2：将依赖jar包放到Jenkins的全局类路径 #

如果你的Groovy脚本不需要动态加载依赖，可以直接将snakeyaml的jar包放到Jenkins的全局类路径目录（比如/usr/share/jenkins/ref/lib），这样所有Jenkins的Groovy脚本都能直接使用该库，不需要@Grab注解：

# 在root用户下复制jar包到全局类路径
USER root
COPY snakeyaml-1.21.jar /usr/share/jenkins/ref/lib/snakeyaml-1.21.jar
RUN chown jenkins:jenkins /usr/share/jenkins/ref/lib/snakeyaml-1.21.jar
USER jenkins

方案3：在Groovy脚本中自动下载依赖（适合联网环境） #

如果你的构建环境可以联网，也可以直接在Groovy脚本中使用@Grab注解，Grapes会自动下载依赖。但需要注意配置镜像源加速（比如国内的Maven镜像），避免下载超时：

@GrabResolver(name='aliyun', root='https://maven.aliyun.com/repository/public')
@Grab('org.yaml:snakeyaml:1.21')
import org.yaml.snakeyaml.Yaml

// 后续使用snakeyaml的代码

这种方式不需要在Dockerfile中处理依赖文件，更简洁，但依赖外部网络环境。

内容的提问来源于stack exchange，提问作者Charles Findlay