title: 流程配置详情 - CODING 帮助中心
pageTitle: 流程配置详情
pagePrevTitle: 文本编辑器
pagePrev: ci/process/text.html
pageNextTitle: 图形化编辑器
pageNext: ci/process/visual-editor.html
alias: process/detail.html
本文主要用于辅助编写构建过程，以及说明各项步骤的参数详情。
代码仓库
Git
用以检出当前项目的 Git 仓库源代码。本指令是 checkouk 指令的一个简易写法。
参数列表：
Git 地址
url: 类型 string分支
branch: 类型 string变更日志
changelog: 类型 string身份认证 ID
credentialsId: 类型 stringPoll
poll: 类型 boolean从版本控制检出
通用的检出 SCM(Git，SVN) 代码。
这个步骤返回一个 Map 格式的内容。例如如果你用 Git，你可以这样：
def scmVars = checkout scmdef commitHash = scmVars.GIT_COMMIT// ordef commitHash = checkout(scm).GIT_COMMIT
参数 scm 是一个可配置 SCM 类型的的对象，目前支持的有如下：
GitSCM 示例写法：
checkout([$class: 'GitSCM', branches: [[name: env.GIT_BUILD_REF]],userRemoteConfigs: [[url: env.GIT_REPO_URL]]])
userRemoteConfigs 参数列表：
url: 类型 stringname: 类型 string 远程仓库名称，例如 originrefspec: 类型 string 关于 refspec 的详细说明，请查看这里: Git 内部原理 - 引用规格 。branches: 类型 对象数组, 可选changelog: 类型 boolean, 可选credentialsId: 类型 string, 可选doGenerateSubmoduleConfigurations: 类型 boolean, 可选submoduleCfg: 类型数组，可选SubversionSCM 从 SVN 服务器检出代码。 示例写法：
checkout([$class: 'SubversionSCM', remote: 'http://sv-server/repository/trunk']]])
参数列表:
locations: 类型对象数组remote: 类型 stringcredentialsId: 类型 stringlocal: 类型 string 指明一个本地目录（相对于 workspace）作为检出代码的位置depthOption: 类型 string 对应 --depth 的内容。默认值是无穷大, 点击这里了解更多信息 。ignoreExternalsOption: 类型 boolean构建过程
子节点
参数列表：
label: 类型 string 环境标签名称，例如 java-8收集构建物
把构建结果（例如 jar，war，apk 等）收集起来。请注意，这里收集的构建产物会跟随这个构建历史一起保存和删除，这里只是一个临时的保存空间，更建议用户使用”构建物管理“来进行构建结果的版本化管理。
参数列表:
artifacts: 类型 string 可以使用通配符 * 来指定要收集的文件的路径模式，符合 Apache Ant 的路径规则, 只允许指定工作空间内的文件allowEmptyArchive: 类型 boolean，可选 通常情况下，本指令在找不到符合收集模式的文件时会导致构建失败。这个选项如果设置为 true ，那么当没有构建产物的时候，构建过程只会发出一个警告，不会导致失败caseSensitive: 类型 boolean, 可选 默认对文件路径规则的匹配是大小写敏感的，如果设置为 false，则不区分大小写defaultExcludes: 类型 boolean, 可选excludes: 类型 boolean, 可选 在设定的路径模式内可以排除一部分文件，同样支持 Apache Ant 的路径规则 。fingerprint: 类型 boolean, 可选 收集的时候同时计算文件的 hash 信息onlyIfSuccessful: 类型 boolean, 可选 只有当构建成功的时候才收集执行 Shell 脚本
执行一段 Shell 脚本。
示例：
pipeline {agent anystages {stage('Example') {steps {echo 'Hello World'sh 'ls -al'}}}}
收集 JUnit 测试报告
收集 JUnit 和 TestNG 的测试报告（xml 格式），你可以指定收集哪些 xml 文件，例如
**/build/test-reports/*.xml. 需要注意的是不要把那些不是报告文件的 xml 包含在内了，你可以用逗号隔开写多个规则。参数列表：
testResults: 类型 stringallowEmptyResults: 类型 boolean，可选，允许测试报告文件不存在或为空。keepLongStdio: 类型 boolean，可选，所有测试日志都会保留，即便是那些通过的测试用例。其他
变更目录子步骤
变更目录子步骤。可以在 dir 块内填充若干子步骤，这些子步骤将会在指定的路径目录内执行。
参数列表：
path: 类型 string睡眠
即暂停一段时间，直至所设定的截止时间。与 Unix 的
sleep xxx 类似。参数列表:
time: 类型 intunit: 只能在 NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS 中选择一个。错误信号
发送一个错误信号，往往用在需要根据条件终止部分执行过程的时候。你也可以使用 throw new Excepiton(),但使用 error 步骤可以避免打印过长的异常栈。
参数列表：
message: 类型 string当前目录
把当前目录路径以字符串类型作为返回结果。
参数列表：
tmp: 类型 boolean 可选参数，如果选择了，则返回一个跟工作空间关联的临时目录。通常用于在不想污染工作空间目录，又想存放一些临时文件之类的场景。写文件
把指定内容写入文件。
参数列表:
file: 类型 stringtext: 类型 stringencoding: 类型 string 文件的编码，如果留空将会根据当前运行环境平台默认编码处理，如果遇到 Binary 文件，则会自动被以 Base64 编码后的结果返回读文件
从相对路径读取文件，并把文件内容作为字符串返回。
参数列表:
file: 类型 string 相对路径地址（相对于工作空间目录）encoding: 类型 string 文件的编码，如果留空将会根据当前运行环境平台默认编码处理，如果遇到 Binary 文件，则会自动被以 Base64 编码后的结果返回
重试子步骤
重试一个指定的块直至达到设定的最多重试次数。如果在执行过程中正常结束，则不再重试，如果执行过程中出现异常，则会不断重试直至达到指定的最大重试次数，如果最后一次尝试出现异常，则构建过程会被终止。
参数列表:
count 类型 int限时子步骤
限定时间执行块内的过程。如果时间到了，将会抛出一个异常
org.jenkinsci.plugins.workflow.steps.FlowInterruptedException. 单位参数是可选的，默认是分钟.参数列表
time: 类型 intactivity: 类型 boolean，以日志没有新的内容来计时，而不是以绝对执行时间来计时unit: 只能在 NANOSECONDS, MICROSECONDS, MILLISECONDS, SECONDS, MINUTES, HOURS, DAYS 中选择一个。捕获错误子步骤
这里指定的子步骤中的错误将会被捕获。
计时子步骤
这里指定的子步骤的执行时间将会以 Unix 时间戳的形式被记录。
循环子步骤
这里指定的子步骤将会被循环执行指定次数。
条件循环子步骤
这里指定的子步骤将会被循环执行，直到子步骤的结果返回 true。
打印消息
在日志中打印消息。
参数列表：
message: 类型 string执行任意的 Pipeline 脚本
添加此步骤可以执行任意的 Pipeline 脚本。
执行 Groovy 源文件
构建过程将在此位置执行 Groovy 源文件。
示例：
pipeline {agent anystages {stage('Example') {steps {echo 'Hello World'load 'test.groovy'}}}}
执行 Yarn 审计
此步骤在指定的目录里执行 yarn audit，并且可以在持续集成结果页面看到对 yarn 依赖审查的漏洞情况。
参数列表：
directory：类型 string，可选。 填写 yarn.lock 所在目录，默认在项目根目录执行。collectResult：类型 boolean，可选。 收集 Yarn Audit 报告。执行 Npm 审计
此步骤在指定的目录里执行 npm audit，并且可以在持续集成结果页面看到对 npm 依赖审查的漏洞情况。
参数列表：
directory：类型 string，可选。 填写 package.json 所在目录，默认在项目根目录执行。collectResult：类型 boolean，可选。 收集 Npm Audit 报告。合并合并请求
合并代码。你可以在此步骤合并一个指定的合并请求。
参数列表：
token：类型 string。 项目令牌。depot：类型 string。 仓库名称。mrResourceId：类型 string。 指定资源 ID。commitMessage：类型 string。 合并提交信息模板。deleteSourceBranch：类型 boolean，可选。 删除源分支。fastForward：类型 boolean，可选。 尝试 Fast-Forward 模式合并。评论合并请求
评论合并请求。你可以在此步骤评论一个指定的合并请求。
参数列表：
token：类型 string。 项目令牌。depot：类型 string。 仓库名称。mrResourceId：类型 string。 指定资源 ID。commentContent：类型 string。 评论内容模板。==== 2020/08/13 ====
是
否
本页内容是否解决了您的问题？