Jira Data Center¶
本工具支持 Jira Data Center（以及 Jira Server）8.14 及更高版本，这是最早支持个人访问令牌的版本。
与 Jira Cloud 的差异¶
| Jira Cloud | Jira Data Center | |
|---|---|---|
| 凭据 | 电子邮件地址和 API 令牌 | 个人访问令牌（JIRA_PAT） |
| REST API | v3 | v2 |
| 文本格式 | Atlassian Document Format，由本工具转换 | Wiki 标记语法，由 jira2markdown 转换 |
| 事务搜索 | POST /rest/api/3/search/jql，按 token 分页 |
/rest/api/2/search，按偏移量分页 |
| Epic 下的子事务 | 通过 parent 字段 |
通过 Epic Link（Epic 链接）字段，读取方式相同 |
| 人员 | 以账户 ID 标识 | 以用户 key 标识 |
| 自定义字段上下文 | 读取，需要 Administer Jira（管理 Jira）权限 | 不读取。某个字段被哪些项目的事务使用，就视为适用于哪些项目。 |
| 正文中的图片 | 通过 media id 与附件关联 | 按文件名引用（!file.png!、[^file.txt]） |
其余部分两者完全一致。哪些内容会迁移 一页同时覆盖这两种版本。
示例¶
export JIRA_URL=https://jira.example.com
export JIRA_PAT=your_personal_access_token_here
specivo-jira-migration --project SUP --out jira-export --validate
生命周期终止¶
Atlassian 已宣布 Data Center 将逐步退役：新客户不能再购买，现有客户只能在限定时间内续订，之后产品即进入生命周期终止。截至本文撰写时，Atlassian 公布的日期如下：
| 里程碑 | 日期 |
|---|---|
| 停止向新客户销售 | 2026 年 3 月 30 日 |
| 现有客户最晚可续订至 | 2029 年 3 月 28 日 |
| 生命周期终止 | 2029 年 3 月 28 日 |
这些日期可能会调整，请以 Atlassian 的 Data Center 生命周期终止页面 为准。如果你正在运行 Data Center 并计划迁出，建议尽早做一次试导出。导出和加载可以反复进行，次数不限，后续再导出 时只会补充新增的内容。