Budibase Docker-compose 2.33版本升级迁移指南

Budibase是一个开源的低代码开发平台，近期发布的2.33版本对Docker-compose安装方式进行了重要更新。本文将详细介绍升级过程中可能遇到的问题及解决方案。

问题背景

在Budibase 2.33版本中，Docker-compose安装方式需要进行特定的数据库迁移操作。如果直接升级而不执行迁移步骤，会导致以下问题：

• 所有应用程序无法访问，返回"AppId could not be found"错误
• 用户无法登录系统
• 密码重置功能失效

根本原因

新版本对CouchDB数据库容器进行了重大更新，包括：

1. 使用了新的官方CouchDB镜像
2. 修改了数据库配置参数
3. 调整了容器间的网络通信方式

这些变更要求用户在升级时必须执行特定的迁移步骤，否则会导致系统无法正常工作。

解决方案

推荐方案：使用Budibase CLI工具

最安全可靠的升级方式是使用Budibase官方提供的CLI工具进行升级。该工具会自动处理以下事项：

1. 更新docker-compose.yaml文件
2. 替换正确的CouchDB镜像版本
3. 应用新的数据库配置
4. 确保容器间通信设置正确

手动升级步骤

对于无法使用CLI工具的特殊环境，可以按照以下步骤手动升级：

1. 备份现有数据和配置
2. 更新docker-compose.yaml文件中的CouchDB镜像
3. 修改数据库配置参数
4. 重建并重启容器

注意事项

1. 升级前务必备份所有重要数据
2. 检查网络配置是否与新版本兼容
3. 确保有足够的系统资源完成升级过程
4. 升级后验证所有应用程序和用户功能是否正常工作

总结

Budibase 2.33版本的升级需要特别注意数据库迁移步骤。无论是使用官方CLI工具还是手动升级，都需要确保正确更新了CouchDB相关配置。遵循上述指南可以避免升级过程中常见的问题，确保系统平稳过渡到新版本。