
docs: 重构文档结构,将README内容拆分到多个文档并优化格式
CNB Code Import(CNB代码仓库批量迁移工具)

- 支持 CODING、GitHub、GitLab、Gitee、Codeup(云效)、CNB、腾讯工蜂以及通用第三方代码托管平台的代码仓库批量迁移至 CNB
- 自动创建 CNB 子组织及仓库(迁移完后的仓库路径为
<CNB根组织>/<源仓库路径>)
- 自动跳过迁移成功的仓库(⚠️依赖工作目录下的
successful.log文件)
- SVN 仓库不支持迁移,请先自行转换为git仓库
-
创建源平台访问令牌
-
CNB 创建根组织
-
创建 CNB 访问令牌
详细步骤
- 超过了单个文件大小限制 500 MiB
可以开启
PLUGIN_MIGRATE_USE_LFS_MIGRATE参数,详见更多参数
- 获取仓库列表失败: The current scope does not support access to this API
检查 PLUGIN_SOURCE_TOKEN 权限是否符合要求,如源平台为 CODING,确保 token 属于团队所有者或团队管理员。
- LFS: Repository or object not found
可以开
PLUGIN_MIGRATE_ALLOW_INCOMPLETE_PUSH详见更多参数
- push 失败:git pull before pushing again
可根据实际情况开启
PLUGIN_MIGRATE_FORCE_PUSH,详见更多参数
- 只迁移部分仓库怎么操作?
设置 PLUGIN_MIGRATE_ALLOW_SELECT_REPOS=true,首次运行后编辑 repo-path.txt,只保留需要迁移的仓库路径即可。
- 如何重新选择迁移仓库?
删除 repo-path.txt 文件,重新运行迁移命令即可。
- repo-path.txt 没有生成?
请确认 PLUGIN_MIGRATE_ALLOW_SELECT_REPOS=true,并确保有写入权限。
- 如何只下载仓库而不推送到 CNB?
设置 PLUGIN_MIGRATE_DOWNLOAD_ONLY=true,该模式下仅执行仓库克隆操作,无需提供 CNB 相关配置,下载完成后会保留工作目录。