新建流水线（图形化）

准备工作

• 新建项目。
• 使用CodeArts Repo代码源：新建代码仓库。
• 新建CodeArts服务扩展点：用于提升CodeArts Repo代码库的操作权限，或连接非CodeArts的第三方代码库。

新建流水线

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

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

   参数项	说明
   名称	流水线的名称，自定义。支持中文、大小写英文字母、数字、“-”、“_”，长度不超过128个字符。
   所属项目	流水线归属项目。 从流水线服务首页入口新建流水线，请根据实际需要选择已创建的项目。 从项目下流水线入口新建流水线，所属项目默认为当前项目，不可更改。
   代码源	流水线关联的代码源类型： CodeArts Repo代码源 Repo：提供企业代码托管的全方位服务，为软件开发者提供基于Git的在线代码托管服务。 非CodeArts的第三方代码源 GitLab：连接GitLab账号后可以获取该账号下的仓库、分支等信息。 通用Git：连接第三方通用Git仓库后可以获取该账号下的仓库、分支等信息。 说明： GitLab流水线源当前仅支持“拉美-墨西哥城二”、“拉美-圣保罗一”、“亚太-新加坡”区域。 如果用户新建的流水线任务不需要关联代码仓，也可以选择“暂不选择”，不关联代码仓时，如果添加了需要关联代码仓的任务，执行时会提示错误，具体问题请参考常见问题。
   服务扩展点	关联非CodeArts的第三方代码源时，需通过服务扩展点实现与对应仓库的连接。可选择准备工作中提前创建的扩展点，也可单击“新建服务扩展点”进行创建，具体操作请参考新建CodeArts服务扩展点。
   代码仓	流水线关联的代码仓库。
   默认分支	仓库默认分支，手工或定时执行流水线时默认使用的分支。
   Repo HTTPS授权	关联Repo代码源时，可配置授权扩展点以提升代码库操作权限，当前主要用于流水线服务的微服务变更功能模块及其相关插件。可选择准备工作中提前创建的扩展点，也可单击“新建授权”进行创建，具体操作请参考新建CodeArts服务扩展点。
   别名	仓库别名，设置别名后可基于别名生成仓库对应的系统参数，如：“别名_REPOSITORY_NAME”，表示仓库名称。生成的参数可在参数设置页面查看，并在流水线中通过“${参数名}”进行引用。
   描述	不超过1024个字符。

3. 配置完基本信息，单击“下一步”，进入“选择模板”页面。
   • 您可以选择系统模板或自定义模板，在模板基础上快速新建流水线，并自动生成模板预置的任务，模板来源请参考管理流水线模板。
   • 也可以选择“空模板”，即不使用模板，新建空任务流水线。

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

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

管理流水线模板

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

• 进入流水线模板列表
  • 首页入口：进入流水线服务首页，默认展示“流水线列表”页，单击“流水线模板”，进入“流水线模板”页。
  • 项目入口：进入项目下流水线，单击右上角“更多 > 模板管理”，进入“流水线模板”页。

  模板列表操作项说明如下：

  表2 模板列表操作项

  操作项	说明
  	生成流水线。单击后进入“新建流水线”页面，可快速生成对应模板的流水线。
  	收藏模板。单击可收藏模板，收藏后图标变为，再单击可以取消收藏。
  	单击后选择“编辑”，进入“任务编排”页面，可编辑模板。 单击后选择“复制”，进入“任务编排”页面，可复制模板。 单击后选择“删除”，可根据提示删除模板。 说明： 系统模板只能用来复制或生成流水线，不能编辑和删除。

• 新建流水线自定义模板
  1. 进入流水线模板列表页。
  2. 单击“新建流水线模板”，进入“任务编排”页。
  3. 根据需要配置模板基本信息、模板阶段/任务、模板参数等。
     • 基本信息：可编辑模板的名称（必填）、语言（支持Java、Python、Node.js、Go、.Net、C++、PHP，默认选择“无”）、模板描述信息。
     • 任务编排：流水线模板目前可以添加流水线阶段及部分插件，将构建、代码检查、部署、接口测试等任务配置在模板中后，通过模板创建流水线的时候会同步创建相应类型的任务。
       

       • 模板中无需配置代码源。
       • 模板编排暂不支持配置阶段准入。
     • 参数设置：可根据需要为模板添加参数，流水线模板参数包括自定义参数和系统预定义参数两种，其中，自定义参数类型包括：字符串类型、枚举类型、自增长类型，配置方法请参见配置流水线自定义参数。
  4. 单击“保存”，完成模板创建。