ONES 集成

引入于 15.5 版本,功能标志ff_ones_issues_integration。默认禁用。

使用 ONES 作为极狐GitLab 群组或项目的议题跟踪器。

note每个极狐GitLab 群组或项目只能集成一个外部议题跟踪器。如果您的群组或项目已集成其他的外部议题跟踪器,您将无法配置启用 ONES 集成。

准备工作

在极狐GitLab 上配置启用 ONES 集成之前,需要在 ONES 上获取配置所需的信息。

获取团队 ID 和项目 ID

使用您的帐户登录 ONES,并进入要与极狐GitLab 关联的 ONES 项目。通过项目页面的 URL,您即可获取该项目的团队 ID 和项目 ID。

ONES SaaS 平台上的某个项目为例:

https://ones.cn/project/#/team/E5****Gt/project/WM********9L/...

在此示例中,E5****GtONES 团队 IDWM********9LONES 项目 ID。记录这两个参数,在极狐GitLab 上配置启用 ONES 集成时需要使用。

获取用户 ID 和 API 令牌

参考调用以下 curl 命令获取用户 ID 和 API 令牌,将 <your-email> 替换为 ONES 用户的邮箱,将 <your-ones-password> 替换为 ONES 用户的密码,以 ONES SaaS 平台为例:

curl -s --data-raw '{"email": "<your-email>", "password": "<your-ones-password>"}' \
--request POST 'https://ones.cn/project/api/project/auth/login' --header 'Content-Type: application/json' \
| python3 -c "import sys, json; u=json.load(sys.stdin)['user'];  print({'ones_user_id': u['uuid'], 'ones_api_token': u['token']})"

输出格式为:

{'ones_user_id': 'your-ones-user-uuid', 'ones_api_token': 'your-ones-api-token'}

输出示例:

{'ones_user_id': 'KM****xj', 'ones_api_token': '3vFt7l********************ABc7aMTnrjOj'}

在此示例中,KM****xjONES 用户 ID3vFt7l********************ABc7aMTnrjOjONES API 令牌。记录这两个参数,在极狐GitLab 上配置启用 ONES 集成时需要使用。

配置 ONES 集成

支持在群组级别或项目级别集成 ONES 项目,在极狐GitLab 上完成以下步骤:

  1. 在左侧边栏的顶部:
    • 配置群组级别集成:选择 搜索极狐GitLab () 并找到您的群组。
    • 配置项目级别集成:选择 搜索极狐GitLab () 并找到您的项目。
  2. 在左侧边栏上,选择 设置 > 集成
  3. 选择 ONES。
  4. 启用集成 下,选择 启用
  5. 提供以下 ONES 配置信息:
  6. 选择 保存更改

配置完成后,在集成了 ONES 项目的群组或项目页面的左导航栏中,您可以:

  • 在群组或项目页面的左导航栏中,选择 计划 > ONES 议题,查看来自 ONES 平台的议题。
  • 在群组或项目页面的左导航栏中,选择 计划 > 打开 ONES,访问 ONES 登录页面。