基於ACK叢集的Dify組件升級指南 - Container Service for Kubernetes

本文主要指導使用者將ack-dify從舊版本升級至v1.0.0及以上，首先備份資料，然後通過命令提取並安裝外掛程式遷移工具至外掛程式系統，最後驗證外掛程式功能是否正常運行，以啟用新的外掛程式生態系統。

適用版本

目前的版本： < v1.0.0
目標版本： >= v1.0.0

1. 資料備份

使用備份中心備份ack-dify資料，備份命名空間：dify-system，詳細操作步驟，請參見立即備份。

2. 升級 ack-dify

登入Container Service管理主控台，在左側導覽列選擇叢集列表。單擊目的地組群名稱，進入叢集詳情頁面，依次單擊應用 > Helm，找到ack-dify單擊更新組件。然後選擇版本為最新版本，單擊確定即可完成ack-dify組件更新。

3. Plugin 遷移

3.1 進入 ack-dify API 容器

kubectl exec -it <ack-dify-api-xxxxx-xxxxx> -n dify-system -- bash

3.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-plugin

5. 確認升級成功

訪問 Dify 平台。
檢查Dify平台中外掛程式是否已正確安裝。
隨機測試一個外掛程式的功能，若功能正常則說明升級遷移成功。

回退方法

如果需要回退到舊版本：

登入Container Service管理主控台，在左側導覽列選擇叢集列表。單擊目的地組群名稱，進入叢集詳情頁面，依次單擊應用 > 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的穩定和安全。