Jenkins使用求助：如何将本地Python脚本复制到Jenkins工作区

以下按两种常见场景提供对应操作方案：

场景1：脚本存放在Jenkins节点（主节点/代理节点）本地磁盘 #

Freestyle 项目配置步骤 #

• 进入目标Jenkins项目的「配置」页面
• 下滑到「构建」模块，点击「增加构建步骤」：
  • 节点为Linux/macOS系统选择「执行shell」
  • 节点为Windows系统选择「执行Windows批处理命令」
• 填入对应复制命令：
  Linux/macOS示例：cp /本地脚本存放绝对路径/your_script.py ${WORKSPACE}/
  Windows示例：copy C:\本地脚本存放绝对路径\your_script.py %WORKSPACE%\
• 保存配置后执行构建，脚本会自动复制到当前任务的工作区根目录

Pipeline 项目配置步骤 #

直接在Jenkinsfile或Pipeline脚本编辑框中添加复制步骤即可，Linux节点示例：

pipeline {
    agent any
    stages {
        stage('复制脚本到工作区') {
            steps {
                // 替换为你本地脚本的实际绝对路径
                sh 'cp /data/python_scripts/your_script.py ${WORKSPACE}/'
            }
        }
        // 后续执行脚本的步骤可直接调用./your_script.py
    }
}

场景2：脚本存放在你个人的办公电脑本地（非Jenkins节点） #

两种常用方案可选：

• 方案一（推荐，适合脚本需要迭代更新的场景）：将脚本上传到公司内部的Git代码仓库，在Jenkins任务中配置代码拉取步骤，构建时自动拉取脚本到工作区
• 方案二（适合单次临时使用的场景）：配置参数化构建上传文件：
  • 进入项目配置页，勾选「参数化构建过程」，点击「增加参数」选择「文件参数」
  • 填写参数名称，「文件位置」栏填入你想要保存在工作区的文件名，比如your_script.py
  • 保存配置后点击「Build with Parameters」，选择本地的Python脚本后触发构建，脚本会自动上传到当前任务的工作区

注意事项 #

• 复制前确认Jenkins运行账号对本地脚本存放路径有读取权限，对Jenkins工作区路径有写入权限
• ${WORKSPACE}是Jenkins内置全局变量，自动指向当前任务的工作区绝对路径，不需要手动修改
• 如果需要把脚本复制到远程代理节点的工作区，优先使用代码仓库拉取的方案，可避免跨节点文件权限、网络连通性等问题

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