• 准备工作
  • 获取团队 ID 和项目 ID
  • 获取用户 ID 和 API 令牌
• 配置 ONES 集成

ONES 集成

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

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

准备工作

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

获取团队 ID 和项目 ID

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

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

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

在此示例中，E5****Gt 为 ONES 团队 ID，WM********9L 为 ONES 项目 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****xj 为 ONES 用户 ID，3vFt7l********************ABc7aMTnrjOj 为 ONES API 令牌。记录这两个参数，在极狐GitLab 上配置启用 ONES 集成时需要使用。

配置 ONES 集成

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

1. 在顶部栏上：
   • 配置群组级别集成：选择 菜单 > 群组 并找到您的群组。
   • 配置项目级别集成：选择 菜单 > 项目 并找到您的项目。
2. 在左侧边栏上，选择 设置 > 集成。
3. 选择 ONES。
4. 在 启用集成 下，选择 启用。
5. 提供以下 ONES 配置信息：
   • ONES web URL：通过 web 访问 ONES 实例的 URL。默认为 https://ones.cn/，即 ONES SaaS 平台。
   • ONES API URL（可选）：留空时，默认与 web URL 相同。如果与 web URL 不同，可以配置此项。
   • ONES 团队 ID：参考获取团队 ID 和项目 ID。
   • ONES 项目 ID：参考获取团队 ID 和项目 ID。
   • ONES 用户 ID：参考获取用户 ID 和 API 令牌。
   • ONES API 令牌：参考获取用户 ID 和 API 令牌。
6. 选择 保存更改。

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

• 在群组或项目页面的左导航栏中，选择 议题 > ONES，查看来自 ONES 平台的议题。
• 在群组或项目页面的左导航栏中，选择 ONES，跳转到 ONES 平台上的项目页面。