Jenkins跨实例远程触发任务：如何传递文件参数及等待结果？

一、Parameterized Remote Trigger插件是否支持File参数？ #

不支持。该插件的参数传递机制仅基于字符串键值对，底层未实现文件上传或文件对象传输的逻辑，只能传递普通字符串参数，无法直接处理File类型参数。

二、跨Jenkins实例远程触发+等待结果的最优替代方案 #

根据文件大小、环境配置的不同，推荐以下几种方案：

1. 共享存储+路径参数（最适合大文件） #

将需要传递的文件放到两台Jenkins均可访问的共享存储（如NFS、内部文件服务器、对象存储），远程触发时仅传递文件的路径字符串，下游任务根据路径读取文件即可。
示例代码：

// 上游任务：确保文件已上传到共享存储，传递路径参数
def handle = triggerRemoteJob job: 'http://my-jenkins-instance/job/my-job-name', 
    parameters: 'param1=abc\nfile_path=/shared-storage/my-data.txt'

下游任务直接通过路径读取文件：

def fileContent = readFile(params.file_path)

2. Base64编码传递（适合小文件） #

如果文件体积较小（几MB以内），可以将文件内容编码为Base64字符串，作为普通参数传递，下游任务解码后还原文件。该方案无需依赖额外存储，但大文件会触发参数长度限制。
示例代码：

// 上游任务：读取文件并编码为Base64
def fileBase64 = readFile('local-file.txt').bytes.encodeBase64().toString()
def handle = triggerRemoteJob job: 'http://my-jenkins-instance/job/my-job-name', 
    parameters: "param1=abc\nfile_base64=${fileBase64}"

下游任务解码还原：

def decodedContent = new String(params.file_base64.decodeBase64())
writeFile file: 'received-file.txt', text: decodedContent

3. Jenkins REST API手动实现（最灵活） #

直接调用Jenkins REST API完成文件上传+任务触发，同时轮询任务状态直到完成。这种方式完全自定义，支持所有参数类型，但需要处理API认证和请求细节。
示例（需上游安装HTTP Request Plugin）：

def jenkinsUrl = 'http://my-jenkins-instance'
def jobName = 'my-job-name'
def authCredentials = 'your-username:your-api-token'
def localFilePath = 'local-file.txt'

// 上传文件并触发任务，获取构建ID
def buildResp = httpRequest(
    url: "${jenkinsUrl}/job/${jobName}/buildWithParameters",
    authentication: authCredentials,
    method: 'POST',
    multipart: [
        [name: 'param1', value: 'abc'],
        [name: 'targetFileParam', file: localFilePath] // 对应下游的File参数名
    ]
)
def buildId = buildResp.headers['Location'].split('/')[-1]

// 轮询等待任务结束
def buildStatus = 'RUNNING'
while (buildStatus == 'RUNNING') {
    sleep(10000)
    def statusResp = httpRequest(
        url: "${jenkinsUrl}/job/${jobName}/${buildId}/api/json",
        authentication: authCredentials
    )
    buildStatus = new groovy.json.JsonSlurper().parseText(statusResp.content).result
}

// 输出结果
println "下游任务执行结果：${buildStatus}"

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