流水线设置
流水线设置为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触发,请按照以下步骤设置。
登录Git代码仓库所在的服务器。
(可选,代码仓库中无hooks文件夹时需要)创建hooks文件夹。
执行以下命令,在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类型的仓库时,请按照以下步骤设置。
登录SVN代码仓库所在的服务器。
(可选,代码仓库中无hooks文件夹时需要)创建hooks文件夹。
执行以下命令,在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个小时,可自行修改。