基于 Jenkinsfile 创建流水线¶
应用工作台流水线支持使用代码仓库中的 Jenkinsfile 创建流水线。
前提条件
- 创建工作空间、创建用户。
- 将该用户添加至该工作空间,并赋予 workspace editor 或更高权限。
- 提供一个代码仓库,并且代码仓库的源码有一个 Jenkinsfile 文本文件。
- 如果是私有仓库,需要事先创建仓库访问凭证。
具体操作步骤如下:
-
在流水线列表页点击 创建流水线 。
-
选择 基于代码库的 Jenkinsfile 创建流水线 ,点击 确定 。
-
参考下方说明填写基本信息和代码仓库信息。
- 名称:流水线的名称。同一个工作空间下流水线名称必须唯一。
- 代码仓库地址:填写远程代码仓库的地址。
- 凭证:对于私有仓库,需要提前创建仓库访问凭证并在此处选择该凭证。
- 分支:基于哪个分支的代码构建流水线,默认为 master 分支。
-
脚本路径:Jenkinsfile 文件在代码仓库中的绝对路径。
-
参考下方说明填写构建设置和构建参数。
-
删除过期流水线记录:删除之前的构建记录,以节省 Jenkins 使用的磁盘空间。
- 构建记录保留期限:最多保留几天的构建记录,默认值为 7 天,即七天前的构建记录将被删除。
- 构建记录最大数量:最多保留几条构建记录,默认值为 10, 即最多保留 10 条记录。超过 10 条记录时,时间最早的记录最先被删除。
- 保留期限 和 最大数量 这两条规则同时生效,只要满足其中之一就会开始删除记录。
-
不允许并发构建:开启后,一次只能执行一个流水线构建任务。
- 构建参数:在开始运行流水线时传入一个或多个构建参数。默认提供五种参数类型: 布尔值 、 字符串 、 多行文本 、 选项 、 密码 、 上传文件 。
-
添加构建参数后,运行流水线时需要为每个构建参数输入对应的取值。
-
-
参考下方说明填写构建触发器。
- 代码源触发:开启后,系统会根据 定时仓库扫描计划 定期扫描仓库代码中用于构建流水线的特定分支,如果有更新内容,则重新运行流水线。
- 定时仓库扫描计划:输入 CRON 表达式定义扫描仓库的时间周期。输入表达式后下方会提示当前表达式的含义 。有关详细的表达式语法规则,可参考 Cron 时间表语法。
-
定时触发:定时触发构建流水线,无论代码仓库是否有更新,都会在规定时间重新运行流水线。
-
完成创建。确认所有参数输入完成后,点击 确定 按钮,完成自定义流水线创建,自动返回流水线列表。点击列表右侧的 ︙ 可以执行各项操作。