新建代码化构建任务

约束与限制

代码化构建仅支持使用CodeArts Repo代码仓。

新建构建任务前准备工作

• 已具备CodeArts Repo服务的操作权限，具体操作可参考授权使用CodeArts Repo服务。
• 参考软件开发生产线(CodeArts)的“用户指南 > 软件开发生产线（CodeArts）使用前准备 > 新建CodeArts项目”，新建CodeArts项目。

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

创建代码化构建使用的YAML文件

1. 通过项目入口方式访问CodeArts Build服务首页。
2. 选择导航栏“代码 > 代码托管”，进入代码托管页面。参考新建自定义代码仓库创建代码仓。
3. 单击代码仓名称，在代码仓下依次单击“新建 > 新建目录”，目录命名为“.cloudbuild”。
4. 在“.cloudbuild”目录下依次单击“新建 > 新建文件”，文件命名为“build.yml”，新建后文件目录如图1所示。
   图1 文件目录
   

   若YAML文件不存放在“.cloudbuild”目录，可通过“CB_BUILD_YAML_PATH”参数指定YAML文件在代码仓中的路径。参数配置可参考添加自定义参数的配置指导。

5. 单击，参考编写单任务build.xml文件或编写多任务build.xml文件的代码示例，编写“build.yml”文件。

配置构建任务基本信息

1. 选择导航栏“持续交付 > 编译构建”，进入编译构建服务页面。
2. 单击“新建任务”，进入配置“基本信息”页面，参考表1填写构建任务基本信息。

   表1 基本信息配置说明

   参数	说明
   名称	创建的编译构建任务名称，可自定义。 支持中英文，数字，下划线“_”和连接符“-”。 字符长度范围为1~115。
   所属项目	创建的编译构建任务所属项目。 当以项目入口方式访问编译构建服务时默认填写，无需手动填写。 当以服务入口访问时需根据实际情况选择新建构建任务前准备工作中创建的项目。
   任务分组	选择构建任务所属的分组。分组详情可参考新建分组。
   代码源	选择Repo：表示从代码托管拉取代码进行构建。
   代码仓	选择实际需要编译的代码仓。
   默认分支	选择仓库默认分支。
   描述	可选参数。根据实际场景对编译构建任务的描述。字符长度范围0~512。

3. 单击“下一步”，进入“构建模板”页面。

选择构建模板

1. 在构建模板页面保持默认选择即可。

   使用代码化构建时，选择任何构建模板都不影响使用YAML构建。

2. 单击“确定”，进入“构建步骤”页面。

配置构建步骤

在“构建步骤”页面左上角单击“代码化”页签，系统会从配置构建任务基本信息中配置的代码仓库及分支中，自动读取YAML文件。

您可在此处，参考配置构建任务下“构建任务基础配置”和“配置构建步骤”中的“代码化构建”部分的代码示例，对YAML文件进行修改。如果在此处修改了YAML文件，那么执行构建任务后，修改后的内容会覆盖创建代码化构建使用的YAML文件中的原YAML文件。

配置完成后，单击“保存”，即可完成构建任务的创建。完成后可在编译构建任务列表页查看到该任务。

相关操作

• 关于代码构建的使用示例，可参考CodeArts Build最佳实践代码化构建的案例。
• 后续操作可参考配置构建任务。
• 关于构建任务的管理可参考管理构建任务。