跳转至

基于 Jenkinsfile 创建流水线

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

前提条件

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

具体操作步骤如下:

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

    click-create

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

    select-type

  3. 填写各项参数

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

    pipeline01

    • 构建设置

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

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

    pipeline02

    • 构建参数:在开始运行流水线时传入一个或多个构建参数。默认提供五种参数类型: 布尔值字符串多行文本选项密码上传文件
    • 构建触发器:

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

    pipeline04

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

    pipeline05

评论