logo
0
0
Login
ForkfromCODING/tool/migrate-collaboration, behind:main114 commits
kevinkfxu<kevinkfxu@tencent.com>
fix: 云开发镜像地址修复

项目协同迁移工具

badge badge badge

这是一个用于迁移项目协同数据的工具,支持在不同平台之间迁移项目、事项、属性等信息。

一、迁移教程

1.🔥🔥🔥🔥最新迁移姿势(云原生开发,不需要环境,不需要Docker知识)🔥🔥🔥🔥

  • 1.fork本仓库到你任意组织下
  • 2.点击一键部署迁移按钮
  • 3.在弹窗中填写token等信息
  • 4.开始迁移

2.传统迁移姿势,使用Docker在Linux部署(arm架构和windows系统的镜像正在开发中)

docker run -d -p 8088:8088 \ -e CODING_TOKEN="xx" \ -e TAPD_TOKEN="xx" \ -e TAPD_USER="xx" \ -e TAPD_COMPANY_ID="xx" \ -e CNB_TOKEN="xx" \ -e CNB_ROOT_ORGANIZATION="xx" \ --name migrate-collaboration-web \ docker.cnb.cool/coding/tool/migrate-collaboration/web:latest

二、当前支持迁移什么数据?

1.CODING -> TAPD(需要手动创建TAPD工作空间)

  • ✅ Issue,需要手动映射(包含用户故事、需求、自定义需求、缺陷、任务、自定义任务、史诗、子工作项)
  • ✅ 系统字段、自定义字段
  • ✅ 需求状态(包含自定义状态,但不包含工作流里面的流程和事件,注意:TAPD内任务不支持自定义工作流,可以用自定义需求代替)
  • ✅ 版本(TAPD分为发布计划和发布版本,需要手动映射)
  • ✅ 图片、附件(需开通权限)
  • ✅ 迭代
  • ✅ 需求描述
  • ❌ wiki(开发中)
  • ❌ 需求评论(排期中)
  • ❌ 配置方案
  • ❌ 项目集

2.CODING -> CNB(需要手动创建组织,程序会自动创建同名仓库)

  • ✅ Issue
  • ✅ 系统字段

三、环境变量说明

环境变量说明是否必填
CODING_TOKENCODING平台的访问令牌是(如需迁移CODING数据)
TAPD_TOKENTAPD平台的访问令牌是(如需迁移到TAPD)
TAPD_USERTAPD平台的用户名是(如需迁移到TAPD)
TAPD_COMPANY_IDTAPD平台的公司ID是(如需迁移到TAPD)
CNB_TOKENCNB平台的访问令牌是(如需迁移到CNB)
CNB_ROOT_ORGANIZATIONCNB平台的根组织是(如需迁移到CNB)
PORTWeb应用的监听端口否(默认为8088)

访问Web应用

构建并运行容器后,可以通过浏览器访问:

http://localhost:8088

配置文件示例(config.yml)

http: port: 8088 platforms: coding: token: "your-coding-token" tapd: token: "your-tapd-token" user: "your-tapd-user" companyID: your-tapd-company-id cnb: token: "your-cnb-token" root_organization: "your-cnb-organization"

注意事项

  1. 目标平台为TAPD时,请确定目标项目内至少有一个需求类型
  2. 目标平台为TAPD时,需求类型需要手动映射(A需求类型 -> B需求类型)
  3. 目标平台为TAPD时,需求属性、状态会自动同名迁移
  4. 目标平台为TAPD时,默认没有上传附件的权限,需要联系TAPD开通(也可直接在仓库内提交Issue,附上tapd的user即可)

About

Coding项目协同数据迁移工具

Language
Go88.9%
Assembly8.2%
Markdown1.5%
HTML0.3%
Others1.1%