下面的插件通过与管道兼容的步骤提供可用的功能。有关如何将步骤集成到管道中的更多信息,请参见步骤部分的管道的语法页面。

有关其他此类插件的列表,请参阅管道步骤参考页面。

管道:节点和进程

蝙蝠: Windows批处理脚本

  • 脚本
    执行批处理脚本。允许多个行。当使用returnStdout标记,你可能希望在前面加上,以免命令本身包含在输出中。
    • 类型:字符串
  • 编码(可选)
    进程输出的编码。在…的情况下returnStdout,应用于此步骤的返回值;否则,控制如何将文本复制到构建日志中(对于标准错误总是如此)。如果未指定,则使用执行步骤所在节点的系统默认编码。如果预期进程输出可能包括非ascii字符,最好显式指定编码。例如,如果你知道一个给定的进程将生成UTF-8,但它将在一个使用不同系统编码的节点上运行(通常是Windows,因为每个Linux发行版长期以来都默认为UTF-8),你可以通过指定:编码:“utf - 8”
    • 类型:字符串
  • 标签(可选)
    要在管道步骤视图中显示的标签和步骤的蓝海详细信息,而不是步骤类型。因此,视图更有意义,而且是特定领域的,而不是技术性的。
    • 类型:字符串
  • returnStatus(可选)
    通常,如果脚本以非零状态代码退出,则会导致该步骤失败并出现异常。如果选中此选项,步骤的返回值将改为状态代码。例如,你可以将它与零进行比较。
    • 类型:布尔
  • returnStdout(可选)
    如果选中,任务的标准输出将作为步长值返回字符串,而不是打印到构建日志中。(如果有标准错误,仍然会打印到日志中。)你会经常想打电话.trim ()在结果中删除尾随的换行符。
    • 类型:布尔

节点:分配节点

在节点(通常是构建代理)上分配执行器,并在该代理上的工作空间上下文中运行进一步的代码。
  • 标签
    计算机名,标签名,或任何其他标签表达式,如linux & & 64位限制此步骤生成的位置。可留空,在这种情况下,任何可用的遗嘱执行人都会被带走。

    支持运营商

    支持以下操作符,按优先级降序排列:
    (表达)
    括号——用于显式定义表达式的结合性
    表达!
    不——否定;表达式的结果必须是真的
    & & b
    和- - - - - -这两个表达式a和b必须为真
    一个| | b
    或-要么表达式a或b可能为真
    a - b >
    “暗指”操作符-相当于!a || b。
    例如,windows -> x64可以被认为是“如果使用了windows代理,那么该代理。必须是64位”,同时仍然允许该块在任何代理上执行有Windows标签,不管他们是否也有x64标签
    < - > b
    “当且仅当”操作符——等价于a && b || !a && !b
    例如,windows <-> dc2可以被认为是“如果使用了windows代理,那么该代理。必须是在数据中心2,但如果使用非windows代理,则它不得在数据中心2”

    笔记

    • 所有的操作符都是左结合的,即a -> b -> c等价于(a -> b) -> c。
    • 如果标签或代理名称包含与操作符语法冲突的字符,则可以用引号包围。
      例如,“osx(10.11)”| |“Windows Server”。
    • 表达式可以不使用空格,但为了可读性,建议包含空格;必威国际有限公司Jenkins会在计算表达式时忽略空格。
    • 不支持使用通配符或正则表达式匹配标签或代理名称。
    • 空表达式的计算结果总是为真正的,匹配所有特工。

    例子

    此块只能在Jenkins内置节点上执行必威国际有限公司
    linux-machine-42
    此块只能在名称为linux-machine-42的代理上执行(或在碰巧有一个标签为linux-machine-42的任何机器上执行)
    windows & & jdk9
    此块只能在安装了Java开发工具包版本9的任何Windows代理上执行(假设安装了JDK 9的代理已被授予jdk9标签)
    Postgres && !vm && (linux || freebsd)
    这个块只能在Linux或FreeBSD代理上执行,只要它们是一个虚拟机,并且安装了PostgreSQL(假设每个代理都有适当的标签—特别是,为了使本例按预期工作,每个运行在虚拟机中的代理都必须有vm标签)
    • 类型:字符串

powershell: PowerShell脚本

  • 脚本
    执行PowerShell脚本。允许多个行。这个插件支持微软PowerShell 3+。
    • 类型:字符串
  • 编码(可选)
    进程输出的编码。在…的情况下returnStdout,应用于此步骤的返回值;否则,控制如何将文本复制到构建日志中(对于标准错误总是如此)。如果未指定,则使用执行步骤所在节点的系统默认编码。如果预期进程输出可能包括非ascii字符,最好显式指定编码。例如,如果你知道一个给定的进程将生成UTF-8,但它将在一个使用不同系统编码的节点上运行(通常是Windows,因为每个Linux发行版长期以来都默认为UTF-8),你可以通过指定:编码:“utf - 8”
    • 类型:字符串
  • 标签(可选)
    要在管道步骤视图中显示的标签和步骤的蓝海详细信息,而不是步骤类型。因此,视图更有意义,而且是特定领域的,而不是技术性的。
    • 类型:字符串
  • returnStatus(可选)
    通常,如果脚本以非零状态代码退出,则会导致该步骤失败并出现异常。如果选中此选项,步骤的返回值将改为状态代码。例如,你可以将它与零进行比较。
    • 类型:布尔
  • returnStdout(可选)
    如果选中,任务的标准输出将作为步长值返回字符串,而不是打印到构建日志中。(如果有标准错误,仍然会打印到日志中。)你会经常想打电话.trim ()在结果中删除尾随的换行符。
    • 类型:布尔

pwsh: PowerShell核心脚本

  • 脚本
    执行PowerShell脚本。允许多个行。这个插件支持PowerShell Core 6+。
    • 类型:字符串
  • 编码(可选)
    进程输出的编码。在…的情况下returnStdout,应用于此步骤的返回值;否则,控制如何将文本复制到构建日志中(对于标准错误总是如此)。如果未指定,则使用执行步骤所在节点的系统默认编码。如果预期进程输出可能包括非ascii字符,最好显式指定编码。例如,如果你知道一个给定的进程将生成UTF-8,但它将在一个使用不同系统编码的节点上运行(通常是Windows,因为每个Linux发行版长期以来都默认为UTF-8),你可以通过指定:编码:“utf - 8”
    • 类型:字符串
  • 标签(可选)
    要在管道步骤视图中显示的标签和步骤的蓝海详细信息,而不是步骤类型。因此,视图更有意义,而且是特定领域的,而不是技术性的。
    • 类型:字符串
  • returnStatus(可选)
    通常,如果脚本以非零状态代码退出,则会导致该步骤失败并出现异常。如果选中此选项,步骤的返回值将改为状态代码。例如,你可以将它与零进行比较。
    • 类型:布尔
  • returnStdout(可选)
    如果选中,任务的标准输出将作为步长值返回字符串,而不是打印到构建日志中。(如果有标准错误,仍然会打印到日志中。)你会经常想打电话.trim ()在结果中删除尾随的换行符。
    • 类型:布尔

上海: Shell脚本

  • 脚本

    通常在Unix节点上运行Bourne shell脚本。接受多行。

    可以使用解释器选择器,例如:#!/usr/bin/perl

    否则将运行系统默认shell,使用xeFlags(您可以指定组+ e和/或组+ x禁用)。

    • 类型:字符串
  • 编码(可选)
    进程输出的编码。在…的情况下returnStdout,应用于此步骤的返回值;否则,控制如何将文本复制到构建日志中(对于标准错误总是如此)。如果未指定,则使用执行步骤所在节点的系统默认编码。如果预期进程输出可能包括非ascii字符,最好显式指定编码。例如,如果你知道一个给定的进程将生成UTF-8,但它将在一个使用不同系统编码的节点上运行(通常是Windows,因为每个Linux发行版长期以来都默认为UTF-8),你可以通过指定:编码:“utf - 8”
    • 类型:字符串
  • 标签(可选)
    要在管道步骤视图中显示的标签和步骤的蓝海详细信息,而不是步骤类型。因此,视图更有意义,而且是特定领域的,而不是技术性的。
    • 类型:字符串
  • returnStatus(可选)
    通常,如果脚本以非零状态代码退出,则会导致该步骤失败并出现异常。如果选中此选项,步骤的返回值将改为状态代码。例如,你可以将它与零进行比较。
    • 类型:布尔
  • returnStdout(可选)
    如果选中,任务的标准输出将作为步长值返回字符串,而不是打印到构建日志中。(如果有标准错误,仍然会打印到日志中。)你会经常想打电话.trim ()在结果中删除尾随的换行符。
    • 类型:布尔

ws:分配工作

分配一个工作区。属性会自动为您分配工作区节点的一步。
  • dir

    属性将自动为您分配工作区节点步骤,或者您可以使用它获得一个备用工作区ws步骤,但默认情况下,位置是自动选择的。(类似AGENT_ROOT / workspace / JOB_NAME@2.)

    您可以在这里指定一个路径,工作区将被锁定。(该路径可以是相对于构建代理根目录的,也可以是绝对的。)

    如果并发构建要求相同的工作空间,则使用后缀为@2可能会被锁定。目前没有等待来锁定所请求的确切目录的选项;如果需要强制执行该行为,则可能失败(错误)当松材线虫病指示您获得了一个不同的目录,或者您可以通过其他方式强制执行构建的这一部分,例如舞台名称:‘…’,并发性:1

    如果您不关心锁定,只需使用dir步骤更改当前目录。

    • 类型:字符串

这个页面有用吗?

请通过这个提交你对这个页面的反馈快速形成

或者,如果您不希望完成快速表单,您可以简单地指出,如果您觉得这个页面有帮助?


看到现有的反馈在这里