Jira 迁移工具¶
Jira 迁移工具把 Jira Cloud 或 Jira Data Center 中的项目、工作项（Issue）、评论、变更历史、附件等内容复制到 Specivo。它用你自己的凭据，通过 Jira 的公开 REST API 读取数据，然后生成一个 Specivo 导入包：一个由纯文件组成的文件夹（或 .zip 压缩包）。之后由 Specivo 校验并加载这个导入包。
Jira --REST API--> specivo-jira-migration --> import bundle --> Specivo
(this tool, on your machine) (files) (validate, dry run, import)
工具不会修改 Jira 中的任何内容。凭据只保存在你的机器上，不会写入导入包、日志或工具的工作文件。
与 Atlassian 无关
本工具与 Atlassian 没有任何关联，也未获其认可。“Jira” 是 Atlassian 的商标，这里仅用来说明工具读取的是哪个系统。
准备条件¶
| 要求 | |
|---|---|
| Specivo | 0.11.0 或更高版本，用于加载导入包（导入包格式 1.0）。 |
| 运行工具的机器 | Python 3.12 或更高版本，以及足够的磁盘空间存放要迁移的附件。只需要能访问 Jira 的网络。 |
| Jira Cloud | REST API v3。一个带 API token 的账户。 |
| Jira Data Center（或 Server） | 8.14 或更高版本，这些版本支持个人访问令牌。工具使用 REST API v2。 |
| Jira 账户的权限 | 见下表。 |
Jira 账户需要的权限¶
这个账户只做只读访问，Jira 让它看到什么，它就只能读到什么，因此请使用一个能看到所有待迁移项目的账户。
| Jira 中的权限 | 用途 | 缺少时的后果 |
|---|---|---|
| 每个项目上的 Browse projects（浏览项目）及工作项级别的查看权限 | 项目、工作项、评论、历史、附件 | 找不到该项目，工具报用法错误并停止。 |
| Administer Jira（管理 Jira，仅 Jira Cloud） | 读取每个自定义字段的适用范围（即字段上下文） | 工具记录一次拒绝访问，并把该字段应用到工作项用到它的那些项目上。 |
| View voters and watchers（查看投票者和关注者） | 列出工作项的关注者 | 关注者只被计数，不会迁移。导出继续进行。 |
| 对项目看板的访问权限（Jira Software） | 从看板读取冲刺 | 只迁移工作项中提到的冲刺。工具会统计每个无法读取的看板。 |
迁移流程¶
- 安装工具。
- 提供凭据，让工具能访问你的 Jira 站点。
- 导出：先用少量工作项试一次，再导出整个站点或逐个项目导出。
- 在 Specivo 中校验、预演并加载导入包。
- 阅读报告。工具无法迁移的内容都会在导入包的清单（manifest）中计数，Specivo 也会把它们列在导入报告里。参见哪些内容不会迁移。
- 正式切换前再导出一次，加载新的导入包以补上这段时间的变更。具体做法见加载页面。
文档目录¶
Specivo 这一侧的导入操作，请参阅 Specivo 用户指南中的从其他项目管理系统导入。导入包格式的规范见 Specivo 仓库中的 docs/import-bundle/v1.md。