赵走x博客 - 开发者的网上家园

21、pipeline内置基础步骤：其他步骤

资源编号:76395 Jenkins 2.x 实战指南微服务热度：85

其他步骤

### error：主动报错，中止当前pipeline

error 步骤的执行类似于抛出一个异常。它只有一个必需参数：message。通常省略参数：error（"there's an error"）。

### tool：使用预定义的工具

如果在Global Tool Configuration（全局工具配置）中配置了工具，如图3-4所示，比如配置了Docker，那么可以通过tool步骤得到工具路径。

![bs64](https://img.handsomemark.com/2020/03/03/fc5fd698-5d22-11ea-b7ba-0242ac120003.png)
图3-4 Docker installations

![bs64](https://img.handsomemark.com/2020/03/03/0949a4c4-5d23-11ea-bb2b-0242ac120003.png)
tool步骤支持的参数有：

* name：工具名称。

* type（可选）：工具类型，指该工具安装类的全路径类名。

每个插件的type值都不一样，而且绝大多数插件的文档根本不写type值。除了到该插件的源码中查找，还有一种方法可以让我们快速找到type值，就是前往Jenkins pipeline代码片段生成器中生成该tool步骤的代码即可，如图3-5所示。

![bs64](https://img.handsomemark.com/2020/03/03/514ae936-5d23-11ea-b7af-0242ac120003.png)

图3-5 生成tool步骤代码

### timeout：代码块超时时间

为timeout步骤闭包内运行的代码设置超时时间限制。如果超时，将抛出一个org.jenkinsci.plugins.workflow.steps.FlowInterruptedException异常。timeout步骤支持如下参数：

*  time：整型，超时时间。
*  unit（可选）：时间单位，支持的值有NANOSECONDS、MICROSECONDS、MILLISECONDS、SECONDS、MINUTES（默认）、HOURS、DAYS。

*  activity（可选）：布尔类型，如果值为true，则只有当日志没有活动后，才真正算作超时。

### waitUntil：等待条件满足

不断重复waitUntil块内的代码，直到条件为true。waitUntil不负责处理块内代码的异常，遇到异常时直接向外抛出。waitUntil步骤最好与timeout步骤共同使用，避免死循环。示例如下：

![bs64](https://img.handsomemark.com/2020/03/03/9990a12c-5d23-11ea-a70b-0242ac120003.png)

### retry：重复执行块

执行N 次闭包内的脚本。如果其中某次执行抛出异常，则只中止本次执行，并不会中止整个retry的执行。同时，在执行retry的过程中，用户是无法中止pipeline的。

![bs64](https://img.handsomemark.com/2020/03/03/aee4dce6-5d23-11ea-9731-0242ac120003.png)

### sleep：让pipeline休眠一段时间

sleep步骤可用于简单地暂停pipeline，其支持的参数有：

*  time：整型，休眠时间。

* unit（可选）：时间单位，支持的值有NANOSECONDS、MICROSECONDS、MILLISECONDS、SECONDS（默认）、MINUTES、HOURS、DAYS。

示例如下：

![bs64](https://img.handsomemark.com/2020/03/03/bcad67ee-5d23-11ea-9c62-0242ac120003.png)