跳到主要内容

云开发跨环境资源迁移

本文档提供云开发环境之间的数据和配置迁移方案，帮助您将资源从一个环境迁移到另一个环境。

概述​

云开发目前不支持一键迁移功能，需要按模块逐个手动迁移数据和配置。迁移过程涉及以下模块：

  • 文档型数据库：数据模型、集合数据
  • MySQL 数据库：数据模型、数据表
  • 云函数：函数代码和配置
  • 云托管：服务代码和配置
  • 云存储：存储桶文件
  • 静态网站托管：托管文件
  • 微搭应用：低代码应用

迁移前准备​

在开始迁移前，请确保：

  1. 确认目标环境：已创建目标云开发环境，并获取环境 ID
  2. 权限检查：确保您在源环境和目标环境都具有相应的操作权限
  3. 安装 CLI 工具（可选）：部分迁移操作需要使用 云开发 CLI 工具

⚠️ 重要提示：

  • 迁移过程不会自动删除源环境的数据，请放心操作
  • 部分资源（如数据库权限、索引）需要在目标环境手动重新配置

文档型数据库迁移​

文档型数据库支持两种数据组织方式，迁移方法有所不同：

方式一：数据模型迁移​

如果您是通过「数据模型」创建的数据源，只需导出导入数据模型表结构和数据即可，操作简单高效。

1. 导出数据模型​

  1. 访问 云开发平台/文档型数据库/数据模型
  2. 选择需要迁移的数据模型
  3. 导出数据：
    • 切换到「管理数据」选项卡
    • 点击「批量导出数据」，选择「全部数据」
    • 若数据量超过 10 万条，需要分批导出（单次导出上限为 10 万条）
  4. 导出模型配置：
    • 切换到「配置模型」选项卡
    • 点击「导出模型配置」按钮

2. 导入数据模型​

  1. 进入目标环境的 数据模型管理页面
  2. 按照导出的相反顺序进行导入：
    • 先导入「模型配置」
    • 再导入「数据」

⚠️ 关联关系字段注意事项：

如果数据模型中包含关联关系字段（如多对一、一对多），必须按照依赖顺序导入，否则会报错：

  • 被关联的模型：必须先导入（例如：用户模型）
  • 包含关联字段的模型：后导入（例如：订单模型关联用户）

示例：订单模型有一个"用户"字段（多对一关联用户模型），导入顺序应为：

  1. 先导入「用户」模型
  2. 再导入「订单」模型

方式二：数据集合迁移​

如果您是直接创建集合进行操作，则需要导出集合数据。

1. 导出集合数据​

  1. 访问 云开发平台/文档型数据库/集合管理
  2. 选择需要导出的集合，点击「导出」按钮
  3. 导出格式：选择 JSON 格式（必须）
  4. 若导出的数据文件超过 50 MB，需要分批导出：
    • 推荐按照创建时间等字段分批导出
    • 确保单个数据文件小于 50 MB

2. 导入集合数据​

  1. 进入目标环境的集合管理页面
  2. 创建同名集合（如不存在）
  3. 选择集合，点击「导入」按钮，上传导出的 JSON 文件

⚠️ 注意：

  • 数据库权限规则需要在目标环境重新手动配置
  • 数据库索引需要在目标环境重新手动创建
  • 建议先迁移少量数据进行测试，确认无误后再批量迁移

MySQL 数据库迁移​

MySQL 数据库同样支持两种迁移方式，根据您的数据组织方式选择对应的迁移方法。

方式一：数据模型迁移​

如果您是通过「数据模型」创建的数据源，可以使用数据模型的导入导出功能进行迁移。

操作步骤参考 文档型数据库/数据模型迁移，流程完全一致。

方式二：数据表迁移​

如果您是直接创建数据表进行操作，需要通过 DMC 数据库管理平台进行导出和导入。

1. 导出数据表​

  1. 访问 云开发平台/MySQL 数据库/数据库设置
  2. 在「账号管理」模块创建数据库账号（如已创建可跳过）
  3. 点击「数据库管理」按钮，进入 DMC 数据库管理平台
  4. 在 DMC 平台中进行数据导出操作

详细的导入导出操作方法，请参考 MySQL 数据库/DMC 数据库管理/导入导出

2. 导入数据表​

  1. 进入目标环境的 DMC 数据库管理平台
  2. 使用导入功能上传导出的数据文件

⚠️ 注意：

  • 数据库权限规则需要在目标环境重新手动配置
  • 数据库索引需要在目标环境重新手动创建
  • 导入前请确保目标数据库有足够的存储空间

云函数迁移​

云函数迁移包括函数代码和配置的迁移，支持控制台操作和 CLI 命令两种方式。

方式一：控制台操作​

1. 导出云函数代码​

  1. 访问 云开发平台/云函数
  2. 点击需要迁移的「函数名称」，进入函数详情页
  3. 切换到「函数代码」选项卡
  4. 在下方「灰度配置」区域，选择 $LATEST 版本
  5. 点击「下载」按钮，下载函数代码包（.zip 格式）

2. 导入云函数代码​

  1. 进入目标环境的 云函数管理页面
  2. 点击「新建云函数」
  3. 选择「代码包创建」方式
  4. 上传导出的代码包（.zip 文件）
  5. 配置函数的运行时环境、内存、超时时间等参数
  6. 点击「完成」创建函数

💡 提示：如果函数使用了环境变量，需要在目标环境重新配置。

方式二：CLI 命令操作​

使用 CLI 工具可以更高效地批量迁移云函数。

1. 下载云函数代码​

使用 CLI 命令下载函数代码：

# 下载到默认目录
tcb fn code download <functionName>

# 下载到指定目录
tcb fn code download <functionName> <destPath>

示例：

# 下载 login 函数到当前目录
tcb fn code download login

# 下载到指定目录
tcb fn code download login ./functions/login

详细说明请参考 CLI/云函数代码管理

2. 部署云函数代码​

在目标环境中部署云函数：

# 部署指定函数
tcb fn deploy <functionName>

# 部署 functions 目录下的所有函数
tcb fn deploy

示例：

# 切换到目标环境
tcb env:switch <目标环境ID>

# 部署函数
tcb fn deploy login

详细说明请参考 CLI/云函数部署

⚠️ 注意：

  • 迁移前请确认函数的运行时版本在目标环境中是否支持
  • 函数触发器需要在目标环境重新配置
  • 函数环境变量需要在目标环境重新设置

云托管服务迁移​

云托管服务的迁移需要导出服务代码，然后在目标环境重新部署。

方式一：CLI 命令导出​

1. 导出云托管代码​

使用 CLI 命令下载云托管服务代码：

tcb cloudrun download -s <服务名称> --targetPath <目标路径> --force

参数说明：

  • -s：指定要下载的服务名称
  • --targetPath：指定代码保存的本地路径
  • --force：强制覆盖已存在的文件

示例：

# 下载 api-service 服务到 ./cloudrun/api-service 目录
tcb cloudrun download -s api-service --targetPath ./cloudrun/api-service --force

详细说明请参考 CLI/云托管代码管理

2. 部署到目标环境​

方式 1：控制台上传代码包

  1. 进入目标环境的 云托管管理页面
  2. 新建云托管服务
  3. 选择「代码包创建」方式
  4. 上传导出的代码包（.zip 格式）
  5. 配置服务的 CPU、内存、实例数等参数
  6. 完成创建和部署

方式 2：CLI 命令部署

# 切换到目标环境
tcb env:switch <目标环境ID>

# 在服务代码目录下执行部署命令
cd ./cloudrun/api-service
tcb cloudrun deploy

详细说明请参考 CLI/云托管代码部署

⚠️ 注意：

  • 云托管服务的环境变量需要在目标环境重新配置
  • 服务访问路径和域名配置需要重新设置
  • 确保目标环境的配额足够支持新服务的运行

云存储文件迁移​

云存储使用腾讯云对象存储（COS）作为底层存储服务，可以通过 COS 数据迁移工具进行文件迁移。迁移方式请参考 迁移数据到云存储 ，以下为云迁移工具使用示例：

迁移步骤​

1. 获取密钥参数​

  1. 登录环境对应的腾讯云账号

  2. 获取腾讯云账号的 SecretId、SecretKey、appid

在腾讯云控制台 账号/访问管理/访问密钥 中，创建新的api密钥，并记录保存好。另外注意使用的账号，是管理员账号、或者具备cos 管理权限的账号。 同时记录好 appid

2. 获取桶参数​

  1. 登录 云开发/云存储 获取桶名

  1. 将获取到的桶名，拼接上 “-appid”，例如：
    桶名 test-8glifaws3cbexxxx
    appid 1255690679
    -------------------------
    拼接后的桶名为 test-8glifaws3cbexxxx-1255690679

3. 执行数据迁移​

详情参考 COS 之间数据迁移 文档

  1. 登录 云迁移控制台
  2. 在左侧导航栏中单击「对象存储迁移」，进入对象存储迁移页面
  3. 单击「新建任务」，新建迁移任务并配置任务信息
  4. 启动任务

⚠️ 注意：迁移桶名称选择「输入源桶名称」，名称从第二步中获取

静态网站托管迁移​

静态网站托管同样使用腾讯云对象存储（COS）服务，迁移方法与云存储类似。

迁移步骤​

1. 查看源环境托管存储桶名称​

  1. 访问 云开发平台/静态网站托管/文件管理
  2. 记录页面显示的「存储桶名称」

2. 执行数据迁移​

参考 COS 之间数据迁移 文档进行文件迁移。

3. 重新配置域名（如有）​

如果您为静态网站托管配置了自定义域名，需要在目标环境重新进行域名配置：

  1. 进入目标环境的静态网站托管设置
  2. 添加自定义域名
  3. 配置 DNS 解析，将域名指向目标环境

⚠️ 注意：

  • 迁移后需要重新配置自定义域名和 SSL 证书
  • 如果使用了 CDN 加速，需要在目标环境重新配置

微搭应用迁移​

微搭低代码应用支持通过模板的方式进行迁移。

迁移步骤​

1. 导出微搭应用模板​

  1. 访问 云开发平台/微搭低代码/自建模板管理
  2. 点击「新建」按钮，创建新模板
  3. 进入「模板详情」页面，添加需要导出的应用资源
  4. 回到模板列表页，点击对应模板的「导出」按钮
  5. 选择「导出标准化部署包」
  6. 在「模板详情」中切换到「版本」选项卡
  7. 点击最新版本的「下载」按钮，下载部署包

2. 导入到目标环境​

  1. 进入目标环境的 微搭低代码控制台
  2. 使用下载的部署包创建新应用
  3. 配置应用的相关参数和资源绑定
  4. 发布应用