使用 Milvus Operator 升級 Milvus 叢集
本指南說明如何使用 Milvus Operator 將 Milvus 2.6.x 叢集升級至 v3.0.5。
此程序已通過驗證,適用於從 Milvus 2.6.20 升級至 Milvus v3.0.5,並搭配 Milvus Operator 1.3.0、MixCoord、StreamingNode、Woodpecker、叢集內 etcd 以及叢集內 MinIO。 若您使用其他 Milvus 2.6.x 修補版本、Operator 版本、元件拓撲、訊息佇列或依賴項配置,請先在非生產環境中驗證升級流程。
先決條件
- 一個由 Milvus Operator 管理的、包含 Milvus 2.6.x 叢集的 Kubernetes 叢集
kubectl可存取該叢集- 用於現有部署的完整 Milvus 自訂資源 (CR) 清單
- 現有 Milvus Operator 所使用的安裝方法與清單
- Milvus 元資料與持久化資料的最新備份
訊息佇列限制:升級至 Milvus v3.0.5 時,您必須維持當前的訊息佇列選擇。升級過程中不支援在不同的訊息佇列系統之間切換。未來版本將支援變更訊息佇列系統。
請針對此次升級套用完整的 Milvus CR。請勿使用僅包含映像檔的合併修補程式。Operator 可能會預設省略零複本元件的欄位,這可能會重新啟用現有 2.6.x 部署中已停用的元件。
此程序不驗證透過將 Milvus 映像還原至 2.6.x 版本所進行的降級或回滾操作。 在 v3.0.5 寫入資料後,僅套用映像檔的回滾操作可能會無法讀取已更新的狀態。若升級失敗,請停止寫入操作,並採用能還原升級前元資料及持久化資料備份的復原方案。請先在非生產環境中驗證該復原方案。
升級流程
步驟 1:備份當前的 Milvus CR
在變更部署設定前,請先儲存當前的 CR:
kubectl get milvus <instance-name> \
--namespace <namespace> \
--output yaml > milvus-before-upgrade.yaml
請將現有部署的來源清單用作升級清單。切勿在未先移除伺服器管理的元資料及狀態欄位的情況下,直接套用匯出的備份檔案。
步驟 2:確認 Milvus Operator 版本
檢查已安裝的 Milvus Operator 所使用的映像檔:
kubectl get deployments --all-namespaces \
-o jsonpath='{range .items[*]}{.metadata.namespace}{"\t"}{.metadata.name}{"\t"}{range .spec.template.spec.containers[*]}{.image}{" "}{end}{"\n"}{end}' \
| grep milvus-operator
經過驗證的升級方案將 Milvus Operator 維持在 1.3.0 版本。除非您的支援政策要求進行獨立的 Operator 升級,否則請保留目前管理您的 Milvus 2.6.x 部署的 Operator 版本。 請勿將較新的 Operator 降級至已測試的版本。若需變更 Operator 版本,請使用與現有安裝相同的 Helm 或kubectl 安裝方式,並採用相同的發行版本名稱與命名空間,然後在更新 Milvus CR 之前驗證 Operator 的變更。
步驟 3:更新 Milvus 映像檔
在完整的 Milvus CR 清單中,將spec.components.image 變更為目標版本。請保留當前的運作模式、元件拓撲、訊息佇列、etcd、儲存空間及其他依賴項設定。以下摘錄顯示了需確認的欄位;請勿以此摘錄取代您的完整 CR。
在套用目標 CR 之前,請確認indexNode.replicas 設定為0 。已驗證的 Milvus 2.6.20 配置已採用此設定。請在目標 CR 中保留明確的「零副本」設定。
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: <instance-name>
namespace: <namespace>
spec:
components:
image: milvusdb/milvus:v3.0.5
indexNode:
replicas: 0
套用完整的 CR 清單:
kubectl apply --filename milvus.yaml
驗證升級
檢查 CR 狀態、Pod 狀態及容器映像檔:
kubectl get milvus <instance-name> \
--namespace <namespace> \
--output jsonpath='{.status.status}{"\t"}{.status.currentImage}{"\n"}'
kubectl get pods --namespace <namespace>
kubectl get pods --namespace <namespace> \
-o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{range .spec.containers[*]}{.image}{" "}{end}{"\n"}{end}'
請確認 Milvus CR 報告的值為Healthy ,所有 Milvus 元件均使用milvusdb/milvus:v3.0.5 ,沒有任何 IndexNode Pod 正在執行,且現有的集合仍可進行查詢與搜尋。在啟用任何 v3.0.5 專屬功能之前,請先完成這些檢查。