Help us learn about your current experience with the documentation. Take the survey.

将您的 Jira 项目问题导入 GitLab

  • Tier: 免费、高级、旗舰
  • Offering: GitLab.com、GitLab 自托管、GitLab 专用

使用 GitLab Jira 导入工具，您可以将 Jira 问题导入到 GitLab.com 或 GitLab 自托管版本。

Jira 问题导入是一个 MVC（模型-视图-控制器）级别的项目功能，意味着可以将多个 Jira 项目的问题导入到一个 GitLab 项目中。MVC 版本会将问题标题、描述以及一些其他问题元数据作为问题描述的一部分进行导入。

已知限制

GitLab 直接导入以下信息：

  • 问题的标题、描述和标签。
  • 在准备导入时，您还可以将 Jira 用户映射到 GitLab 项目成员。

未正式映射到 GitLab 问题字段的其他 Jira 问题元数据会作为纯文本导入到 GitLab 问题的描述中。

Jira 问题中的文本不会解析为 GitLab 风格的 Markdown，这可能导致文本格式损坏。 更多信息，请参见 issue 379104。

有一个 epic 跟踪记录了 GitLab Jira 导入工具未来迭代中问题指派人、评论等更多功能的添加。

先决条件

  • 要能够从 Jira 项目导入问题，您必须对 Jira 问题有读取权限，并且至少拥有要导入到的 GitLab 项目的 Maintainer（维护者）角色。
  • 此功能使用现有的 GitLab Jira 问题集成。 在尝试导入 Jira 问题之前，请确保已设置好集成。

将 Jira 问题导入 GitLab

导入 Jira 问题是通过异步后台作业完成的，这可能会导致因导入队列负载、系统负载或其他因素而出现延迟。 导入大型项目可能需要几分钟时间，具体取决于导入的大小。

要将 Jira 问题导入 GitLab 项目：

  1. 在 issues Issues 页面上，选择 Actions（ ellipsis_v ）> Import from Jira。

    从 Jira 导入问题按钮

    只有当您拥有 正确的权限 时，Import from Jira 选项才可见。

    会出现以下表单。 如果您之前设置了 Jira 问题集成，现在可以在下拉列表中看到您有权访问的 Jira 项目。

    从 Jira 导入问题表单

  2. 选择 Import from 下拉列表，然后选择您希望从中导入问题的 Jira 项目。

    在 Jira-GitLab user mapping template 部分，表格显示了您的 Jira 用户映射到哪些 GitLab 用户。 当表单出现时，下拉列表默认为执行导入的用户。

  3. 要更改任何映射，请在 GitLab username 列中选择下拉列表，然后选择您想要映射到每个 Jira 用户的用户。

    下拉列表可能不会显示所有用户，因此请使用搜索栏在此 GitLab 项目中查找特定用户。

  4. 选择 Continue。您会收到导入已开始的确认。

    在导入在后台运行时，您可以导航到 Issues 页面，查看列表中出现的新问题。

  5. 要检查导入状态，请再次转到 Jira 导入页面。