自定义Jenkins镜像构建后用户无家目录、工具未生效问题求助

1. 工具无法调用的原因 #

• 官方jenkins/jenkins镜像已将/var/jenkins_home声明为VOLUME挂载点，Dockerfile中对VOLUME路径的所有修改（包括复制文件、修改权限），在容器运行时都会被挂载的匿名/实名卷覆盖，你复制到该路径下的工具二进制根本不会保留到运行中的容器内
• 你将二进制文件复制到的/var/jenkins_home路径不在系统PATH环境变量中，就算文件存在，系统也无法直接搜索到对应命令
• 复制的二进制未添加可执行权限，即使路径正确也无法运行
• Dockerfile存在语法错误：COPY helm.缺少空格，正确写法应为COPY helm .，如果本地的helm二进制确实在构建上下文根目录，该语句会直接构建报错，你看到的构建成功大概率是缓存命中的异常结果
• 原镜像默认运行用户为jenkins（uid 1000），直接执行RUN apt-get update会因权限不足执行失败，不会安装任何依赖包

2. Jenkins用户（uid 1000）无家目录的原因 #

• 原镜像中jenkins用户的默认家目录就是/var/jenkins_home，如果运行容器时该路径挂载的卷未正确初始化、或者你手动指定了错误的用户参数启动容器，就会出现家目录不存在的异常
• 你在Dockerfile中对/var/jenkins_home的chown操作属于VOLUME路径内的修改，运行时不生效，若挂载的宿主机目录/卷权限不属于uid 1000，会导致jenkins用户无法访问该路径，表现为家目录不存在

核心逻辑为：系统级工具安装到系统路径下，不要放到VOLUME目录内，所有系统操作切换到root用户执行，完成后切回jenkins用户保证运行安全。

修正后的Dockerfile #

FROM jenkins/jenkins:lts-jdk11

# 切换到root用户执行系统操作
USER root

# 执行apt更新，可根据工具依赖补充安装对应依赖包，完成后清理缓存减小镜像体积
RUN apt-get update && apt-get install -y 你需要的依赖包名 && apt-get clean && rm -rf /var/lib/apt/lists/*

# 复制二进制工具到系统PATH包含的路径，添加可执行权限
COPY terraform /usr/local/bin/
COPY sencha /usr/local/bin/
COPY go /usr/local/bin/
COPY helm /usr/local/bin/
RUN chmod +x /usr/local/bin/*

# 切回默认的jenkins用户
USER jenkins

额外注意事项 #

• 构建前确认所有二进制文件都在Dockerfile同级的构建上下文根目录中，架构与容器运行的架构匹配
• 如果你需要安装的go是完整的开发环境而非单个二进制，建议通过官方压缩包解压安装并配置环境变量，示例如下：

  # 替换之前的COPY go /usr/local/bin/逻辑
  COPY go1.21.linux-amd64.tar.gz /tmp/
  RUN tar -C /usr/local -xzf /tmp/go1.21.linux-amd64.tar.gz && rm /tmp/go1.21.linux-amd64.tar.gz
  ENV PATH=$PATH:/usr/local/go/bin
  

• 启动容器时如果挂载宿主机目录到/var/jenkins_home，需要先执行权限修正：chown -R 1000:1000 /宿主机/待挂载的jenkins目录，避免jenkins用户无权限访问家目录

内容的提问来源于stack exchange，提问作者Suresh Kachwa