Milvus mit Docker Compose ausführen (Linux)
Auf dieser Seite wird erläutert, wie Sie eine Milvus-Instanz in Docker mithilfe von Docker Compose starten.
Voraussetzungen
- Installieren Sie Docker.
- Installieren Sie das Docker Compose-Plugin (V2 oder höher) und überprüfen Sie es mit dem Befehl „
docker compose version“. Diese Anleitung verwendet den Befehl „docker compose“ und nicht den veralteten Befehl „docker-compose“ (V1). - Überprüfen Sie vor der Installationdie Hardware- und Softwareanforderungen.
Milvus installieren
Milvus stellt im Milvus-Repository eine Docker-Compose-Konfigurationsdatei bereit. Laden Sie die Konfiguration für v3.0.5 herunter und starten Sie eine neue Bereitstellung:
# Download the configuration file
$ wget https://github.com/milvus-io/milvus/releases/download/v3.0.5/milvus-standalone-docker-compose.yaml -O docker-compose.yaml
# Start Milvus
$ sudo docker compose up -d
Creating milvus-etcd ... done
Creating milvus-minio ... done
Creating milvus-standalone ... done
Standard-Bereitstellung (v3.0.5): docker compose up -d startet drei lang laufende Container – milvus-etcd (Metadaten), milvus-minio (Objektspeicher) und milvus-standalone. Als Nachrichtenwarteschlange wird Woodpecker verwendet (eingebettet, mit MinIO/Objektspeicher als WAL-Backend), sodass kein separater Nachrichtenwarteschlangen-Container erforderlich ist.
Die Konfiguration führt außerdem den einmalig ausgeführten Dienst „ milvus-volume-init “ aus, um die Eigentumsrechte für das Datenverzeichnis vorzubereiten. Nach Abschluss dieser Aufgabe wird der Dienst beendet.
Standard-Nachrichtenwarteschlange je nach Version:
- 2.5.x – Standard-Nachrichtenwarteschlange ist RocksMQ.
- 2.6.x und höher – Standard-Nachrichtenwarteschlange ist Woodpecker (eingebettet).
Verwenden Sie die Konfiguration, die der von Ihnen zu installierenden Version beiliegt. Bei einer bestehenden Bereitstellung befolgen Sie bitte die Upgrade-Anweisungen, anstatt die Konfiguration durch eine Datei für die Neuinstallation zu ersetzen.
Falls „
docker compose“ nicht verfügbar ist, installieren Sie das Compose-Plugin anhand der Docker-Anweisungen.Sollten beim Abrufen des Images Probleme auftreten, kontaktieren Sie uns bitte unter community@zilliz.com mit Details zum Problem, und wir werden Ihnen die erforderliche Unterstützung zukommen lassen.
Nach dem Start von Milvus
- sind die Container mit den Namen „milvus-standalone“, „milvus-minio“ und „milvus-etcd“ aktiv.
- Der Container „milvus-etcd“ stellt keine Ports für den Host bereit und ordnet seine Daten dem Verzeichnis „volumes/etcd“ im aktuellen Ordner zu.
- Der Container „milvus-minio“ stellt lokal die Ports 9000 und 9001 mit den Standard-Anmeldedaten bereit und ordnet seine Daten dem Verzeichnis „volumes/minio“ im aktuellen Ordner zu.
- Der Container „milvus-standalone“ stellt lokal die Ports 19530 mit den Standardeinstellungen bereit und ordnet seine Daten dem Verzeichnis „volumes/milvus“ im aktuellen Ordner zu.
Mit dem folgenden Befehl können Sie überprüfen, ob die Container aktiv sind:
$ docker compose ps
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
milvus-etcd … "etcd -advertise-cli…" etcd 2 minutes ago Up 2 minutes (healthy) 2379-2380/tcp
milvus-minio … "/usr/bin/docker-ent…" minio 2 minutes ago Up 2 minutes (healthy) 9000-9001/tcp
milvus-standalone … "/tini -- milvus run…" standalone 2 minutes ago Up 2 minutes (healthy) 0.0.0.0:9091->9091/tcp, 0.0.0.0:19530->19530/tcp
Sie können auch über http://127.0.0.1:9091/webui/ auf die Milvus-WebUI zugreifen, um mehr über Ihre Milvus-Instanz zu erfahren. Weitere Informationen finden Sie unter „Milvus-WebUI“.
Um den laufenden Server zu testen, befolgen Sie den Abschnitt „Einen vorhandenen Milvus-Server verwenden“ im Schnellstart und stellen Sie eine Verbindung zu http://localhost:19530 her. Verwenden Sie nicht den lokalen Verbindungsblock „ .db “, da dieser eine separate Milvus-Lite-Datenbank startet.
(Optional) Milvus-Konfigurationen aktualisieren
Um die Milvus-Konfiguration an Ihre Anforderungen anzupassen, müssen Sie die Datei „ /milvus/configs/user.yaml “ im Container „ milvus-standalone “ bearbeiten.
Rufen Sie den Container „
milvus-standalone“ auf.docker exec -it milvus-standalone bashFügen Sie zusätzliche Konfigurationen hinzu, um die Standardkonfigurationen zu überschreiben. Im Folgenden wird davon ausgegangen, dass Sie die Standardkonfiguration von „
proxy.healthCheckTimeout“ überschreiben müssen. Informationen zu den entsprechenden Konfigurationselementen finden Sie unter „Systemkonfiguration“.cat << EOF > /milvus/configs/user.yaml # Extra config to override default milvus.yaml proxy: healthCheckTimeout: 1000 # ms, the interval that to do component healthy check EOFStarten Sie den Container „
milvus-standalone“ neu, um die Änderungen zu übernehmen.docker restart milvus-standalone
Milvus anhalten und löschen
Sie können diesen Container wie folgt anhalten und löschen
# Stop Milvus
$ sudo docker compose down
# Delete service data
$ sudo rm -rf volumes
Ein bestehendes Deployment aktualisieren
Befolgen Sie für eine eigenständige Milvus 2.6.x-Bereitstellung die Anleitung „Milvus Standalone mit Docker Compose aktualisieren“. Sichern Sie Metadaten und persistente Daten, bewahren Sie die bestehenden Abhängigkeiten und die Konfiguration bei und überprüfen Sie den dokumentierten Upgrade-Pfad von der Quelle zum Ziel, bevor Sie das Milvus-Image ändern. Ersetzen Sie die Compose-Datei einer älteren Bereitstellung nicht durch die oben genannte Konfiguration für eine Neuinstallation.
Einschränkungen bei Nachrichtenwarteschlangen: Beim Upgrade auf Milvus v3.0.5 müssen Sie Ihre aktuelle Wahl der Nachrichtenwarteschlange beibehalten. Ein Wechsel zwischen verschiedenen Nachrichtenwarteschlangensystemen während des Upgrades wird nicht unterstützt. Die Unterstützung für den Wechsel von Nachrichtenwarteschlangensystemen wird in zukünftigen Versionen verfügbar sein.
Milvus 2.6.x und höher verwenden standardmäßig Woodpecker, während 2.5.x-Bereitstellungen standardmäßig RocksMQ verwenden. Wenn die Bereitstellung, die Sie aktualisieren, noch RocksMQ ausführt, legen Sie dies unter „ user.yaml “ fest, bevor Sie das Milvus-Image ändern, damit die aktualisierte Instanz ihre bestehende Nachrichtenwarteschlange beibehält, anstatt mit der neuen Standardeinstellung zu starten:
# user.yaml — keep RocksMQ across the upgrade
mq:
type: rocksmq
Nachdem die aktualisierte Instanz unter v3.0.5 läuft, können Sie mit der Funktion „Switch Message Queue“, die ab Milvus 3.0 verfügbar ist, von RocksMQ zu Woodpecker wechseln.
Optionale Abhängigkeiten
Diese Bereitstellung nutzt Woodpecker (eingebettet, MinIO-WAL-Backend) für die Nachrichtenübermittlung, etcd für Metadaten und MinIO für den Objektspeicher. Informationen zur Verwendung einer anderen Nachrichtenwarteschlange oder zur Anbindung eines externen Objektspeichers bzw. externer Metadaten finden Sie hier:
- Nachrichtenwarteschlange: Woodpecker (Standard) · Pulsar · Kafka · RocksMQ
- Objektspeicher: MinIO (Standard) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · S3-kompatibel
- Metadaten: etcd
Storage V3 ist standardmäßig deaktiviert. Aktivieren Sie es, bevor Sie Funktionen nutzen, die davon abhängen. Informationen zu Anforderungen und Kompatibilitätsaspekten finden Sie unter Storage V3.
Was kommt als Nächstes
Nachdem Sie Milvus in Docker installiert haben, können Sie:
Schauen Sie sich den Schnellstart an, um zu sehen, was Milvus alles kann.
Lernen Sie die grundlegenden Funktionen von Milvus kennen:
Stellen Sie Ihren Milvus-Cluster in der Cloud bereit:
Entdecken Sie Milvus WebUI, eine intuitive Weboberfläche für die Überwachung und Verwaltung von Milvus.
Entdecken Sie Milvus Backup, ein Open-Source-Tool für Milvus-Datensicherungen.
Entdecken Sie Birdwatcher, ein Open-Source-Tool für die Fehlerbehebung in Milvus und dynamische Konfigurationsaktualisierungen.
Entdecken Sie Attu, ein Open-Source-GUI-Tool für die intuitive Verwaltung von Milvus.