# 新建流水线（远端模式） #### 准备工作 - 已[开通并授权使用CodeArts Pipeline](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0033.html)。 - [新建项目](https://support.huaweicloud.com/usermanual-projectman/projectman_ug_2001.html)。 - [新建代码仓库](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0077.html)。 #### 前提条件 - 请确保此项目已配置委托URN。 - 请确保此代码仓库中的成员已包含所需的委托URN。查看方法如下。 1. 访问流水线服务首页。 2. 在左侧导航栏中，单击"代码 \> 代码托管"，进入"代码托管"页面。 3. 单击需要查看仓库的名称，进入仓库的"代码"页面。 4. 单击"成员"，查看成员列表中是否包含所需的委托URN。 - 请确保用户具有将YAML文件推送到仓库分支的权限。查看方法如下（此处以默认分支为例）。 1. 访问流水线服务首页。 2. 在左侧导航栏中，单击"代码 \> 代码托管"，进入"代码托管"页面。 3. 单击需要查看仓库的名称，进入仓库的"代码"页面。 4. 单击"设置 \> 策略设置 \> 保护分支"，将鼠标移动至"推送"下的![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000002677341750.png)，查看权限信息。 5. 若需配置权限，单击"操作"列的![](https://support.huaweicloud.com/usermanual-pipeline/zh-cn_image_0000002707301483.png)，根据需要配置相关权限。 #### 新建YAML流水线 1. [访问CodeArts Pipeline首页](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0014.html)。 2. 单击"新建流水线"，弹出"新建流水线"弹窗，参考[表1]配置流水线基本信息。 表1流水线基本信息参数说明 | **参数项** | **说明** | 取值样例 | |:---|:---|:---| | 名称 | 流水线的名称，支持自定义。支持中文、大小写英文字母、数字、中划线、下划线，长度不超过128个字符。 | 输入"pipeline02"。 | | 流水线保存方式 | 创建并保存流水线的方式。 - 内置模式：以图形化界面方式轻松配置流水线，清晰展示任务串并行关系。 - 远端模式：以代码化方式编排流水线，支持语法自动补齐和校验，方便多流水线批量配置。流水线配置通过YAML文件保存在GIT仓库。请参考[新建流水线（YAML化）](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0024.html)。 | 选择"远端模式" | | 流水线分组 | 流水线的分组，可在新建流水线时选择分组，同时也可新建或编辑分组。 | - | | 远端仓库类型 | 流水线关联的仓库类型，包含Repo或GitCode两种类型。 | - | | 服务扩展点 | 关联GitCode仓库类型时，需通过服务扩展点实现与对应仓库的连接。可单击"新建服务扩展点"进行创建，也可以提前创建好扩展点。具体操作请参考[管理CodeArts服务扩展点](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0011.html)。 | - | | 代码仓 | 流水线关联的代码仓库，可选择提前新建好的仓库，也可单击"新建仓库"进行创建，新建仓库可参考[新建代码仓库](https://support.huaweicloud.com/usermanual-codeartsrepo/codeartsrepo_03_0077.html)。 | 选择"Repo02"。 | | 默认分支 | 仓库默认分支，手工或定时执行流水线时默认使用的分支。 | 选择"master"。 | | YAML文件 | yaml配置文件路径必须在.codearts/workflow目录下。 - 新建yaml文件：在编排流水线时，创建一个新的YAML文件。 - 已有yaml文件：基于已有YAML文件进行编排，编排后的内容会覆盖原YAML文件。YAML文件编写请参考[配置流水线（YAML化）](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0054.html)。 | 选择"新建yaml文件"。 | | 提交信息 | 配置方式选择"新建yaml文件"时，需配置此参数，此参数为必填项。 新建yaml文件时的命名信息。 | 填写"新建 .codearts/codearts-pipeline.yml" | | 委托URN | IAM的委托唯一标识。配置后，执行流水线中任务时使用委托身份和权限访问其他云服务，否则使用运行人的身份和权限。 | 填写本项目下已配置的委托URN。 | | 描述 | 该参数为非必填。对流水线的描述，长度不超过1024个字符。 | - | 3. 配置完基本信息，单击"新建"，进入"任务编排"页面。 - 左侧为YAML编辑区域，请参考[配置流水线（YAML化）](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0054.html)编写YAML。 - 右侧为流水线插件列表，请根据需要进行添加。 4. 编排完任务，单击"保存"或"保存"下拉框中的"保存并返回"，弹出"保存信息成功"提示，完成YAML流水线的创建与保存。 单击"执行"，弹出"执行配置"弹窗，参考[执行流水线](https://support.huaweicloud.com/usermanual-pipeline/pipeline_01_0074.html)配置相关信息，单击"确定"，完成YAML流水线的创建与执行。