Milvus in Docker ausführen (Windows)

Auf dieser Seite wird gezeigt, wie Milvus unter Windows mit Docker Desktop für Windows ausgeführt werden kann.

Voraussetzungen

• Installieren Sie Docker Desktop.

• Installieren Sie Windows Subsystem für Linux 2 (WSL 2).

• Installieren Sie Python 3.8+.

Ausführen von Milvus in Docker

Milvus bietet ein Installationsskript, um es als Docker-Container zu installieren. Sobald Sie Docker Desktop unter Microsoft Windows installiert haben, können Sie über PowerShell oder die Windows-Eingabeaufforderung im Administratormodus und über WSL 2 auf die Docker-CLI zugreifen.

Von PowerShell oder der Windows-Eingabeaufforderung aus

Wenn Sie mit PowerShell oder der Windows-Eingabeaufforderung besser vertraut sind, sehen Sie die Eingabeaufforderung wie folgt.

1. Öffnen Sie Docker Desktop im Administratormodus, indem Sie mit der rechten Maustaste klicken und Als Administrator ausführen wählen.

2. Laden Sie das Installationsskript herunter und speichern Sie es unter standalone.bat.

   C:\>Invoke-WebRequest https://github.com/milvus-io/milvus/blob/master/scripts/standalone_embed.bat -OutFile standalone.bat
   
   

3. Fü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.
   
   

   Nachdem Sie das Installationsskript ausgeführt haben.

   • Ein Docker-Container namens milvus-standalone wurde an Port 19530 gestartet.

   • Ein embed etcd wird zusammen mit Milvus im selben Container installiert und dient an Port 2379. Seine Konfigurationsdatei wird auf embedEtcd.yaml im aktuellen Ordner abgebildet.

   • Das Milvus-Datenvolumen wird im aktuellen Ordner auf volumes/milvus abgebildet.

   Sie können die folgenden Befehle verwenden, um den Milvus-Container und die gespeicherten Daten zu 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.
   
   

Von WSL 2 aus

Wenn Sie es vorziehen, Milvus mit Linux-Befehlen und Shell-Skripten unter Windows zu starten, stellen Sie sicher, dass Sie den Befehl WSL 2 bereits installiert haben. Einzelheiten zur Installation des WSL 2-Befehls finden Sie in diesem Microsoft-Artikel.

1. Starten Sie WSL 2.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. 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 start
   
   

3. Starten 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.
   
   

   Sie können die folgenden Befehle verwenden, um den Milvus-Container und die gespeicherten Daten zu verwalten.

   # Stop Milvus
   $ bash standalone_embed.sh stop
   Stop successfully.
   
   # Delete Milvus data
   $ bash standalone_embed.sh stop
   Delete Milvus container successfully.
   Delete successfully.
   
   

Milvus mit Docker Compose starten

Sobald Sie Docker Desktop unter Microsoft Windows installiert haben, können Sie über die PowerShell oder die Windows-Eingabeaufforderung im Administratormodus auf die Docker-CLI zugreifen. Sie können Docker Compose entweder in PowerShell, der Windows-Eingabeaufforderung oder WSL 2 ausführen, um Milvus zu starten.

Von PowerShell oder der Windows-Eingabeaufforderung aus

1. Öffnen Sie Docker Desktop im Administratormodus, indem Sie mit der rechten Maustaste klicken und Als Administrator ausführen wählen.

2. Führen Sie die folgenden Befehle in 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/v2.4.15/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 ... done
   
   

   Abhängig von 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 gestartet sind, können Sie sehen, dass

   • Der milvus-etcd-Container gibt keine Ports an den Host weiter und ordnet seine Daten den Volumes/etcd im aktuellen Ordner zu.

   • Der milvus-minio-Container bedient die Ports 9090 und 9091 lokal mit den Standard-Authentifizierungsdaten und ordnet seine Daten den Volumes/minio im aktuellen Ordner zu.

   • Der milvus-standalone-Container bedient lokal die Ports 19530 mit den Standardeinstellungen und ordnet seine Daten den 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 aus

Die Vorgehensweise ist ähnlich wie bei der Verwendung von Docker Compose zur Installation von Milvus in Linux-Systemen.

1. Starten Sie WSL 2.

   C:\>wsl --install
   Ubuntu already installed.
   Starting Ubuntu...
   
   

2. Laden Sie die Milvus-Konfigurationsdatei herunter.

   $ wget https://github.com/milvus-io/milvus/releases/download/v2.4.17/milvus-standalone-docker-compose.yml -O docker-compose.yml
   
   

3. Starten 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 mit dem Fehler Docker Engine stopped umgehen?

Nach der Installation von Docker Desktop unter Windows kann die Fehlermeldung Docker Engine stopped auftreten, wenn Ihr Computer nicht richtig konfiguriert ist. In diesem Fall müssen Sie möglicherweise die folgenden Überprüfungen durchführen.

1. Prüfen Sie, ob die Virtualisierung aktiviert ist.

   Sie können überprüfen, ob die Virtualisierung aktiviert ist, indem Sie die Registerkarte Leistung im Task-Manager aufrufen.

   Virtualisierung im Task-Manager

   Wenn die Virtualisierung deaktiviert ist, müssen Sie möglicherweise die BIOS-Einstellungen der Firmware Ihres Motherboards überprüfen. Die Art und Weise, wie Sie die Virtualisierung in den BIOS-Einstellungen aktivieren können, variiert je nach Motherboard-Hersteller. Für die ASUS-Hauptplatine können Sie zum Beispiel diesen Artikel zur Aktivierung der Virtualisierung lesen.

   Anschließend müssen Sie Ihren Computer neu starten und Hyper-V aktivieren. Weitere Informationen finden Sie in diesem Microsoft-Artikel.

2. Überprüfen Sie, ob der Docker Desktop Service gestartet wurde.

   Sie können den folgenden Befehl ausführen, um den Docker Desktop Service 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.
   
   

3. Überprüfen Sie, ob die WSL ordnungsgemäß installiert wurde.

   Sie können den folgenden Befehl ausführen, um den WSL 2-Befehl zu installieren oder zu aktualisieren.

   C:\>wsl --update
   Checking for updates.
   The most recent version of Windows Subsystem for Linux is already installed.
   
   

4. Prüfen Sie, ob Docker Daemon gestartet wurde.

   Sie müssen in das Installationsverzeichnis von Docker Desktop wechseln und .\DockerCli.exe -SwitchDaemon ausführen, um 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.
   
   

5. Prü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 mit WSL-bezogenen Problemen bei der Bereitstellung von Milvus umgehen?

Wenn bei der Ausführung von Milvus von WSL 2 aus WSL-bezogene Probleme auftreten, müssen Sie möglicherweise überprüfen, ob Sie Docker Desktop wie folgt für die Verwendung der WSL 2-basierten Engine konfiguriert haben.

1. 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

2. Wählen Sie aus Ihren installierten WSL 2-Distributionen diejenige aus, für die Sie die Docker-Integration aktivieren möchten, indem Sie zu: Einstellungen > Ressourcen > WSL-Integration.

   Wählen Sie WSL 2-Distributionen in den Docker-Desktop-Einstellungen aus .

Wie kann ich mit den volumenbezogenen Fehlern umgehen, die während des Starts von Milvus angezeigt werden, das Read config failed liest?

Fehlermeldung "Read config failed" beim Starten von Milvus

Um die Fehlermeldung beim Starten von Milvus "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 den Befehl docker exec verwenden, um in den Container zu gelangen und den Ordner /milvus/configs wie folgt aufzulisten.

Milvus-Konfigurationsdateien auflisten