跳到主要内容

数据迁移指南

概述

你可以用 CNB（推荐） 或 COS（适合大文件） 把老版本工作空间的数据迁移到新版本。 本文按“先选方案 → 再按步骤操作”的结构编写，方便快速查阅。

一、先选哪种迁移方式（推荐先看）​

方式适用场景优点推荐指数
CNB 代码仓库迁移以代码为主，希望版本管理/协作步骤少、可回滚、适合团队⭐⭐⭐⭐⭐
COS 对象存储迁移包含大量图片/视频/模型等大文件适合大体积资源，按需下载⭐⭐⭐
常用组合
  • 代码走 CNB，资源走 COS：最省心，也最利于后续协作。

二、迁移前准备（两种方式通用）​

  • 整理项目：删除不需要的临时文件/构建产物（例如 node_modules/、dist/、日志等）。
  • 备份重要数据：迁移前请自行保留一份本地/其他存储备份。
  • 检查敏感信息：不要把 .env、密钥、Token 等提交到仓库或上传到公开位置。

三、方式一：CNB 代码仓库迁移（推荐）​

1）在 CNB 创建仓库与访问令牌​

  1. 注册/登录 CNB：https://cnb.cool/
  2. 创建一个新仓库（空仓库即可）。
  1. 创建访问令牌（用于 git push）：
注意

Token 相当于密码，请妥善保管，不要写进代码仓库。

2）在老版本工作空间推送代码到 CNB​

在老版本工作空间终端执行（把仓库地址替换成你的）：

# 1) 初始化仓库
git init .

# 2) 添加远程仓库（替换为你的仓库地址）
git remote add origin https://cnb.cool/your-username/your-repo.git

# 3) 配置提交信息（仅对当前仓库生效）
git config --local user.name "你的名称"
git config --local user.email "你的邮箱"

# 4) 提交并推送
git add .
git commit -m "数据迁移：从老版本迁移"

# 默认分支可能是 main 或 master，按你的仓库实际分支名调整
git push -u origin main
如果 push 要你输入账号密码
  • Username：填写 CNB 页面展示的 Git Username
  • Password：填写你创建的 Token

推送成功后，刷新 CNB 仓库页面确认文件已上传。

3）在新版本 Cloud Studio 导入/克隆项目​

在新版本创建应用时选择“从仓库导入/克隆”，详细入口参考：应用创建文档 中的 （二）选择创建方式。

四、方式二：COS 对象存储迁移（适合大文件/资源文件）​

1）准备 COS：创建存储桶并获取密钥​

  1. 创建 COS 存储桶：登录 腾讯云 COS 控制台 创建存储桶（建议权限选“私有读写”）。
  1. 获取访问密钥：前往 访问管理控制台 获取 SecretId 与 SecretKey。
注意

SecretId/SecretKey 属于敏感信息：不要提交到代码仓库，也不要发到群里或贴到文档中。

2）安装 coscmd（在需要上传/下载的工作空间执行）​

确保你有 python3 与 pip，然后执行：

python3 -m pip install -U coscmd

3）配置 coscmd​

coscmd config -a <SECRET_ID> -s <SECRET_KEY> -b <BucketName-APPID> -r <REGION>
  • <BucketName-APPID>：存储桶名称（带 appid）
  • <REGION>：存储桶地域（如 ap-shanghai）

4）上传老版本数据到 COS​

# 上传文件夹（示例：把本地 nest-demo 目录上传到 COS 的 data/ 下）
coscmd upload -r nest-demo data/

上传完成后，在 COS 控制台确认文件已存在。

5）在新版本下载数据​

在新版本工作空间终端执行：

# 下载文件夹（示例：把 COS 的 nest-demo/ 下载到当前目录）
coscmd download -r nest-demo/ nest-demo/

五、常见问题（FAQ）​

问题快速解决
Git push 失败检查网络；确认仓库地址正确；输入的是 Git Username + Token（不是登录密码）
仓库提示文件过大把大文件从仓库中移除（加入 .gitignore），改用 COS 迁移资源文件
权限错误 / 404确认 CNB 仓库权限；确认 Token 有效；确认远程地址属于当前账号/组织
coscmd 命令未找到重新安装：python3 -m pip install -U coscmd
COS 上传/下载慢优先选择就近地域；分批上传；避免一次性传超大目录

六、更多帮助​