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

约束与限制

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

• 非洲-开罗：101.46.68.29
• 拉美-圣地亚哥：119.8.154.190
• 非洲-约翰内斯堡：182.160.17.185
• 中东-利雅得：101.46.48.183
• 拉美-墨西哥城二：122.8.183.54、110.238.80.148
• 巴西：119.8.85.121
• 土耳其-伊斯坦布尔：101.44.33.34、101.44.34.216、101.44.36.238

新建构建任务前准备工作

• 如果使用的是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：拉取托管在其他服务上的代码进行构建。
   服务扩展点	可选参数。当“代码源”选择为第三方代码仓时需要配置，首次使用第三方代码仓，需新建服务扩展点。新建步骤可参考新建服务扩展点。
   代码仓	选择实际需要编译的代码仓。
   默认分支	选择仓库默认分支。
   描述	可选参数。根据实际场景对编译构建任务的描述。字符长度范围0~512。

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

自定义构建任务模板

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

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

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

   表2 管理自定义模板

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

新建服务扩展点

当在新建图形化构建任务阶段，代码源选择第三仓库时需要配置。

服务扩展点（Endpoint）是软件开发生产线的一种扩展插件，为软件开发生产线提供链接第三方服务的能力。

编译构建服务默认从代码托管服务拉取代码进行构建，同时也可使用服务扩展点连接第三方代码仓库获取项目源码。

• 使用第三方代码仓库可能出现网络不稳定或其他问题，具体使用体验取决于第三方代码仓库网络环境和服务状态。
• 建议使用代码托管的代码导入功能，将代码导入到代码托管，实现安全、稳定、高效下载与构建。

新建GitHub服务扩展点

GitHub连接可选择使用OAuth授权或使用AccessToken授权，可限制赋予编译构建服务对仓库的访问权限（可以拉取代码完成构建即可）。

同时可以随时删除连接或取消授权，可有效避免密码泄露风险。

1. 单击“服务扩展点”右侧的“新建”。
2. 在弹出的对话框中，配置如下参数。

   参数名称	参数说明
   连接名称	服务扩展点的名称，可自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
   验证方式	OAuth认证：需要登录GitHub账号进行手动授权。 Access Token认证：按照如下方式获取GitHub的Access Token，填写此处。 登录GitHub，并打开设置页面。 单击“Developer settings”。 选择“Personal access tokens > Generate new token”。 验证登录账号。 填写Token描述并选择权限，选择私有仓库访问权限，单击“Generate token”生成Token。 复制生成的Token。 说明： Token生成后，请及时保存，下次刷新页面将无法读取，需要重新生成新Token。 注意填写有效的Token描述信息，避免误删除导致构建失败。 无需使用时及时删除Token，避免信息泄露。

3. 授权成功后，回到新建编译构建任务页面。

新建通用Git服务扩展点

1. 单击“服务扩展点”右侧的“新建”。
2. 在弹出的对话框中，配置如下参数。

   参数名称	参数说明
   连接名称	服务扩展点的名称，可自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。
   Git仓库Url	输入待连接的Git仓库的HTTPS地址。
   用户名	可选参数。输入待连接的Git仓库的用户名。不超过300个字符。
   密码或Access Token	可选参数。输入待连接的Git仓库的密码。不超过300个字符。

3. 单击“确定”。