--- hide: - toc --- # 创建自定义流水线 应用工作台流水线支持自定义创建,通过该方式创建的流水线,您可对流水线进行可视化编排。 ## 前提条件 - [创建工作空间](../../../../ghippo/user-guide/workspace/workspace.md)、[创建用户](../../../../ghippo/user-guide/access-control/user.md)。 - 将该用户添加至该工作空间,并赋予 __workspace editor__ 或更高权限。 ## 操作步骤 具体操作步骤如下: 1. 在流水线列表页点击 __创建流水线__ 。 ![创建流水线](../../../images/pipe-cust01.jpg) 2. 在弹出的对话框中,选择 __自定义创建流水线__ ,点击 __确定__ 。 ![自定义创建流水线](../../../images/pipe-cust02.jpg) 3. 参考下列说明填写 __基本信息__ 、 __构建设置__ 、 __构建参数__ 。 - 名称:流水线的名称。同一个工作空间下流水线名称必须唯一。 - 删除过期流水线记录:删除之前的构建记录,以节省 Jenkins 使用的磁盘空间。 - 构建记录保留期限:最多保留几天的构建记录,默认值为 7 天,即七天前的构建记录将被删除。 - 构建记录最大数量:最多保留几条构建记录,默认值为 10, 即最多保留 10 条记录。超过 10 条记录时,时间最早的记录最先被删除。 - __保留期限__ 和 __最大数量__ 这两条规则同时生效,只要满足其中之一就会开始删除记录。 - 不允许并发构建:开启后,一次只能执行一个流水线构建任务。 - 构建参数:在开始运行流水线时传入一个或多个构建参数。默认提供五种参数类型: __布尔值__ 、 __字符串__ 、 __多行文本__ 、 __选项__ 、 __密码__ 、 __上传文件__ 。 - 添加构建参数后,运行流水线时需要为每个构建参数输入对应的取值。 ![构建设置](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/custom02.png) 4. 参考下列说明填写触发器参数。 - 代码源触发:开启后,系统会根据 __定时仓库扫描计划__ 定期扫描仓库代码中用于构建流水线的特定分支,如果有更新内容,则重新运行流水线。 - 定时扫描仓库:输入 CRON 表达式定义扫描仓库的时间周期。__输入表达式后下方会提示当前表达式的含义__ 。有关详细的表达式语法规则,可参考 [Cron 时间表语法](https://kubernetes.io/zh-cn/docs/concepts/workloads/controllers/cron-jobs/#cron-schedule-syntax)。 - 定时触发:定时触发构建流水线,无论代码仓库是否有更新,都会在规定时间重新运行流水线。 ![配置触发器](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/custom03.png) 5. 完成创建。确认所有参数输入完成后,点击 __确定__ 按钮,完成自定义流水线创建,自动返回流水线列表。点击列表右侧的 __┇__ 可以执行各项操作。 ![完成创建](https://docs.daocloud.io/daocloud-docs-images/docs/amamba/images/pipeline05.png) !!! warning - 自定义流水线创建之后,需要手动定义流水线的各个阶段(即编辑流水线),然后才能运行流水线。如果定义流程就直接运行流水线,会出现 __构建失败__ 的错误。 - 如果[基于模板创建流水线](template.md)或[基于 Jenkinsfile 创建流水线](jenkins.md),则可以直接运行,无需手动编辑流水线。 下一步:[编辑流水线](../edit.md){ .md-button .md-button--primary }