新建构建任务（图形化构建）

约束与限制

当构建任务的代码源为用户本地代码仓时，出于安全性考虑，如仅需CodeArts Build可以访问代码仓，可将下列IP加入代码仓服务器的访问白名单中。

• 华北-北京四、华北-北京一、东北-大连：121.36.9.82、119.3.235.73
• 华南-广州、华南-深圳、华东-上海一、华东-上海二、西南-贵阳一：139.159.236.151、124.71.112.32

新建构建任务前准备工作

• 如果使用的是CodeArts Repo代码仓，需已具备代码托管服务（CodeArts Repo）的操作权限。
• 参考软件开发生产线(CodeArts)的“用户指南 > 软件开发生产线（CodeArts）使用前准备 > 新建CodeArts项目”，新建CodeArts项目。

  如果已有项目，无需执行此步骤。

• 参考代码托管服务（CodeArts Repo）的“用户指南 > 创建 > 代码托管仓库”，新建仓库。

  如果用户使用的是第三方代码仓或已有CodeArts Repo代码仓，无需执行此步骤。

新建图形化构建任务

1. 通过项目入口方式访问CodeArts Build服务首页。
2. 单击“新建任务”，进入配置“基本信息”页面，参考表1填写构建任务基本信息。然后单击“下一步”，进入“构建模板”页面。

   表1 基本信息配置说明

   参数	说明
   名称	创建的编译构建任务名称，可自定义。 支持中英文，数字，下划线“_”和连接符“-”。 字符长度范围为1~115。
   所属项目	创建的编译构建任务所属项目。 以项目入口方式访问访问编译构建服务时默认填写，无需手动填写。 以服务入口访问时需根据实际情况选择新建构建任务前准备工作中创建的项目。
   代码源	选择实际需要编译的代码源。 Repo：从代码托管服务拉取代码进行构建。 其他项目Repo：从其他项目的代码托管中拉取代码进行构建，请选择已有的项目、该项目下已经创建的代码仓以及默认分支。 来自流水线：如果选择来自流水线，则只能通过流水线任务驱动执行，不能单独执行。 以下为非CodeArts的第三方代码仓库。 GitHub：拉取托管在GitHub上的代码进行构建。 通用Git：拉取托管在其他服务上的代码进行构建。 GitCode：拉取托管在GitCode仓库上的代码进行构建。 码云：拉取托管在码云上的代码进行构建。 Gerrit：拉取托管在Gerrit上的代码进行构建。
   服务扩展点	可选参数。当“代码源”选择为第三方代码仓时需要配置，首次使用第三方代码仓，需新建服务扩展点。新建步骤可参考新建CodeArts服务扩展点。
   代码仓	选择实际需要编译的代码仓。
   默认分支	选择仓库默认分支。
   描述	可选参数。根据实际场景对编译构建任务的描述。字符长度范围0~512。

3. CodeArts Build内置30+种构建模板，您可以根据实际需要选择构建模板，选择后单击“确定”，构建任务即可新建完成。
   • 也可以选择“空白构建模板”，然后在配置构建任务时添加实际使用的构建步骤。
   • 如果预置模板不满足使用要求，也可以自定义模板。
4. 页面自动跳转到“构建步骤”页面，可继续配置构建任务。

自定义构建任务模板

如果需将当前的构建任务保存为模板，以便后续创建构建任务时选择，则可以按照以下操作执行。

1. 在构建任务历史页面，单击页面右上角，在下拉列表中选择“保存模板”。
2. 在弹框中输入模板名称与模板描述，单击“保存”。
3. 单击用户名，在下拉菜单中选择“租户设置”。
4. 选择导航栏“编译构建 > 自定义模板”，即可在列表中看到已保存的构建模板。

   对已保存的构建模板，可以完成以下操作：

   表2 管理自定义模板

   操作	说明
   搜索模板	在搜索框输入关键字，可搜索模板。
   收藏模板	单击，可以收藏该模板。
   删除模板	单击，在弹框中单击“确定”，即可删除该模板。 仅可以删除当前用户创建的模板。