流水线设置

<< 单击以显示目录 >>

导航:  用户指南 > 项目用户操作指南 > 项目管理 > CI/CD操作指南 > CI/CD配置说明 >

流水线设置

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

流水线设置

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

构建完成后清空工作空间

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

环境变量

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

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

流水线环境变量

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

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

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

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

cicd7

 

全局配置

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

触发条件

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

webhook触发

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

GitLab触发设置

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

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

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

cicd3

 

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} 构建参数中。

镜像触发

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

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

cicd4

 

流水线触发

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

cicd5

 

定时触发

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

cicd6

可设置为如下时间规则:

指定执行时间

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

每隔一段时间执行

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

每天定时执行

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

工作日定时执行

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

自定义crontab规则

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

构建通知

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

cicd8

 

超时设置

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

cicd_time

 

说明

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