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