跳转至

基于 Jenkinsfile 创建流水线

应用工作台流水线支持使用代码仓库中的 Jenkinsfile 创建流水线。

前提条件

  • 创建工作空间创建用户
  • 将该用户添加至该工作空间,并赋予 workspace editor 或更高权限。
  • 提供一个代码仓库,并且代码仓库的源码有一个 Jenkinsfile 文本文件。
  • 如果是私有仓库,需要事先创建仓库访问凭证

具体操作步骤如下:

  1. 在流水线列表页点击 创建流水线

    click-create

  2. 选择 基于代码库的 Jenkinsfile 创建流水线 ,点击 确定

    select-type

  3. 参考下方说明填写基本信息和代码仓库信息。

    • 名称:流水线的名称。同一个工作空间下流水线名称必须唯一。
    • 代码仓库地址:填写远程代码仓库的地址。
    • 凭证:对于私有仓库,需要提前创建仓库访问凭证并在此处选择该凭证。
    • 分支:基于哪个分支的代码构建流水线,默认为 master 分支。
    • 脚本路径:Jenkinsfile 文件在代码仓库中的绝对路径。

      pipeline01

  4. 参考下方说明填写构建设置和构建参数。

    • 删除过期流水线记录:删除之前的构建记录,以节省 Jenkins 使用的磁盘空间。

      • 构建记录保留期限:最多保留几天的构建记录,默认值为 7 天,即七天前的构建记录将被删除。
      • 构建记录最大数量:最多保留几条构建记录,默认值为 10, 即最多保留 10 条记录。超过 10 条记录时,时间最早的记录最先被删除。
      • 保留期限最大数量 这两条规则同时生效,只要满足其中之一就会开始删除记录。
    • 不允许并发构建:开启后,一次只能执行一个流水线构建任务。

    • 构建参数:在开始运行流水线时传入一个或多个构建参数。默认提供五种参数类型: 布尔值字符串多行文本选项密码上传文件
    • 添加构建参数后,运行流水线时需要为每个构建参数输入对应的取值。

      pipeline02

  5. 参考下方说明填写构建触发器。

    • 代码源触发:开启后,系统会根据 定时仓库扫描计划 定期扫描仓库代码中用于构建流水线的特定分支,如果有更新内容,则重新运行流水线。
    • 定时仓库扫描计划:输入 CRON 表达式定义扫描仓库的时间周期。输入表达式后下方会提示当前表达式的含义 。有关详细的表达式语法规则,可参考 Cron 时间表语法
    • 定时触发:定时触发构建流水线,无论代码仓库是否有更新,都会在规定时间重新运行流水线。

      pipeline04

  6. 完成创建。确认所有参数输入完成后,点击 确定 按钮,完成自定义流水线创建,自动返回流水线列表。点击列表右侧的 可以执行各项操作。

    pipeline05

评论