在 Docker 中執行 Milvus（Linux）
本頁面說明如何在 Docker 中啟動 Milvus 實例。
先決條件
- 安裝 Docker。
- 安裝前請先確認硬體與軟體的系統需求。
在 Docker 中安裝 Milvus
Milvus 提供了一個安裝腳本，可將其安裝為 Docker 容器。該腳本可在Milvus 儲存庫中取得。在開始新部署之前，請先下載並檢視該腳本：
# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
# Inspect the Docker image selected by the script
$ grep -n "milvusdb/milvus:" standalone_embed.sh
# Start the Docker container
$ bash standalone_embed.sh start
此腳本可從 Milvus 的master 分支下載。其 Docker 映像標籤在腳本中已定義，可能與 v3.0.5 不同。若要安裝該特定版本，請參閱《使用 Docker Compose 執行 Milvus》中的版本化設定。
此 Docker 部署會將本地檔案系統用作Woodpecker的 WAL 後端，因此無需外部訊息佇列服務。請參閱Woodpecker。
若您希望在獨立部署模式下使用Backup，建議採用Docker Compose部署方式。
若在拉取映像檔時遇到任何問題，請透過community@zilliz.com聯絡我們，並提供問題詳情，我們將為您提供必要的支援。
執行安裝腳本後：
- 一個名為 milvus-standalone 的 Docker 容器已於19530 埠啟動。
- 一個嵌入式 etcd 已隨 Milvus 一起安裝在同一容器中，並於2379 埠提供服務。其設定檔對應至當前資料夾中的embedEtcd.yaml檔案。
- 若要變更預設的 Milvus 設定，請將您的設定新增至當前資料夾中的user.yaml檔案，然後重新啟動服務。
- Milvus 資料卷已映射至當前資料夾中的volumes/milvus。
請驗證實際映像檔及運作狀態：
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
請等待healthy 狀態顯示為「 」後，再繼續進行《快速入門》步驟。使用此伺服器時，請將 SDK 連線至http://localhost:19530 ；若使用本機的.db URI，則會啟動 Milvus Lite。
您可以透過http://127.0.0.1:9091/webui/ 存取 Milvus WebUI，以進一步了解您的 Milvus 執行個體。詳細資訊請參閱Milvus WebUI。
(可選) 更新 Milvus 設定
您可以在當前資料夾中的user.yaml檔案中修改 Milvus 設定。例如，若要將proxy.healthCheckTimeout 變更為1000 ms，您可以按照以下方式修改該檔案：
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
接著請依照以下步驟重新啟動服務：
$ bash standalone_embed.sh restart
有關適用的設定項目，請參閱《系統設定》。
升級 Milvus
該腳本中的upgrade 指令會從master 下載腳本，並使用該腳本選定的映像重新建立容器。此指令不會驗證來源至目標版本路徑是否受支援，且可能會重新建立已生成的設定檔。請勿將此視為保證任意舊版部署皆能安全升級至 v3.0.5。
升級前，請備份元資料、持久化資料、embedEtcd.yaml 以及user.yaml 。請檢查目標版本、訊息佇列及儲存空間的相容性，並在非生產環境中驗證恢復功能。對於使用 Docker Compose 管理的部署，請遵循《使用 Docker Compose 升級 Milvus 獨立執行版》的指引；請勿將該程序直接套用至由腳本管理的容器。
停止並刪除 Milvus
您可以依照以下步驟停止並刪除此容器
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
可選依賴項
預設情況下，此部署會運行Woodpecker（本地檔案系統 WAL）作為訊息佇列，並使用內嵌的 etcd來管理元資料——無需安裝其他組件。若要使用不同的訊息佇列或連接外部物件儲存／元資料，請參閱：
- 訊息佇列：Woodpecker（預設）·Pulsar·Kafka·RocksMQ
- 物件儲存：MinIO（預設）·AWS S3·Azure Blob·GCP Cloud Storage·阿里雲 OSS·騰訊 COS·華為 OBS·S3 相容
- 元資料：etcd
Storage V3 預設為停用狀態。在使用依賴此功能的服務前，請先啟用它。有關需求與相容性考量，請參閱Storage V3。
下一步
在 Docker 中安裝 Milvus 後，您可以：
參閱《快速入門》了解 Milvus 的功能。
學習 Milvus 的基本操作：
在變更 Milvus 版本之前，請先參閱本頁面的升級注意事項。
在雲端部署您的 Milvus 叢集：
探索Milvus WebUI，這是專為 Milvus 可觀察性與管理而設計的直觀網頁介面。
探索Milvus Backup，這是一款用於 Milvus 資料備份的開源工具。
探索Birdwatcher，這是一款用於 Milvus 除錯與動態配置更新的開源工具。
探索Attu，這是一款用於直觀管理 Milvus 的開源圖形化介面工具。
