新建流水线（远端模式）

准备工作

• 已开通并授权使用CodeArts Pipeline。
• 新建项目。
• 新建代码仓库。

前提条件

• 请确保此项目已配置委托URN。
• 请确保此代码仓库中的成员已包含所需的委托URN。查看方法如下。
  1. 访问流水线服务首页。
  2. 在左侧导航栏中，单击“代码 > 代码托管”，进入“代码托管”页面。
  3. 单击需要查看仓库的名称，进入仓库的“代码”页面。
  4. 单击“成员”，查看成员列表中是否包含所需的委托URN。
• 请确保用户具有将YAML文件推送到仓库分支的权限。查看方法如下（此处以默认分支为例）。
  1. 访问流水线服务首页。
  2. 在左侧导航栏中，单击“代码 > 代码托管”，进入“代码托管”页面。
  3. 单击需要查看仓库的名称，进入仓库的“代码”页面。
  4. 单击“设置 > 策略设置 > 保护分支”，将鼠标移动至“推送”下的，查看权限信息。
  5. 若需配置权限，单击“操作”列的，根据需要配置相关权限。

新建YAML流水线

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

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

   参数项	说明	取值样例
   名称	流水线的名称，支持自定义。支持中文、大小写英文字母、数字、中划线、下划线，长度不超过128个字符。	输入“pipeline02”。
   流水线保存方式	创建并保存流水线的方式。 内置模式：以图形化界面方式轻松配置流水线，清晰展示任务串并行关系。 远端模式：以代码化方式编排流水线，支持语法自动补齐和校验，方便多流水线批量配置。流水线配置通过YAML文件保存在GIT仓库。请参考新建流水线（YAML化）。	选择“远端模式”
   流水线分组	流水线的分组，可在新建流水线时选择分组，同时也可新建或编辑分组。	-
   远端仓库类型	流水线关联的仓库类型，包含Repo或GitCode两种类型。	-
   服务扩展点	关联第GitCode仓库类型时，需通过服务扩展点实现与对应仓库的连接。可单击“新建服务扩展点”进行创建，也可以提前创建好扩展点。具体操作请参考管理CodeArts服务扩展点。	-
   代码仓	流水线关联的代码仓库，可选择提前新建好的仓库，也可单击“新建仓库”进行创建，新建仓库可参考新建代码仓库。	选择“Repo02”。
   默认分支	仓库默认分支，手工或定时执行流水线时默认使用的分支。	选择“master”。
   YAML文件	yaml配置文件路径必须在.codearts/workflow目录下。 新建yaml文件：在编排流水线时，创建一个新的YAML文件。 已有yaml文件：基于已有YAML文件进行编排，编排后的内容会覆盖原YAML文件。YAML文件编写请参考配置流水线（YAML化）。	选择“新建yaml文件”。
   提交信息	配置方式选择“新建yaml文件”时，需配置此参数，此参数为必填项。 新建yaml文件时的命名信息。	填写“新建 .codearts/codearts-pipeline.yml”
   委托URN	IAM的委托唯一标识。配置后，执行流水线中任务时使用委托身份和权限访问其他云服务，否则使用运行人的身份和权限。	填写本项目下已配置的委托URN。
   描述	该参数为非必填。对流水线的描述，长度不超过1024个字符。	-

3. 配置完基本信息，单击“新建”，进入“任务编排”页面。
   • 左侧为YAML编辑区域，请参考配置流水线（YAML化）编写YAML。
   • 右侧为流水线插件列表，请根据需要进行添加。

4. 编排完任务，单击“保存”或“保存”下拉框中的“保存并返回”，弹出“保存信息成功”提示，完成YAML流水线的创建与保存。

   单击“执行”，弹出“执行配置”弹窗，参考执行流水线配置相关信息，单击“确定”，完成YAML流水线的创建与执行。