Projects---TeamCity之build构建参数说明

teamcity安装 docker BuildAgent teamcity中文文档_自动生成

 

 Build Steps

Add build step表示手动添加构建步骤

Auto-detect build steps主要是搜索 VCS 目录下的可识别的编译配置文件然后自动生成 build 步骤

Reorder build steps为了完成复杂的编译过程,往往需要多个步骤按顺序的执行。TeamCity 也提供了让用户可以重新排序 build 步骤的功能。

teamcity安装 docker BuildAgent teamcity中文文档_参数说明_02

 

 

上图为添加了两个 build 步骤后点击 “Reorder build steps” 按钮的场景。此时build步骤会被列出,您可以用鼠标拖拽进行重新排序。完成后点击 “Apply” 按钮就可以了。

 

我们主要介绍能支持复杂配置的手动配置 build 步骤的方式,所以请选择 “Add build step”。

 

以下是手动构建步骤相关参数说明:

Runner type:

  选择Command Line,它可以执行我们写的脚本,如windows中的bat脚本和linux中的xhell脚本。

Step name:

  您可以为此build步骤设置名称。注意这个参数不是必填选项,可填可不填。

Execute step:

此参数表示选择执行策略:  

If all previous steps finished successfully

前面所有 build 步骤必须都是成功的。
这种类型不会向 TeamCity Server 发送请求,只分析之前的 build 步骤有没有失败的。

Only if build status is successfully

只有在整个 build 处于成功的状态时才执行该步骤。
在开始运行该 build 步骤前,build agent 会向 TeamCity Server 请求整个 build 的状态,如果 build 的状态已经是失败,则跳过该步骤的执行。

Even if some of the previous steps failed

即便前面的 build 步骤有失败的也会执行。
不管之前的 build 步骤是否失败,也不管整个 build 的状态是否已失败,都执行该 build 步骤。

Always,even if build stop command was issued

总是执行,即便是收到了停止 build 的命令也要执行该 build 步骤。
即便是用户在前面的 build 步骤中取消了整个 build 的执行,这个 build 步骤也依然会被执行。但是在这个 build 步骤执行的过程中,如果您取消 build,就可以终止它的执行。

Working directory

teamcity安装 docker BuildAgent teamcity中文文档_Server_03

 

 对于要执行的命令来言,工作目录是非常重要的。如果设置不正确就会发生找不到文件的错误,所以一定要认真设置。您可以手动输入相对于 checkout 目录的路径,也可以通过右侧的工具进行选择。如果您希望工作目录就是 checkout 的目录,那么就不需要进行设置,留空就可以了。

Run这里有两种形式:

Custom script:

teamcity安装 docker BuildAgent teamcity中文文档_自动生成_04

 

 当选择 Custom script 类型时,我们可以直接在输入框中写脚本命令。这么做的好处是不用管理脚本文件了,因为 TeamCity 会把您写的脚本命令打包成脚本文件在 build 时执行。

Executable with parameters

如果是一个比较复杂的脚本,我们还是希望把它写成一个单独的脚本文件,这样更好维护管理。此时若是想要向单独的脚本文件传递参数又该怎么办呢?

teamcity安装 docker BuildAgent teamcity中文文档_参数说明_05

 


 选择 Executable with parameters 类型,可以执行脚本文件或者是可执行的二进制文件,并且可以传递命令行参数。上图中我们就把 checkout 目录传递给了 test.bat 脚本文件。