使用 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 專屬功能之前,請先完成這些檢查。

翻譯者DeepL

免費嘗試托管的 Milvus

Zilliz Cloud 無縫接入,由 Milvus 提供動力,速度提升 10 倍。

開始使用
反饋

這個頁面有幫助嗎?