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

新建构建任务前准备工作

• 如果使用的是CodeArts Repo代码仓，需已具备代码托管服务（CodeArts Repo）的操作权限，具体操作可参考授权使用CodeArts Repo服务。
• 参考需求管理服务（CodeArts Req）的“用户指南 > Scrum项目 > 新建Scrum项目”，新建项目。

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

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

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

配置构建任务基本信息

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

   表1 基本信息配置说明

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

选择构建模板

选择适合自己项目的构建模板。例如：Maven。选择后，单击“确定”，进入“构建步骤”页面。

也可以选择“空白构建模板”，然后添加实际使用的构建步骤。如果预置模板不满足使用要求，也可以自定义模板。

配置构建步骤

1. 构建步骤页面展示所选模板的默认步骤组合。单击构建步骤上的可根据实际需要添加构建步骤，每个构建步骤的配置指导请参考生成构建产物中“图形化构建”部分。
   

   若构建步骤中预置的工具版本无法满足使用需求，可以通过自定义镜像并推送到SWR仓库自定义环境进行构建。

2. 配置完成后，单击“保存”，即可完成构建任务的创建。

自定义构建任务模板

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

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. 单击“确定”。

新建GitCode服务扩展点

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

   参数名称	参数说明	是否必填
   连接名称	服务扩展点的名称，可自定义。支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。	是
   Token	填写GitCode上获取的Token，获取方法如下： 登录GitCode。 单击页面右上角账号名称，选择“个人设置”。 单击 “+访问令牌”，填写令牌名称以及到期时间。 单击“新建访问令牌”，生成“你的个人访问令牌”，即Token。 单击，即可复制生成的Token。 说明： Token生成后，请及时保存，下次刷新页面将无法读取，需要重新生成新Token。 注意填写有效的Token描述信息，避免误删除导致构建失败。 无需使用时及时删除Token，避免信息泄露。	是

3. 单击“确定”。

新建码云服务扩展点

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

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

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

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

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

新建Gerrit服务扩展点

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

   参数名称	参数说明	是否必填
   连接名称	服务扩展点的名称。可自定义，支持中文、英文、数字、“-”、“_”、“.”、空格，不超过256个字符。	是
   Gerrit地址	输入待连接的Gerrit仓库的地址。支持https协议地址。	是
   用户名	输入待连接的Gerrit仓库的用户名。不超过300个字符。	否
   密码	输入待连接的Gerrit仓库的密码。不超过300个字符。	否

3. 单击“确定”。