流水线设置

流水线设置为CI/CD工程的全局设置，包括环境变量、参数设置、全局配置、触发条件、构建完成后清空工作空间和邮件通知。

构建完成后清空工作空间

可设置构建完成后清空工作空间，防止构建残留数据的影响，保证每次构建的环境一致。默认不启用。

环境变量

可指定流水线执行过程中的环境变量，为key-value形式。一个流水线可使用多个环境变量，并且键名必须唯一。

设置了流水线的环境变量后，该环境变量应用于流水线中的所有阶段和步骤。

流水线环境变量

可定义流水线执行过程中所使用的参数，为key-value形式，其中key代表参数名，value为该参数的默认值。流水线的参数可设置多个，并且参数名必须唯一。

如果CI/CD工程与代码仓库相关联，则在流水线中自动增加参数BRANCH_NAME，默认值为设置代码仓库分支时的值。

设置了流水线的参数后，构建时可设置该参数为不同的值，可通过参数定义不同的构建。

参数与环境变量的不同之处在于环境变量为固定值，而参数可在每次构建时给定本次构建的所需值。

• 全局配置

  全局配置为一组环境变量，由域管理员设置，设置后便可在创建CI/CD项目时选取并使用。

触发条件

通过设置触发条件，可设置CI/CD工程在满足某种条件时自动构建。支持webhook触发构建、镜像上传触发构建、定时触发和流水线触发。设置了触发条件后，当触发条件满足时，如果该流水线的状态为非等待中，则流水线触发构建。

webhook触发

只有CI/CD工程设置了代码仓库关联时才能设置webhook触发。

• GitLab触发设置

  可设置是否启用webhook触发，启用后请设置触发代码分支，多个分支名称可以用空格隔开，如：master release1 release2。

  此处设置的分支名称是CI/CD任务触发条件的参数，即只有此处设置的分支上有代码更新时，CI/CD任务才会被触发。触发条件的配置方法请在接下来的流水线创建过程中查看。触发构建的代码分支名称将保存在流水线的 ${params.BRANCH_NAME} 构建参数中。

  开启创建标签时触发，在输入框内输入标签进行匹配，代码分支打Tag的事件来触发流水线自动执行。

  

• Git触发设置

  当CI/CD工程关联的代码仓库为Git类型的仓库时，如需启用webhook触发，请按照以下步骤设置。

  1. 登录Git代码仓库所在的服务器。

  2. （可选，代码仓库中无hooks文件夹时需要）创建hooks文件夹。

  3. 执行以下命令，在hooks文件夹中创建post-recerve文件并为其添加可执行权限。

     touch post-receive

     chmod +x post-receive

  4. 单击管理页面的复制代码，并将内容复制至文件post-receive中。

  5. 设置仓库分支。

     此处设置的分支名称是CI/CD任务触发条件的参数，即只有此处设置的分支上有代码更新时，CI/CD任务才会被触发。触发条件的配置方法请在接下来的流水线创建过程中查看。触发构建的代码分支名称将保存在流水线的 ${params.BRANCH_NAME} 构建参数中。

• SVN触发设置

  当CI/CD工程关联的代码仓库为SVN类型的仓库时，请按照以下步骤设置。

  1. 登录SVN代码仓库所在的服务器。

  2. （可选，代码仓库中无hooks文件夹时需要）创建hooks文件夹。

  3. 执行以下命令，在hooks文件夹中创建post-commit文件并为其添加可执行权限。

     touch post-commit

     chmod +x post-commit

  4. 单击管理页面的复制代码，并将内容复制至文件post-commit中。

  5. 设置仓库分支。

     设置希望被构建的代码仓库分支文件夹名称，多个文件夹名称可以用空格隔开，如：trunk branches/release1 tags/version1。如果代码仓库无分支文件夹，此项设置可以为空。此处设置的文件夹名称是CI/CD任务触发条件的参数，即只有此处设置的文件夹里有代码更新时，CI/CD任务才会被触发。触发条件的配置方法请在接下来的流水线创建过程中查看。触发构建的文件夹名称将保存在流水线的 ${params.BRANCH_NAME} 构建参数中。

镜像触发

镜像触发默认为关闭状态，单击启用并选择触发流水线执行的镜像和标签。其中标签为非必填项，并且支持通配符，新上传的镜像标签与通配符匹配时触发构建。如果为空则匹配所有标签，即有新镜像上传后触发构建。

设置了镜像触发后，当有符合条件的镜像上传至该项目下时，流水线触发构建。

流水线触发

设置了流水线触发后，当该项目中某个流水线构建完成后触发该流水线。默认为不启用流水线触发。

定时触发

可指定流水线触发的时间或者时间规则。默认不启用定时触发规则。

可设置为如下时间规则：

• 指定执行时间

  设置流水线的固定触发时间点，时间点参数为月、日、时、分，在未来一年内的该时间点触发流水线构建。

• 每隔一段时间执行

  设置流水线经过固定的时间间隔后，自动触发执行。

• 每天定时执行

  设置了时间点后，每天的该时间点自动触发流水线构建。

• 工作日定时执行

  设置工作日和时间点后，设定的时间点自动触发流水线构建。

• 自定义crontab规则

  输入符合规则的contab语法来自定义触发流水线构建的时间规则。

  

构建通知

可设置发送通知的条件，可选择【总是发送】、【失败时发送】、【成功时发送】，发送通知条件来通知已选的通知组中的项目相关人员。默认不启用。

使用邮件通知功能前，请提前设置好通知组，并且确保已设置邮箱服务器。

超时设置

流水线执行超时时间设置，默认1个小时，可自行修改。