从浏览器表单提交中接受一个文件,作为构建参数。上传后的文件将会放在工作空间中指定的位置,你 可以在构建任务中访问并使用它。

这对于很多场景下是有帮助的,例如:

  1. 让用户基于他们构建出来的成品运行测试。
  2. 允许用户在自动化上传、发布、部署过程中替换文件。
  3. 通过上传一个数据集来处理数据。

表单提交中的文件名称就是文件的路径,并且是在环境变量中可见的。例如:你把文件路径设置为 abc.zip,然后${abc.zip}会从浏览器传递给你原始的文件名称。 (例如my.zip。)这里的名称不会包含目录部分。

文件的上传是可选的。如果用户不上传任何文件,Jenkins只是简单地跳过这个参数并不会替换 任何文件(但是也不会删除任何已经存在的文件)。

在命令行模式下参数-p对于构建命令build会选择一个本地文件 (-remoting),或者从标准输出中读取。(在字符模式下,只允许定义一个文件参数)