Milvus in Docker ausführen (Windows)
Standardmäßig verwendet diese Bereitstellung Woodpecker (lokales Dateisystem) als Nachrichtenwarteschlange, sodass kein externer Nachrichtenwarteschlangendienst erforderlich ist. Siehe Woodpecker.
Auf dieser Seite wird gezeigt, wie Sie Milvus unter Windows mit Docker Desktop für Windows ausführen.
Voraussetzungen
Installieren Sie Python 3.8 oder höher.
Milvus in Docker ausführen
Milvus stellt ein Installationsskript bereit, mit dem es als Docker-Container installiert werden kann. Sobald Sie Docker Desktop unter Microsoft Windows installiert haben, können Sie im Administratormodus über PowerShell oder die Windows-Eingabeaufforderung sowie über WSL 2 auf die Docker-CLI zugreifen.
Über PowerShell oder die Windows-Eingabeaufforderung
Wenn Sie mit PowerShell oder der Windows-Eingabeaufforderung besser vertraut sind, lautet der Befehl wie folgt.
Öffnen Sie Docker Desktop im Administratormodus, indem Sie mit der rechten Maustaste darauf klicken und „Als Administrator ausführen“ auswählen.
Laden Sie das Installationsskript herunter und speichern Sie es unter dem Namen „
standalone.bat“.C:\>Invoke-WebRequest https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat -OutFile standalone.batFühren Sie das heruntergeladene Skript aus, um Milvus als Docker-Container zu starten.
C:\>standalone.bat start Wait for Milvus starting... Start successfully. To change the default Milvus configuration, edit user.yaml and restart the service.Nach Ausführung des Installationsskripts:
Ein Docker-Container namens „milvus-standalone“ wurde am Port 19530 gestartet.
Ein „embed etcd“ wird zusammen mit Milvus im selben Container installiert und ist unter Port 2379 erreichbar. Seine Konfigurationsdatei ist auf „embedEtcd.yaml“ im aktuellen Ordner abgebildet.
Das Milvus-Datenvolume ist auf „volumes/milvus“ im aktuellen Ordner abgebildet.
Mit den folgenden Befehlen können Sie den Milvus-Container und die gespeicherten Daten verwalten.
# Stop Milvus C:\>standalone.bat stop Stop successfully. # Delete Milvus container C:\>standalone.bat delete Delete Milvus container successfully. # Container has been removed. Delete successfully. # Data has been removed.
Unter WSL 2
Wenn Sie Milvus unter Windows lieber mit Linux-Befehlen und Shell-Skripten starten möchten, stellen Sie sicher, dass Sie WSL 2 bereits installiert haben. Einzelheiten zur Installation von WSL 2 finden Sie in diesem Microsoft-Artikel.
Starten Sie WSL 2.
C:\>wsl --install Ubuntu already installed. Starting Ubuntu...Laden Sie das Installationsskript herunter
# Download the installation script $ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh # Start the Docker container $ bash standalone_embed.sh startStarten Sie Milvus als Docker-Container.
$ bash standalone_embed.sh start Wait for Milvus Starting... Start successfully. To change the default Milvus configuration, add your settings to the user.yaml file and then restart the service.Mit den folgenden Befehlen können Sie den Milvus-Container und die gespeicherten Daten verwalten.
# Stop Milvus $ bash standalone_embed.sh stop Stop successfully. # Delete Milvus data $ bash standalone_embed.sh delete Delete Milvus container successfully. Delete successfully.
Milvus mit Docker Compose ausführen
Sobald Sie Docker Desktop unter Microsoft Windows installiert haben, können Sie im Administratormodus über die PowerShell oder die Windows-Eingabeaufforderung auf die Docker-CLI zugreifen. Sie können Docker Compose entweder in der PowerShell, der Windows-Eingabeaufforderung oder in WSL 2 ausführen, um Milvus zu starten.
Über die PowerShell oder die Windows-Eingabeaufforderung
Öffnen Sie Docker Desktop im Administratormodus, indem Sie mit der rechten Maustaste darauf klicken und „Als Administrator ausführen“ auswählen.
Führen Sie die folgenden Befehle in der PowerShell oder der Windows-Eingabeaufforderung aus, um die Docker-Compose-Konfigurationsdatei für Milvus Standalone herunterzuladen und Milvus zu starten.
# Download the configuration file and rename it as docker-compose.yml C:\>Invoke-WebRequest https://github.com/milvus-io/milvus/releases/download/v3.0.2/milvus-standalone-docker-compose.yml -OutFile docker-compose.yml # Start Milvus C:\>docker compose up -d Creating milvus-etcd ... done Creating milvus-minio ... done Creating milvus-standalone ... doneJe nach Ihrer Netzwerkverbindung kann das Herunterladen der Images für die Milvus-Installation eine Weile dauern. Sobald die Container mit den Namen „milvus-standalone“, „milvus-minio“ und „milvus-etcd“ laufen, können Sie feststellen, dass
Der Container „milvus-etcd“ keine Ports für den Host freigibt und seine Daten dem Verzeichnis „volumes/etcd“ im aktuellen Ordner zuordnet.
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.
Sie können auch die Linux-Version der Docker-Compose-Befehle aufrufen, wenn Sie WSL 2 installiert haben.
Von WSL 2
Die Vorgehensweise ähnelt der Installation von Milvus auf Linux-Systemen mit Docker Compose.
Starten Sie WSL 2.
C:\>wsl --install Ubuntu already installed. Starting Ubuntu...Laden Sie die Milvus-Konfigurationsdatei herunter.
$ wget https://github.com/milvus-io/milvus/releases/download/v3.0.2/milvus-standalone-docker-compose.yml -O docker-compose.ymlStarten Sie Milvus.
$ sudo docker compose up -d Creating milvus-etcd ... done Creating milvus-minio ... done Creating milvus-standalone ... done
Häufig gestellte Fragen
Wie kann ich den Fehler „ Docker Engine stopped “ beheben?
Nach der Installation von Docker Desktop unter Windows kann der Fehler „ Docker Engine stopped “ auftreten, wenn Ihr Computer nicht richtig konfiguriert ist. In diesem Fall sollten Sie folgende Überprüfungen vornehmen:
Überprüfen Sie, ob die Virtualisierung aktiviert ist.
Sie können auf der Registerkarte „Leistung“ im Task-Manager überprüfen, ob die Virtualisierung aktiviert ist.
Virtualisierung im Task-Manager
Wenn die Virtualisierung deaktiviert ist, müssen Sie möglicherweise die BIOS-Einstellungen der Firmware Ihres Motherboards überprüfen. Die Vorgehensweise zum Aktivieren der Virtualisierung in den BIOS-Einstellungen variiert je nach Motherboard-Hersteller. Für ASUS-Motherboards können Sie beispielsweise diesen Artikel zum Aktivieren der Virtualisierung zu Rate ziehen.
Anschließend müssen Sie Ihren Computer neu starten und Hyper-V aktivieren. Weitere Informationen finden Sie in diesem Microsoft-Artikel.
Überprüfen Sie, ob der Docker Desktop-Dienst gestartet wurde.
Sie können den folgenden Befehl ausführen, um den Docker Desktop-Dienst zu starten.
C:\>net start com.docker.service The Docker for Windows Service service is starting. The Docker for Windows Service service was started successfully.Überprüfen Sie, ob WSL ordnungsgemäß installiert wurde.
Mit dem folgenden Befehl können Sie den WSL 2-Befehl installieren oder aktualisieren.
C:\>wsl --update Checking for updates. The most recent version of Windows Subsystem for Linux is already installed.Überprüfen Sie, ob der Docker-Daemon gestartet wurde.
Wechseln Sie in das Installationsverzeichnis von Docker Desktop und führen Sie „
.\DockerCli.exe -SwitchDaemon“ aus, um den Docker-Daemon zu starten.C:\>cd "C:\Program Files\Docker\Docker" C:\Program Files\Docker\Docker>.\DockerCli.exe -SwitchDaemon Switching to windows engine: Post "http://ipc/engine/switch": open \\.\pipe\dockerBackendApiServer: The system cannot find the file specified.Überprüfen Sie, ob Sie Docker Desktop im Administratormodus gestartet haben.
Stellen Sie sicher, dass Sie Docker Desktop im Administratormodus gestartet haben. Klicken Sie dazu mit der rechten Maustaste auf Docker Desktop und wählen Sie „Als Administrator ausführen“.
Docker Desktop als Administrator starten
Wie kann ich Probleme im Zusammenhang mit WSL bei der Bereitstellung von Milvus beheben?
Wenn beim Ausführen von Milvus unter WSL 2 Probleme im Zusammenhang mit WSL aufgetreten sind, müssen Sie möglicherweise überprüfen, ob Sie Docker Desktop wie folgt für die Verwendung der WSL 2-basierten Engine konfiguriert haben:
Stellen Sie sicher, dass unter „Einstellungen > Allgemein“ die Option „WSL 2-basierte Engine verwenden“ aktiviert ist.
Verwenden der WSL 2-basierten Engine in den Docker Desktop-Einstellungen
Wählen Sie unter „Einstellungen > Ressourcen > WSL-Integration“ aus Ihren installierten WSL 2-Distributionen diejenige aus, für die Sie die Docker-Integration aktivieren möchten.
WSL 2-Distributionen in den Docker Desktop-Einstellungen auswählen
Wie kann ich mit den beim Start von Milvus angezeigten volumenbezogenen Fehlern umgehen, die lauten: „ Read config failed “?
Fehlermeldung „Read config failed“ beim Start von Milvus
Um den beim Start von Milvus angezeigten Fehler „Read config failed“ zu beheben, müssen Sie überprüfen, ob das in den Milvus-Container eingebundene Volume korrekt ist. Wenn das Volume korrekt in den Container eingebunden ist, können Sie mit dem Befehl „ docker exec “ in den Container wechseln und den Ordner „/milvus/configs“ wie folgt auflisten:
Milvus-Konfigurationsdateien auflisten
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 nun
Nachdem Sie Milvus in Docker installiert haben, können Sie:
Schauen Sie sich den Schnellstart an, um zu sehen, was Milvus leisten 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 zur Fehlerbehebung in Milvus und für dynamische Konfigurationsaktualisierungen.
Entdecken Sie Attu, ein Open-Source-GUI-Tool für die intuitive Verwaltung von Milvus.
