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

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.

  1. Rufen Sie den Container „ milvus-standalone “ auf.

    docker exec -it milvus-standalone bash
    
  2. Fü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
    EOF
    
  3. Starten 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:

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:

Übersetzt vonDeepL

Office Hours

Milvus Bürozeiten

Holen Sie sich Hilfe bei der Produktionsbereitstellung von Zilliz, den Experten für Milvus.

Buchen Sie eine kostenlose 1:1-Sitzung

Verwaltetes Milvus kostenlos testen

Zilliz Cloud ist unkompliziert, basiert auf Milvus und ist 10-mal schneller.

Loslegen
Feedback

War diese Seite hilfreich?