Jenkins流水线Docker容器中File Parameter文件无法读取问题求助

你的问题核心是Jenkins工作目录下的文件没有正确挂载到Docker容器内，以下是具体排查和解决步骤：

1. 先确认文件是否真的存在于Jenkins Agent的工作目录 #

在docker.inside代码块之前，先执行本地目录检查，验证上传的文件是否到位：

pipeline {
  agent {
    label 'ubuntu:22.04'
  }

  stages {
    stage('main') {
      steps {
        script {
          // 先在Jenkins Agent本地检查文件
          sh 'ls -la json'
          docker.withRegistry("${SOME_DOCKER_REGISTRY}", "${SOME_TOKEN}") {
            docker.image("${DOCKER_CONTAINER_NAME}").inside {
              sh 'ls json'
            }
          }
        }
      }
    }
  }
}

如果本地ls json也看不到文件，说明File Parameter的路径配置错误：

• 检查Jenkins流水线GUI的File Parameter设置，确保File location填写的是json/somefile.json（相对Jenkins工作目录的路径，不要用绝对路径）。

2. 显式挂载目录到Docker容器 #

默认情况下docker.inside会挂载Jenkins的工作目录到容器内，但可能因容器配置（如自定义工作目录）导致路径不匹配。显式指定挂载参数可以解决这个问题：

pipeline {
  agent {
    label 'ubuntu:22.04'
  }

  stages {
    stage('main') {
      steps {
        script {
          docker.withRegistry("${SOME_DOCKER_REGISTRY}", "${SOME_TOKEN}") {
            // 显式挂载Jenkins工作目录下的json目录到容器内的对应路径
            docker.image("${DOCKER_CONTAINER_NAME}").inside("-v ${env.WORKSPACE}/json:${env.WORKSPACE}/json") {
              sh 'ls json'
            }
          }
        }
      }
    }
  }
}

如果你的Python脚本在容器内预期读取的是其他路径，把冒号右侧的路径改成脚本需要的路径即可（比如/app/json）。

3. 解决文件权限问题 #

上传的文件可能属于Jenkins用户（如jenkins），而Docker容器内运行的用户没有读取权限。可以在进入容器前修改权限：

pipeline {
  agent {
    label 'ubuntu:22.04'
  }

  stages {
    stage('main') {
      steps {
        script {
          // 赋予json目录及文件可读权限
          sh 'chmod -R 755 json'
          docker.withRegistry("${SOME_DOCKER_REGISTRY}", "${SOME_TOKEN}") {
            docker.image("${DOCKER_CONTAINER_NAME}").inside {
              sh 'ls json'
            }
          }
        }
      }
    }
  }
}

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