跳到主要内容
支持地域：上海

微搭私有部署版本升级指南

本文档将指导您完成微搭私有部署的版本升级操作，确保升级过程安全可靠。

升级前准备​

License 状态检查​

重要提醒

License 未过期的用户：可直接跳转到 步骤 3：数据备份 开始执行升级流程。

License 已过期的用户：需要从步骤 1 开始，先更新 License 后再进行升级。

升级步骤​

步骤 1：获取最新版本 License​

如果您的 License 已过期，请先进行续期操作：

👉 前往 License 续期指南 完成续期

License 版本说明
  • 社区版 License：功能上有所限制(仅支持 1 个开发者和 1 个正式应用发布)
  • 套餐详情：查看 官网套餐信息
  • 升级建议：如需更多功能，请购买企业版 License

步骤 2：更新 License 文件​

将续期后的 License 更新到系统中：

  1. 切换到微搭安装目录

    cd /data/tencent/weda  # 单机版默认安装目录

  2. 编辑 License 文件

    vim LICENSE.txt

  3. 替换 License 内容

    • 删除原有的 License 内容
    • 粘贴步骤 1 中获取的新 License
    • 保存并退出编辑器
注意事项
  • 确保 License 内容完整，无多余的空格或换行符
  • 单机版默认安装目录为 /data/tencent/weda，请根据实际情况调整

步骤 3：数据备份​

升级前必须进行数据备份，以防数据丢失：

内置数据备份​

# 1. 切换到微搭安装目录
cd /data/tencent/weda

# 2. 备份整个数据目录
cp -r weda weda-bak

# 3. 确认备份完成
ls -la weda-bak/

外部数据库备份​

外部数据库用户

如果您使用的是外部 MySQL 数据库，请使用数据库管理工具自行备份 MySQL 数据。

MySQL 备份示例：

# 备份指定数据库
mysqldump -u username -p database_name > backup_$(date +%Y%m%d_%H%M%S).sql

# 备份所有数据库
mysqldump -u username -p --all-databases > full_backup_$(date +%Y%m%d_%H%M%S).sql

步骤 4：下载最新安装包​

下载并执行最新版本的安装脚本：

wget -L -O install.sh https://software-1302110647.cos.ap-guangzhou.myqcloud.com/rc/lastest/install.sh && chmod +x install.sh && ./install.sh

下载过程说明：

  1. 下载最新的安装脚本
  2. 添加执行权限
  3. 自动执行安装程序

步骤 5：升级​

执行升级：

# 切换到微搭目录
cd /data/tencent/weda

# 执行升级校验
./upgrade.sh

校验结果处理​

校验结果说明
  • 校验成功：等待升级完成即可
  • 出现 "EnvId not match" 错误：需要继续执行步骤 6 和步骤 7 进行数据迁移

步骤 6：数据迁移（仅在校验失败时执行）​

如果步骤 5 出现 "EnvId not match" 错误，需要执行数据迁移：

# 在微搭目录下执行数据迁移
./envmigrate

迁移过程：

  • 系统会自动迁移现有数据到新版本格式
  • 请耐心等待迁移完成，不要中断进程

步骤 7：完成升级（仅在执行步骤 6 后）​

数据迁移完成后，重新执行步骤5：

步骤 8：重新发布应用​

升级前如果涉及HTTP配置更新, 则升级完成后，需要重新发布已有的应用：

  1. 登录微搭管理控制台
  2. 进入应用管理页面
  3. 逐个重新发布现有应用
应用发布说明
  • 如果没有已发布的应用，可以跳过此步骤
  • 重新发布是为了确保应用与新版本完全兼容
  • 发布过程中如遇问题，请检查应用配置是否正确

特殊情况处理​

腾讯云轻量应用服务器用户​

如果您使用的是 腾讯云轻量应用服务器微搭应用模板，需要在升级前执行特殊配置：

# 设置轻量应用服务器环境变量
export LH_ENABLED="true"

# 然后正常下载 install.sh 文件进行升级
wget -L -O install.sh https://software-1302110647.cos.ap-guangzhou.myqcloud.com/rc/lastest/install.sh && chmod +x install.sh && ./install.sh

常见问题解答【针对License降配】​

License降配注意事项
  • 这里是指新买的License比原来的License开发者和应用数少于之前配置

Q1：升级后多个开发者还能继续使用吗？​

问题描述： 升级前有多个开发者，升级后是否还能正常使用？

答案：

  • 开发工具：升级后无法使用开发工具，需要删除多余的开发者后才能继续使用
  • 已有应用：原来的应用不受影响，可以正常访问和使用
  • 解决方案：在用户管理中删除多余的开发者，保留符合 License 限制的开发者数量

Q2：升级后多个应用还可以继续使用吗？​

问题描述： 升级前发布了多个应用，升级后是否还能正常使用？

答案：

  • 应用访问：已发布的应用不受影响，用户可以正常访问
  • 应用发布：无法发布新的应用，需要删除多余应用或升级 License
  • 解决方案：删除多余应用保持在 License 限制范围内，或购买企业版 License

升级验证​

升级完成后，建议进行以下验证：

1. 系统状态检查​

# 检查服务状态
docker ps

# 检查日志
docker logs <container_name>

2. 功能验证​

  1. 登录验证：确认能够正常登录管理控制台
  2. 应用访问：验证已发布的应用能够正常访问
  3. 开发工具：确认开发工具功能正常
  4. 数据完整性：检查应用数据是否完整

3. 性能检查​

  • 检查系统响应速度
  • 验证应用加载时间
  • 确认数据库连接正常

回滚方案​

如果升级过程中出现问题，可以使用备份数据进行回滚：

# 停止当前服务
docker-compose --profile all down

# 恢复备份数据
rm -rf weda
mv weda-bak weda

# 重新启动服务
./upgrade.sh
回滚注意事项
  • 回滚会丢失升级后的所有数据变更
  • 建议在确认升级完全失败后再进行回滚
  • 回滚前请联系技术支持获取专业建议

总结​

通过以上步骤，您已经成功完成了微搭私有部署的版本升级：

  1. ✅ 更新了 License（如需要）
  2. ✅ 完成了数据备份
  3. ✅ 下载并安装了最新版本
  4. ✅ 执行了升级校验和数据迁移
  5. ✅ 重新发布了应用
  6. ✅ 处理了特殊情况和常见问题

现在您可以享受新版本带来的功能改进和性能提升。如果在升级过程中遇到任何问题，请及时联系技术支持团队。