使用 Docker Compose 升級 Milvus 獨立部署
本指南說明如何使用 Docker Compose 將 Milvus 2.6.x 獨立部署版本升級至 v3.0.0。
此程序已透過官方 Milvus 2.6.20 獨立部署版 Docker Compose 配置進行驗證。升級過程保留了 etcd、MinIO、Woodpecker 以及現有的資料目錄，僅將 Milvus 映像檔更換為milvusdb/milvus:v3.0.0 。
先決條件
- Docker Engine 及 Docker Compose V2
- 由 Docker Compose 管理的現有 Milvus 2.6.x 獨立部署環境
- 現有部署所使用的 Docker Compose 檔案及設定
- Milvus 元資料與持久化資料的最新備份
訊息佇列限制：升級至 Milvus v3.0.0 時，您必須維持當前的訊息佇列選擇。升級過程中不支援在不同的訊息佇列系統之間切換。未來版本將支援變更訊息佇列系統。
請勿在此程序中替換您目前的 Compose 檔案或變更依賴項版本。請保留現有的 etcd、物件儲存、訊息佇列、卷宗及設定。僅需更新 Milvus 映像標籤。
此程序不支援透過將 Milvus 映像檔降級回 2.6.x 版本來進行降級或回滾。 在 v3.0.0 寫入資料後，若執行僅還原映像檔的回滾操作，可能會無法讀取已更新的狀態。若升級失敗，請停止寫入操作，並採用能還原升級前元資料及持久化資料備份的復原方案。請先在非生產環境中驗證該復原方案。
升級流程
步驟 1：備份當前設定
儲存當前 Compose 檔案的副本，以及所有已掛載的 Milvus 配置檔案：
cp docker-compose.yml docker-compose-before-upgrade.yml
在開始升級前，請確認當前容器狀態正常：
docker compose ps
步驟 2：更新 Milvus 映像檔
在現有的 Compose 檔案中，僅更新standalone 服務的映像檔：
services:
standalone:
image: milvusdb/milvus:v3.0.0
拉取目標映像檔，並僅重新建立 Milvus 容器：
docker compose pull standalone
docker compose up --detach standalone
Docker Compose 會讓現有的 etcd 和 object-storage 容器繼續運行，並重複使用已設定的資料目錄。
驗證升級
檢查容器狀態以及 Milvus 容器所使用的映像檔：
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
確認standalone 服務狀態正常，其映像為milvusdb/milvus:v3.0.0 ，且現有集合仍可進行查詢與搜尋。在啟用任何 v3.0.0 專屬功能之前，請先完成這些檢查。
