更新时间:2025-08-13 GMT+08:00

新建流水线(图形化)

准备工作

约束与限制

  • GitLab流水线源当前仅支持“拉美-墨西哥城二”、“拉美-圣保罗一”、“亚太-新加坡”区域。
  • 新建流水线自定义模板。
    • 系统模板只能用来复制或生成流水线,不能编辑和删除。
    • 模板中无需配置流水线源。
    • 模板编排暂不支持配置阶段准入设置。

新建流水线

  1. 访问CodeArts Pipeline首页
  2. 单击“新建流水线”,进入“基本信息”页面,参考表1配置流水线基本信息。

    表1 流水线基本信息参数说明

    参数项

    说明

    取值样例

    名称

    流水线的名称,支持自定义名称。支持中文、大小写英文字母、数字、“-”、“_”,长度不超过128个字符。

    输入“pipeline01”。

    委托URN

    IAM的委托唯一标识。配置后,执行流水线中任务时使用委托身份和权限访问其他云服务,否则使用运行人的身份和权限。

    -

    所属项目

    流水线归属的项目。

    • 从流水线服务首页入口新建流水线,请根据实际需要选择已创建的项目。
    • 从项目下流水线入口新建流水线,所属项目默认为当前项目,不可更改。

    默认选择的项目,此处默认为“project01”。

    流水线源

    流水线关联的源类型。

    • CodeArts代码源

      Repo:提供企业代码托管的全方位服务,为软件开发者提供基于Git的在线代码托管服务。

    • 第三方代码源
      • Github:连接Github账号后可以获取该账号下的仓库、分支等信息。
      • GitLab:连接GitLab账号后可以获取该账号下的仓库、分支等信息。
      • Bitbucket:连接Bitbucket账号后可以获取该账号下的仓库、分支等信息。
      • 通用Git:连接第三方通用Git仓库后可以获取该账号下的仓库、分支等信息。
      • 其他项目Repo:从其他项目的代码托管中拉取代码,请选择已有的项目、该项目下已经创建的代码仓以及默认分支。
    • 制品源

      SWR:使用华为云容器镜像作为流水线源运行流水线,并生成制品名称、制品下载地址和制品版本号系统参数,供需要的任务插件使用。

    说明:
    • 如果用户新建的流水线任务不需要关联代码仓,也可以选择“暂不选择”,不关联代码仓时,如果添加了需要关联代码仓的任务,执行时会提示错误,具体问题请参考常见问题

    选择“Repo”。

    创建方式

    创建流水线的方式。关联本项目Repo代码源时,可以选择图形化编排和YAML化编排两种方式。

    • 图形化编排:以图形化界面方式轻松配置流水线,清晰展示任务串并行关系。
    • YAML化编排:以代码化方式编排流水线,支持语法自动补齐和校验,方便多流水线批量配置。请参考新建流水线(YAML化)

    选择“图形化编排”。

    服务扩展点

    关联第三方代码源时,需通过服务扩展点实现与对应仓库的连接。可选择准备工作中提前创建的扩展点,也可单击“新建服务扩展点”进行创建,具体操作请参考新建CodeArts服务扩展点

    -

    Workspace

    Bitbucket账号下的工作空间。

    -

    代码仓

    流水线关联的代码仓库,可选择提前新建好的仓库,也可单击“新建仓库”进行创建,新建仓库可参考新建代码仓库

    选择“Repo01”。

    默认分支

    仓库默认分支,手工或定时执行流水线时默认使用的分支。

    选择“master”。

    Repo HTTPS授权

    该参数为非必填。关联Repo代码源时,可配置授权扩展点以提升代码库操作权限,当前主要用于流水线服务的微服务变更功能模块及相关插件。可选择准备工作中提前创建的扩展点,也可单击“新建授权”进行创建,具体操作请参考。

    -

    别名

    该参数为非必填。仓库别名,设置别名后可基于别名生成仓库对应的系统参数,如:“别名_REPOSITORY_NAME”,表示仓库名称。生成的参数可在参数设置页面查看,并在流水线中通过“${参数名}”进行引用。

    仅支持输入大小写英文字母、数字、“_”,长度不超过128个字符。

    -

    描述

    该参数为非必填。对流水线的描述,长度不超过1024个字符。

    -

    组织

    当流水线关联的源类型为SWR流水线源时,选择SWR组织。组织用于隔离镜像,每个组织可对应一个公司或部门,将其拥有的镜像集中在该组织下。

    -

    镜像名

    当流水线关联的源类型为SWR流水线源时,选择组织下的镜像。

    -

    指定版本

    当流水线关联的源类型为SWR流水线源时,选择镜像的版本。

    -

    制品源别名

    当流水线关联的源类型为SWR流水线源时,需设置制品源别名,设置别名后可基于别名生成对应的系统参数,如:“别名_ARTIFACT_NAME”,表示制品名称。生成的参数可在参数设置页面查看,并在流水线中通过“${参数名}”进行引用。

    仅支持输入中文、大小写英文字母、数字、“-”、“_”、“.”,长度不超过128个字符。

    -

  3. 单击“下一步”,进入“模板选择”页面。此处以“空模板”为例创建。

    • 选择系统模板或自定义模板,即在模板基础上快速新建流水线,并自动生成模板预置的任务,模板来源请参考管理流水线模板
    • 选择“空模板”,即不使用模板,新建空任务流水线。

  4. 选择完模板,单击“确定”,完成流水线的创建。

    页面自动进入流水线“任务编排”页面,您可以继续配置流水线,也可以单击“取消”返回流水线列表。

    图1 任务编排

流水线模板

流水线服务预置了一系列常用系统模板,同时支持创建自定义模板,帮助您基于模板快速创建持续交付流水线,在企业内完成复用和发布流程标准化。

表2 流水线的常用系统模板

模板名称

模板解释

Maven构建

  • 该模板使用Maven模板进行构建。
  • 编程语言:JAVA。
  • 编译工具:Maven3.5.3、JDK1.8。

Python构建

  • 该模板使用SetupTool模板进行构建。
  • 编程语言:Python。
  • 编译工具:python3.6。

Go构建

  • 该模板使用Go模板进行构建。
  • 编程语言:Go。
  • 编译工具:go-1.10.3。

SpringBoot编译部署

  • 该模板使用Maven模板进行构建。
  • 使用语言:JAVA。
  • 编译工具:Maven3.5.3、JDK1.8。

NodeJS构建

  • 该模板使用NodeJS模板进行构建。
  • 编程语言:JAVASCRIPT。
  • 编译工具:nodejs12.7.0。

PHP构建

  • 该模板使用PHP模板进行构建。
  • 编程语言:PHP。
  • 编译工具:php7.3.3。
  • 流水线模板列表页入口
    • 首页入口:进入流水线服务首页,默认展示“流水线列表”页面,单击“流水线模板”,进入“流水线模板”页面。
      图2 流水线模板
    • 项目入口:进入项目下流水线页面,单击“模板”,进入“流水线模板”页面。
      图3 流水线模板
      流水线模板列表操作项说明如下:
      表3 模板列表操作项

      操作项

      说明

      生成流水线。单击后进入“新建流水线”页面,可快速生成对应模板的流水线。

      收藏模板。单击可收藏模板,收藏后图标变为,再次单击可以取消收藏。

      • 单击后选择“编辑”,进入“任务编排”页面,可编辑模板。
      • 单击后选择“复制”,进入“任务编排”页面,可复制模板。
      • 单击后选择“删除”,弹出“删除模板”弹窗,可根据提示删除模板。
  • 新建流水线自定义模板
    1. 进入流水线模板列表页
    2. 单击“新建流水线模板”,进入“任务编排”页面。
    3. 根据需要配置模板基本信息、任务编排、参数设置等。
      • 基本信息:可编辑模板的名称(必填)、语言(支持Java、Python、Node.js、Go、.Net、C++、PHP、ArkTs,默认选择“无”)、模板描述信息。
        图4 基本信息
      • 任务编排:流水线模板支持添加所有的插件,包括官方插件、第三方插件和自定义插件,将构建、代码检查、部署、接口测试等任务配置在模板中后,通过模板创建流水线时,会同步创建相应类型的任务。
      • 参数设置:可根据需要为模板添加参数,流水线模板参数包括自定义参数和系统预定义参数,自定义参数类型包括字符串类型、自增长类型和枚举类型,配置方法请参见配置流水线自定义参数
    4. 单击“保存”,弹出“创建模板成功”提示,完成流水线模板的创建。

操作视频

本视频介绍如何创建并执行流水线任务。