更新时间:2025-09-11 GMT+08:00
分享

创建代码检查任务

本章节为用户介绍如何单个创建或批量创建不同代码源的代码检查任务。

前提条件

  • 新建CodeArts项目
  • 如果使用的是代码托管服务(CodeArts Repo)的代码仓库,则可以参考代码托管服务的用户指南 > 新建Repo代码仓库,完成新建代码仓库
  • 如果使用的是第三方代码仓库,需已创建可用的代码仓库。

约束与限制

  • 若删除的代码检查任务其代码仓为多分支代码仓,分支数量小于200时可删除成功,大于等于200会删除失败。
  • 仅通过项目/租户模板的创建方式,支持批量创建代码检查任务。单次最多可以创建10个代码检查任务。
  • 使用第三方代码仓库可能出现网络不稳定或其他问题,具体使用体验取决于第三方代码仓库网络环境和服务状态。

创建代码检查任务

支持创建单个和批量代码检查任务。

在CodeArts Repo服务中创建云端仓库时,若勾选了“自动创建代码检查任务”,则代码仓库创建完成后,在代码检查任务列表可查看对应仓库的检查任务。

以下示例为在CodeArts Repo服务中创建云端仓库不勾选“自动创建代码检查任务”时,Repo代码源代码检查任务的创建步骤。

  1. 访问CodeArts Check服务首页
  2. 在代码检查页面,单击“新建任务”,在“新建任务”页面,参考表1配置参数。

    表1 Repo代码源检查任务参数说明

    参数

    说明

    所属项目

    任务所属项目。

    • 以项目入口方式访问CodeArts Check服务时默认填写,无需手动填写。
    • 以服务入口访问时需根据实际情况选择新建项目中创建的项目。

    新建方式

    选择创建代码检查任务的模板。创建单个代码检查任务时,选择“空模板”

    代码源

    选择检查的代码源。

    • Repo:检查当前项目下Repo代码仓中的代码质量。

      在代码仓和其子模块为同一种开发语言时,支持对子模块进行检查。

    • 其他项目Repo:检查其他项目下Repo代码仓的代码质量。

    任务名称

    代码检查任务名称,可自定义。

    • 支持中英文,数字,点,下划线“_”和连接符“-”
    • 字符长度范围为3~128。

    项目

    “代码源”选择“其他项目Repo”时,选择Repo代码仓所在的项目。

    代码仓

    选择需要检查的代码仓库。

    默认分支

    选择需要检查的仓库分支。

    检查语言

    选择需要检查的代码语言。当前支持检查的语言可参考支持主流开发语言

    当代码源是Repo时,检查语言会根据代码仓默认选择,只能减少语言,不能手动新增语言。

  3. 单击“确定”,完成代码检查任务创建。可在代码检查任务列表页查看到该任务。

    • 创建代码检查任务后,如果您需要修改任务名称或默认分支,可在“代码检查详情”页面,选择“设置 > 基本信息”,修改任务名称、分组和默认分支。
    • 对于不再继续使用的代码检查任务,可进入“代码检查详情”页面,选择“设置 > 基本信息”,删除当前代码检查任务。也可以单击代码检查任务所在行,在下拉框中,选择“删除”

      若删除的代码检查任务其代码仓为多分支代码仓,分支数量小于200时可删除成功,大于等于200会删除失败。

  • 使用第三方代码仓库可能出现网络不稳定或其他问题,具体使用体验取决于第三方代码仓库网络环境和服务状态。
  • 建议使用代码托管的代码导入功能,将代码导入到代码托管,实现安全、稳定、高效下载与构建。
  1. 访问CodeArts Check服务首页
  2. 在代码检查页面,单击“新建任务”,在“新建任务”页面,参考表2配置参数。

    表2 第三方代码源检查任务参数说明

    参数

    说明

    所属项目

    任务所属项目。

    • 以项目入口方式访问CodeArts Check服务时默认填写,无需手动填写。
    • 以服务入口访问时需根据实际情况选择新建项目中创建的项目。

    代码源

    选择检查的代码来源。

    • 选择“GitHub”,检查托管在GitHub代码仓中的代码质量。

      创建GitHub代码源检查任务前,需将Github仓库设置成公开。

    • 选择“GitCode”,检查托管在GitCode代码仓中的代码质量。
    • 选择“通用Git”。对于托管在其他服务上的代码,可以使用通用Git连接实现代码拉取。
    • 选择“码云”,检查托管在码云代码仓中的代码质量。

    任务名称

    代码检查任务名称,可自定义。

    • 支持中英文,数字,点,下划线“_”和连接符“-”
    • 字符长度范围为1~128。

    服务扩展点

    选择连接到第三方代码仓库的服务扩展点。如果没有,可参考新建服务扩展点创建对应代码仓的服务扩展点

    代码仓

    选择需要检查的代码仓库。

    默认分支

    选择需要检查的仓库分支。

    检查语言

    选择需要检查的代码语言。当前支持检查的语言可参考支持主流开发语言

  3. 单击“确定”,代码检查任务创建完成。可在代码检查任务列表页查看到该任务。

    • 创建代码检查任务后,如果您需要修改任务名称或默认分支,可在“代码检查详情”页面,选择“设置 > 基本信息”,修改任务名称、分组和默认分支。
    • 对于不再继续使用的代码检查任务,可进入“代码检查详情”页面,选择“设置 > 基本信息”,删除当前代码检查任务。也可以单击代码检查任务所在行,在下拉框中,选择“删除”

      若删除的代码检查任务其代码仓为多分支代码仓,分支数量小于200时可删除成功,大于等于200会删除失败。

仅自定义模板的创建方式,支持批量创建代码检查任务。单次最多可以创建10个代码检查任务。

  1. 通过项目入口方式访问CodeArts Check服务首页
  2. 在代码检查页面,单击“新建任务”,在“新建任务”页面,参考表3配置参数。

    表3 批量任务参数说明

    参数

    说明

    所属项目

    需要使用的模板所属项目。

    • 以项目入口方式访问CodeArts Check服务时默认填写,无需手动填写。
    • 以服务入口访问时需根据实际情况选择新建项目中创建的项目。

    新建方式

    选择使用的模板,可选择“项目模板”“租户模板”

    • 项目模板:使用当前项目下自定义的任务模板。
    • 租户模板:使用当前租户自定义的任务模板。

    租户模板和项目模板的差异如下:

    • 通知管理:基于租户模板创建任务不继承接受者角色、自定义成员配置信息。
    • 检查范围:基于租户模板创建任务不继承忽略文件的配置信息。
    • 自定义环境:基于租户模板创建任务不继承私有依赖仓扩展点信息。
    • 租户模板不支持修改模板信息。

    模板

    选择对应的自定义模板。若无模板,可参考自定义代码检查任务模板新建模板。

    代码源

    选择检查的代码来源。

    • 选择“Repo”,检查托管在Repo代码仓中的代码质量。
    • 选择“GitHub”,检查托管在GitHub代码仓中的代码质量。

      创建GitHub代码源检查任务前,需将Github仓库设置成公开。

    • 选择“GitCode”,检查托管在GitCode代码仓中的代码质量。
    • 选择“通用Git”。对于托管在其他服务上的代码,可以使用通用Git连接实现代码拉取。
    • 选择“码云”,检查托管在码云代码仓中的代码质量。

    任务信息

    • 项目:选择代码检查任务的所属项目。
    • 服务扩展点:代码源选择非Repo代码仓时需要配置。如果没有服务扩展点,可参考新建服务扩展点创建对应代码仓的服务扩展点
    • 代码仓:选择代码检查任务使用的代码仓。
    • 默认分支:选择代码检查任务需要检查的仓库分支。
    • 任务名称:填写代码检查任务的名称。支持中英文,数字,点,下划线“_”和连接符“-”,字符长度范围为3~128。

    单击“增加任务”,可创建新的代码检查任务,单次最多可创建10个代码检查任务。

  3. 单击“确定”,批量代码检查任务创建完成。

    可在对应项目下的代码检查任务列表中查看到新建的代码检查任务。

自定义代码检查任务模板

  1. 访问CodeArts Check服务首页
  2. 在代码检查任务列表页,选择“ 配置中心 > 模板管理”
  3. 单击“新建模板”,在弹出的窗口按照配置参数。

    表4 模板参数说明

    参数

    说明

    所属项目

    任务所属项目。

    • 以项目入口方式访问CodeArts Check服务时默认填写,无需手动填写。
    • 以服务入口访问时需根据实际情况选择新建项目中创建的项目。

    代码源

    • 选择“GitHub”,检查托管在GitHub代码仓中的代码质量。

      创建GitHub代码源检查任务前,需将Github仓库设置成公开。

    • 选择“GitCode”,检查托管在GitCode代码仓中的代码质量。
    • 选择“通用Git”。对于托管在其他服务上的代码,可以使用通用Git连接实现代码拉取。
    • 选择“码云”,检查托管在码云代码仓中的代码质量。
    • 选择“Repo”,检查托管在Repo代码仓中的代码质量。

    模板名称

    代码检查任务名称,可自定义。

    • 支持中英文,数字,点,下划线“_”和连接符“-”
    • 字符长度范围为3~128。

    服务扩展点

    选择连接到第三方代码仓库的服务扩展点。如果没有,可参考新建服务扩展点创建对应代码仓的服务扩展点

    代码仓

    选择需要检查的代码仓库。

    默认分支

    选择需要检查的仓库分支。

  4. 单击“确定”,代码检查任务模板创建完成。

    可在代码检查任务模板列表中查看到该模板,并且在基于租户模板或者项目模板新建代码检查任务时可以选到该模板

管理代码检查任务

CodeArts Check支持批量管理代码检查任务。

  1. 在代码检查任务列表页,勾选任务名称前的复选框。
  2. 在弹出的窗口中可对选中的任务进行移动分组,修改配置,删除和导出任务告警的操作。

相关操作

相关文档