配置 Jira
您可以通过在极狐GitLab 中配置项目设置,来设置 Jira 集成。 您还可以在群组级别配置这些设置,并在实例级别为私有化部署实例配置这些设置。
先决条件:
- 确保您的极狐GitLab 安装实例不使用相对 URL。
- 对于 Jira Server,确保您拥有 Jira 用户名和密码。
- 对于 Jira Cloud,确保您拥有 API 令牌和用于创建令牌的电子邮件地址。
要配置您的项目:
- 在顶部栏中,选择 主菜单 > 项目 并找到您的项目。
- 在左侧边栏中,选择 设置 > 集成。
- 选择 Jira。
- 选择 启用集成。
- 选择 触发 动作。您的选择决定了提及 Jira (在极狐GitLab 提交、合并请求或两者中)议题,是否会在 Jira 中创建一个返回极狐GitLab 的交叉链接。
- 要在极狐GitLab 中执行 触发 操作时,在 Jira 议题中发表评论,请选择 启用评论。
- 要在极狐GitLab 中进行关闭引用时转换 Jira 议题状态,请选择 启用 Jira 转换。
- 提供 Jira 配置信息:
-
Web URL:您要关联到此极狐GitLab 项目的 Jira 实例 Web 界面的基本 URL,例如
https://jira.example.com
。 -
Jira API URL:Jira 实例 API 的基本 URL,例如
https://jira-api.example.com
。 如果未设置,则默认为 Web URL 值。如果使用 Jira on Atlassian cloud,请留空。 -
用户名或电子邮件:
对于 Jira Server,使用
username
。对于 Jira on Atlassian cloud,使用email
。 -
Password/API token:
为 Jira Server 使用
password
或为 Jira on Atlassian cloud 使用API token
。
-
Web URL:您要关联到此极狐GitLab 项目的 Jira 实例 Web 界面的基本 URL,例如
-
要使用户能够在极狐GitLab 项目中查看 Jira 议题,请选择 启用 Jira 议题,并输入 Jira 项目 key。
您只能显示特定极狐GitLab 项目中单个 Jira 项目的议题。
如果使用此设置启用 Jira 议题,则有权访问此极狐GitLab 项目的所有用户都可以查看指定 Jira 项目中的所有议题。 - 要启用为漏洞创建议题,选择启用从漏洞创建 Jira 议题。
- 选择 Jira 议题类型。如果下拉列表为空,请选择刷新 () 并重试。
- 要验证 Jira 连接是否正常工作,请选择 测试设置。
- 选择 保存更改。
您的极狐GitLab 项目现在可以与您实例中的所有 Jira 项目进行交互,并且该项目现在显示一个 Jira 链接,可以打开 Jira 项目。
在极狐GitLab 中从 Jira Server 迁移到 Jira Cloud
要在极狐GitLab 中从 Jira Server 迁移到 Jira Cloud 并维护您的 Jira 集成:
- 在顶部栏中,选择 主菜单 > 项目 并找到您的项目。
- 在左侧边栏中,选择 设置 > 集成。
- 选择 Jira。
- 在 Web URL 中,输入新的 Jira 站点 URL(例如,
https://myjirasite.atlassian.net
)。 - 在 用户名或电子邮件 中,输入在您的 Jira 个人资料中注册的用户名或电子邮件。
- 创建 API 令牌,并复制该值。
- 在 密码或 API 令牌 中,粘贴 API 令牌值。
- 可选。选择 测试设置 以检查连接是否正常。
- 选择 保存更改。