---
url: /zh/guide/migration-tools.md
description: |
  介绍 CNB 平台提供的迁移工具，包括代码仓库批量迁移、Git 跨平台同步、 制品迁移及项目协同数据迁移工具。
---
## CNB Code Import

批量迁移代码仓库至 CNB，支持从 GitHub、GitLab、Gitee 等平台导入。

工具地址：
<https://cnb.cool/cnb/plugins/cnbcool/code-import>

## Git Sync

跨平台代码同步插件，用于自动同步不同 Git 平台的代码。

工具地址：
<https://cnb.cool/cnb/plugins/tencentcom/git-sync>

## 制品迁移工具

从其他制品仓库迁移 Maven、npm、Composer、NuGet 类型制品至 CNB。

工具地址：
<https://cnb.cool/cnb/plugins/cnbcool/artifact-migrate>

## 项目协同迁移工具

把 `CODING` 的项目协同数据迁移至 TAPD 或 CNB。

工具地址：
<https://cnb.cool/CODING/tool/migrate-collaboration>

## 迁移示例

以「完整迁移（保留所有历史）」为例，将 GitHub 上的公开仓库完整迁移到 CNB：

```bash
# 1. 克隆裸仓库
git clone --bare https://github.com/example/example-repo.git

# 2. 推送到 CNB（--mirror 会同步所有分支和标签）
cd example-repo.git
git push --mirror https://cnbprod.alpha.qq.com/my-group/example-repo.git

# 3. 清理临时文件
cd .. && rm -rf example-repo.git
```

`git push --mirror` 会推送远端所有分支与标签，适合整体搬迁；
若只想迁移指定分支，可用普通 clone 后逐个 `git push` 指定分支。
