- 最新动态
- 功能总览
- 产品介绍
- 快速入门
-
用户指南
- 编译构建服务(CodeArts Build)使用流程
- 开通CodeArts Build
- 配置CodeArts Build项目级角色权限
- 新建构建任务
-
配置构建任务
- 构建任务基础配置
- 选择构建步骤
-
配置构建步骤
- 使用Maven构建
- 使用Android构建
- 使用Npm构建
- 使用Gradle构建
- 使用Yarn构建
- 使用gulp构建
- 使用Grunt构建
- 使用mono构建
- 使用PHP构建
- 使用SetupTool构建
- 使用PyInstaller构建
- 使用shell命令构建
- 使用Gnu-arm构建
- 使用CMake构建
- 使用Ant构建
- 使用Kotlin构建
- 使用Go语言构建
- 使用Ionic Android App构建
- 构建Android快应用
- 使用Sbt构建
- 使用Grails构建
- 使用Bazel构建
- 使用Flutter构建
- 使用HarmonyOS构建
- 通过Docker命令操作镜像
- 生成单元测试报告
- 自定义构建环境
- 使用自定义环境构建
- 下载软件发布库中的软件包
- 上传软件包到软件发布库
- 上传文件到OBS
- 配置构建任务参数
- 配置构建任务执行计划
- 配置构建任务角色权限
- 配置构建任务事件通知
- 执行构建任务
- 查看构建任务
- 管理构建任务
- 查询审计日志
- 参考
- 旧版手册页面
-
最佳实践
- 基于Maven构建产物制作Docker镜像并发布到镜像仓(内置执行机/图形化构建)
- 使用Maven构建上传软件包至私有依赖库(内置执行机/图形化构建)
- 使用Maven构建实现私有依赖包的上传及下载引用(内置执行机/图形化构建)
- 使用NPM构建上传软件包至软件发布库(内置执行机/图形化构建)
- 使用自定义执行机执行Maven构建(自定义执行机/图形化构建)
- 使用Maven构建上传软件包和推送镜像到SWR(内置执行机/代码化构建)
- 使用Maven构建执行多任务构建工程(内置执行机/代码化构建)
- 基于私有依赖库使用Maven构建并上传软件包(内置执行机/图形化构建)
- 使用自定义构建环境执行构建任务(内置执行机/图形化构建)
- API参考
-
常见问题
- 通用构建问题
- Maven构建
- Android构建
- Gradle构建
-
Npm构建
- 执行Npm构建时,报错提示JavaScript heap out of memory
- 执行Npm构建时,报错提示enoent ENOENT: no such file or directory
- 执行Npm构建时,报错提示Module not found: Error: Can't resolve ...
- 执行Npm构建失败,但不显示错误日志
- 执行Npm构建时,报错提示npm cb() never called
- 执行Npm构建时,报错提示gyp ERR! stack Error: EACCES: permission denied
- 执行Npm构建时,报错提示eslint: error 'CLODOP' is not defined
- 执行Npm构建时,报错提示node-sass下载失败
- 执行Npm构建时,报错提示error: could not write config file
- Npm构建耗时且安装依赖缓慢
- 执行Npm构建时,报错提示找不到依赖版本
- 镜像问题
- 视频帮助
- 通用参考
链接复制成功!
新建构建任务(图形化构建)
图形化构建是指通过在CodeArts Build页面配置构建工具的相关参数实现编译构建,可以根据实际使用场景自定义组合构建工具。
约束与限制
当构建任务的代码源为用户本地代码仓时,出于安全性考虑,如仅需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代码仓,无需执行此步骤。
新建图形化构建任务
- 通过项目入口方式访问CodeArts Build服务首页。
- 单击“新建任务”,进入配置“基本信息”页面,参考表1填写构建任务基本信息。然后单击“下一步”,进入“构建模板”页面。
表1 基本信息配置说明 参数
说明
名称
创建的编译构建任务名称,可自定义。
- 支持中英文,数字,下划线“_”和连接符“-”。
- 字符长度范围为1~115。
所属项目
创建的编译构建任务所属项目。
- 以项目入口方式访问访问编译构建服务时默认填写,无需手动填写。
- 以服务入口访问时需根据实际情况选择新建构建任务前准备工作中创建的项目。
代码源
选择实际需要编译的代码源。
- Repo:从代码托管服务拉取代码进行构建。
- 其他项目Repo:从其他项目的代码托管中拉取代码进行构建,请选择已有的项目、该项目下已经创建的代码仓以及默认分支。
- 来自流水线:如果选择来自流水线,则只能通过流水线任务驱动执行,不能单独执行。
以下为非CodeArts的第三方代码仓库。
- GitHub:拉取托管在GitHub上的代码进行构建。
- 通用Git:拉取托管在其他服务上的代码进行构建。
服务扩展点
可选参数。当“代码源”选择为第三方代码仓时需要配置,首次使用第三方代码仓,需新建服务扩展点。新建步骤可参考新建服务扩展点。
代码仓
选择实际需要编译的代码仓。
默认分支
选择仓库默认分支。
描述
可选参数。根据实际场景对编译构建任务的描述。字符长度范围0~512。
- CodeArts Build内置30+种构建模板,您可以根据实际需要选择构建模板,选择后单击“确定”,构建任务即可新建完成。
- 页面自动跳转到“构建步骤”页面,可继续配置构建任务。
自定义构建任务模板
如果需将当前的构建任务保存为模板,以便后续创建构建任务时选择,则可以按照以下操作执行。
- 在构建任务历史页面,单击页面右上角
,在下拉列表中选择“保存模板”。
- 在弹框中输入模板名称与模板描述,单击“保存”。
- 单击用户名,在下拉菜单中选择“租户设置”。
- 选择导航栏“编译构建 > 自定义模板”,即可在列表中看到已保存的构建模板。
对已保存的构建模板,可以完成以下操作:
表2 管理自定义模板 操作
说明
搜索模板
在搜索框输入关键字,可搜索模板。
收藏模板
单击
,可以收藏该模板。
删除模板
单击
,在弹框中单击“确定”,即可删除该模板。
仅可以删除当前用户创建的模板。
新建服务扩展点
当在新建图形化构建任务阶段,代码源选择第三仓库时需要配置。
服务扩展点(Endpoint)是软件开发生产线的一种扩展插件,为软件开发生产线提供链接第三方服务的能力。
编译构建服务默认从代码托管服务拉取代码进行构建,同时也可使用服务扩展点连接第三方代码仓库获取项目源码。
- 使用第三方代码仓库可能出现网络不稳定或其他问题,具体使用体验取决于第三方代码仓库网络环境和服务状态。
- 建议使用代码托管的代码导入功能,将代码导入到代码托管,实现安全、稳定、高效下载与构建。
新建GitHub服务扩展点
GitHub连接可选择使用OAuth授权或使用AccessToken授权,可限制赋予编译构建服务对仓库的访问权限(可以拉取代码完成构建即可)。
同时可以随时删除连接或取消授权,可有效避免密码泄露风险。
- 单击“服务扩展点”右侧的“新建”。
- 在弹出的对话框中,配置如下参数。
参数名称
参数说明
连接名称
服务扩展点的名称,可自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
验证方式
- OAuth认证:需要登录GitHub账号进行手动授权。
- Access Token认证:按照如下方式获取GitHub的Access Token,填写此处。
- 登录GitHub,并打开设置页面。
- 单击“Developer settings”。
- 选择“Personal access tokens > Generate new token”。
- 验证登录账号。
- 填写Token描述并选择权限,选择私有仓库访问权限,单击“Generate token”生成Token。
- 复制生成的Token。
- 授权成功后,回到新建编译构建任务页面。
新建通用Git服务扩展点
- 单击“服务扩展点”右侧的“新建”。
- 在弹出的对话框中,配置如下参数。
参数名称
参数说明
连接名称
服务扩展点的名称,可自定义。支持中文、英文、数字、“-”、“_”、“.”、空格,不超过256个字符。
Git仓库Url
输入待连接的Git仓库的HTTPS地址。
用户名
可选参数。输入待连接的Git仓库的用户名。不超过300个字符。
密码或Access Token
可选参数。输入待连接的Git仓库的密码。不超过300个字符。
- 单击“确定”。