使用 Docker 安裝 Milvus（向量數(shù)據(jù)庫）最推薦的方式是使用 Docker Compose，因為 Milvus 依賴多個組件（如 Etcd、MinIO 等）協(xié)同工作。

以下是基于官方最新文檔整理的 Milvus standalone（單機版） 安裝步驟，適用于 Linux、macOS 以及安裝了 WSL2 的 Windows 環(huán)境。

1. 前置條件

• Docker: 版本 20.10.0 或更高。
• Docker Compose: 版本 2.0.0 或更高。
• 內(nèi)存: 建議至少分配 4GB 以上內(nèi)存給 Docker。
  • 注意：如果在 macOS 或 Windows 上使用 Docker Desktop，請確保在設(shè)置中增加了容器的內(nèi)存限制。

2. 下載配置文件

Milvus 官方提供了一個 docker-compose.yml 文件來編排所有必要的服務(wù)。

創(chuàng)建一個目錄并進入：

下載最新的 docker-compose.yml 和 .env 文件（以 v2.4.x 或最新版為例，具體版本號可根據(jù)需求調(diào)整）：

1# 下載 docker-compose.yml
wget https://github.com/milvus-io/milvus/releases/download/v2.4.8/milvus-standalone-docker-compose.yml -O docker-compose.yml
 
2# 下載 .env 配置文件 (可選，但推薦，用于配置版本號和存儲路徑)
wget https://github.com/milvus-io/milvus/releases/download/v2.4.8/.env -O .env

(注：如果無法使用 wget，可以直接訪問 GitHub release 頁面手動下載，或者使用 curl)

3. 啟動 Milvus

在包含 docker-compose.yml 的目錄下運行以下命令：

docker compose up -d

• -d 表示后臺運行。
• 首次運行時，Docker 會自動拉取 milvusdb/milvus、quay.io/coreos/etcd 和 minio/minio 等鏡像，可能需要幾分鐘。

4. 驗證安裝

等待約 1-2 分鐘讓服務(wù)完全啟動，然后檢查容器狀態(tài)：

docker compose ps

所有服務(wù)的狀態(tài)應(yīng)顯示為 Up 或 healthy。

你也可以查看日志確認沒有報錯：

docker compose logs -f

按 Ctrl+C 退出日志查看。

5. 連接測試

Milvus 默認監(jiān)聽端口 19530。你可以使用 Python SDK (pymilvus) 進行連接測試。

首先安裝 SDK：

pip install pymilvus

創(chuàng)建一個測試腳本 test_milvus.py：

from pymilvus import connections, utility
 
# 連接 Milvus
4connections.connect("default", host="localhost", port="19530")
 
# 檢查連接并獲取版本
if utility.has_collection("non_existent_collection"): # 僅測試連接
    print("Connected successfully!")
else:
    print("Connected successfully! (Collection check passed)")
 
print(f"Milvus version: {utility.get_version()}")

運行腳本：

python test_milvus.py

如果輸出連接成功及版本號，說明安裝完成。

6. 常用管理命令

停止 Milvus:bash

docker compose down

重啟 Milvus:bash

docker compose restart

清理數(shù)據(jù) (慎用):
如果需要重置數(shù)據(jù)，需刪除掛載的 volumes 目錄（通常在當(dāng)前目錄下的 volumes 文件夾），然后重新 up。bash

docker compose down -v # -v 會刪除卷，數(shù)據(jù)將丟失

常見問題與注意事項

端口沖突: 默認使用 19530 (API), 9091 (Metrics), 2379 (Etcd), 9000 (MinIO)。如果端口被占用，請編輯 docker-compose.yml 修改映射端口。

WSL2 (Windows): 確保 WSL2 后端已啟用，且 Docker Desktop 設(shè)置為使用 WSL2 引擎。

GPU 支持: 如果需要 GPU 加速版本，需要下載帶有 gpu 標(biāo)簽的 docker-compose 文件，并確保宿主機安裝了 NVIDIA Container Toolkit。

Attu (可視化管理工具): 如果需要圖形化界面，可以單獨部署 Attu 容器：bash

docker run -d --name attu --network milvus-milvus -p 3000:3000 -e MILVUS_URL=http://milvus:19530 zilliz/attu

(注意：network 名稱需與你實際 docker compose 生成的網(wǎng)絡(luò)名稱一致，通常是 項目名_default 或 項目名-milvus)

到此這篇關(guān)于Docker安裝Milvus的實現(xiàn)步驟的文章就介紹到這了,更多相關(guān)Docker安裝Milvus內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論