本文主要指导用户将ack-dify从旧版本升级至v1.0.0及以上，首先备份数据，然后通过命令提取并安装插件迁移工具至插件系统，最后验证插件功能是否正常运行，以启用新的插件生态系统。
适用版本
当前版本： < v1.0.0
目标版本： >= v1.0.0
1. 数据备份
使用备份中心备份ack-dify数据，备份命名空间：dify-system，详细操作步骤，请参见立即备份。
2. 升级 ack-dify
登录容器服务管理控制台，在左侧导航栏选择集群列表。单击目标集群名称，进入集群详情页面，依次单击应用 > Helm，找到ack-dify单击更新组件。然后选择版本为最新版本，单击确定即可完成ack-dify组件更新。
3. Plugin 迁移
3.1 进入 ack-dify API 容器
kubectl exec -it <ack-dify-api-xxxxx-xxxxx> -n dify-system -- bash3.2 提取 Plugins
poetry run flask extract-plugins --workers=20如果有提示需要输入，请按 Enter 跳过。
3.3 安装 Plugins
poetry run flask install-plugins --workers=2确保您的网络能访问公共互联网，并能访问 https://marketplace.dify.ai。
4. 数据迁移
为了未来能更好的兼容，请您在确认不会回退到旧版本后，运行以下数据迁移命令。
poetry run flask migrate-data-for-plugin5. 确认升级成功
访问 Dify 平台。
检查Dify平台中插件是否已正确安装。
随机测试一个插件的功能，若功能正常则说明升级迁移成功。
回退方法
如果需要回退到旧版本：
登录容器服务管理控制台，在左侧导航栏选择集群列表。单击目标集群名称，进入集群详情页面，依次单击应用 > Helm，找到ack-dify单击删除组件，单击确定即可完成ack-dify组件卸载。同时手动删除所有组件相关PVC。
通过备份中心恢复：
选择数据备份时，备份仓库中对应的备份数据。
选择恢复命名空间：
dify-system，确认恢复操作完成后，即可重新访问ack-dify。
升级完成后，请不要立即回退，确保数据已迁移且插件正常运行。
如果在升级过程中遇到问题，请参考官方文档： 将社区版迁移至 v1.0.0。
常见问题
备份恢复时间：取决于数据量和网络状况。
插件迁移失败：检查网络是否能访问
https://marketplace.dify.ai。数据迁移失败：尝试重新运行迁移命令。
免责声明
Dify on ACK是仅针对阿里云ACK环境适配开源项目Dify的Helm部署方案，实现Dify在ACK的快速部署。ACK不对Dify应用本身的运行或与其他生态系统组件（如插件、数据库等）的兼容性做出保障。对于您在使用Dify过程中因Dify本身及其生态组件的缺陷而导致业务受损的情况，ACK不提供赔偿或者补偿等商务服务。建议您关注开源社区的更新动态，主动修复开源软件中的问题，以确保Dify的稳定和安全。