更新时间:2026-09-15 GMT+08:00

配置Jira集成

CodeArts Repo支持通过“E2E设置”集成Jira系统,实现Repo与Jira工作项的关联和双向查看。

使用Jira的工作项关联对应代码提交、代码分支和合并请求场景,帮助用户从代码提交、分支信息、合并请求等对象中查看关联的Jira工作项信息,形成从“需求/缺陷”到“代码实现”的双向追踪能力。

在进行E2E设置前,请先查看约束与限制,满足E2E设置权限的用户请根据配置流程进行配置。

约束与限制

表1 E2E设置的约束与限制

限制类别

具体限制

功能限制

  • 看板项目下的代码托管仓库不支持E2E设置。
  • 如果在项目级“仓库设置”勾选了“开启强制继承”,本项目下所有代码组和仓库均会使用项目下设置,且代码组和仓库下设置不可更改,还请谨慎对待。

权限限制

  • 当用户角色为“项目经理”或者“项目管理员”,可以设置项目级E2E设置,请参考配置项目级的Repo权限进行配置。
  • 需要拥有Jira管理员权限,创建Jira用户并对其进行授权。详情请参考Jira产品文档

配置流程

  1. 进入仓库首页,在上方导航栏选择“设置” > “服务集成” > “E2E设置”
  2. 在右侧“可集成系统”下打开Jira开关。
  3. 依次完成配置服务地址配置触发器匹配Jira工作项
  4. 配置完成后,单击“提交”。

配置服务地址

  1. 从下拉框中选择服务扩展点,如果当前没有服务扩展点,单击右侧的“新建”。
  2. 在弹出的“新建服务扩展点”输入框中,参考管理CodeArts服务扩展点填写服务扩展点参数信息。
  3. 参数填写完成后,单击“确定”。

配置触发器

开启Jira集成系统后,在提交或合并请求中提及Jira工作项时,将创建远程链接和评论。
表2 触发器配置说明

配置项

配置项说明

触发器

支持“提交”和“合并请求”两种触发器,可选择任意一种或者两者全选。

  • “提交”:包含的事件类型为分支创建和Commit推送。
  • “合并请求”:包含的事件类型为合并请求创建和更新。

评论设置

至少选择一种触发器后,将会显示“评论设置”。若要向Jira工作项添加评论,请勾选“启用评论” 复选框。评论内容包括:提交标题、分支、提交信息以及提交哈希值。

将Jira工作项转换为最终状态

若要转换Jira工作项的状态,请勾选“启用Jira状态转换” 复选框,即可进行以下转换。

匹配Jira工作项

为Jira工作项配置自定义规则,在输入框中依次输入“Jira工作项正则表达式”“Jira工作项前缀”,详情参考匹配工作项