Linux环境下ClearCase迁移至Git再到Bitbucket的步骤与命令咨询

一、环境准备 #

• 安装必备工具：确保Linux系统已安装 git 和 ClearCase 客户端（需包含 cleartool 命令）
• 权限验证：执行 cleartool ls /path/to/your/vob 确认可正常访问目标ClearCase VOB
• 挂载VOB（若未自动挂载）：mount -t vob /dev/vob0 /mnt/cc-vob（具体设备路径根据实际环境调整）

二、导出ClearCase历史到Git #

方法1：使用git-clearcase插件（推荐） #

1. 安装git-clearcase插件：
   获取插件源码并编译安装，确保git clearcase命令可全局调用。
2. 创建并初始化Git仓库：

   mkdir cc-migrated-repo && cd cc-migrated-repo
   git init
   

3. 关联ClearCase VOB并导入完整历史：

   git remote add clearcase /mnt/cc-vob/your/project/path
   git fetch clearcase
   git checkout master
   

   该操作会自动同步ClearCase的分支、标签及所有历史提交到Git仓库。

方法2：手动迁移（适合自定义迁移规则） #

1. 创建ClearCase快照视图并拉取代码：

   cleartool mkview -snapshot -tag cc-migrate-view /tmp/cc-view
   cleartool mount /mnt/cc-vob
   cleartool update /tmp/cc-view/your/project/path
   

2. 初始化Git仓库并提交基线版本：

   mkdir git-repo && cd git-repo
   git init
   cp -r /tmp/cc-view/your/project/path/* .
   git add .
   git commit -m "Initial import: ClearCase baseline version"
   

3. 批量导入历史变更：
   使用cleartool lshistory获取所有变更记录，编写脚本批量生成Git提交（示例逻辑）：

   cleartool lshistory -fmt "%n %d %u %c\n" /tmp/cc-view/your/project/path | while read line; do
       # 解析变更信息：文件名、日期、用户、注释
       filename=$(echo "$line" | awk '{print $1}')
       change_date=$(echo "$line" | awk '{print $2 " " $3}')
       author=$(echo "$line" | awk '{print $4}')
       commit_msg=$(echo "$line" | cut -d' ' -f5-)
       
       # 拉取对应版本的文件
       cleartool get -version "$filename@/main/$(cleartool lsvtree -short "$filename" | tail -n1)" "$filename"
       git add "$filename"
       # 设置提交日期和作者
       GIT_COMMITTER_DATE="$change_date" git commit -m "$commit_msg" --author="$author <$author@your-domain.com>" --date="$change_date"
   done
   

   注意：需根据实际ClearCase版本路径格式调整脚本，确保能正确拉取对应版本的文件。

三、Git仓库验证与清理 #

• 检查历史完整性：git log --oneline 确认提交记录与ClearCase历史匹配
• 清理临时文件：git clean -fd 删除未跟踪的冗余文件
• 验证分支标签：git branch -a 和 git tag -l 确认分支、标签已正确导入

四、推送到Bitbucket #

1. 在Bitbucket创建空Git仓库（不要初始化README）
2. 添加Bitbucket远程仓库地址：

   # SSH方式（推荐）
   git remote add bitbucket git@bitbucket.org:your-username/your-repo.git
   # 或HTTPS方式
   git remote add bitbucket https://your-username@bitbucket.org/your-username/your-repo.git
   

3. 推送所有分支和标签：

   git push --all bitbucket
   git push --tags bitbucket
   

4. 登录Bitbucket仓库页面，确认所有历史、分支、标签已同步完成

内容的提问来源于stack exchange，提问作者Karthick Veeramani