Exécuter Milvus dans Docker (Windows)

Cette page explique comment exécuter Milvus sur Windows à l'aide de Docker Desktop pour Windows.

Conditions préalables

• Installer Docker Desktop.

• Installer Windows Subsystem for Linux 2 (WSL 2).

• Installer Python 3.8+.

Exécuter Milvus dans Docker

Milvus fournit un script d'installation pour l'installer en tant que conteneur Docker. Une fois que vous avez installé Docker Desktop sur Microsoft Windows, vous pouvez accéder à la CLI de Docker à partir de PowerShell ou de Windows Command Prompt en mode administrateur et à partir de WSL 2.

À partir de PowerShell ou de l'invite de commande Windows

Si vous êtes plus familier avec PowerShell ou Windows Command Prompt, l'invite de commande est la suivante.

1. Ouvrez Docker Desktop en mode administrateur en cliquant avec le bouton droit de la souris et en sélectionnant Exécuter en tant qu'administrateur.

2. Téléchargez le script d'installation et enregistrez-le sous standalone.bat.

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

3. Exécuter le script téléchargé pour démarrer Milvus en tant que conteneur Docker.

   C:\>standalone.bat start
   Wait for Milvus starting...
   Start successfully.
   To change the default Milvus configuration, edit user.yaml and restart the service.
   
   

   Après avoir exécuté le script d'installation.

   • Un conteneur Docker nommé milvus-standalone a été démarré au port 19530.

   • Un embed etcd est installé avec Milvus dans le même conteneur et sert au port 2379. Son fichier de configuration est mappé à embedEtcd.yaml dans le dossier actuel.

   • Le volume de données Milvus est mappé sur volumes/milvus dans le dossier actuel.

   Vous pouvez utiliser les commandes suivantes pour gérer le conteneur Milvus et les données stockées.

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

Depuis le WSL 2

Si vous préférez démarrer Milvus à l'aide de commandes Linux et de scripts shell sous Windows, assurez-vous que vous avez déjà installé la commande WSL 2. Pour plus de détails sur l'installation de la commande WSL 2, vous pouvez vous référer à cet article de Microsoft.

1. Démarrer WSL 2.

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

2. Télécharger le script d'installation

   # 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. Démarrez Milvus en tant que conteneur Docker.

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

   Vous pouvez utiliser les commandes suivantes pour gérer le conteneur Milvus et les données stockées.

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

Exécuter Milvus avec Docker Compose

Une fois que vous avez installé Docker Desktop sur Microsoft Windows, vous pouvez accéder à la CLI de Docker à partir de PowerShell ou de l'invite de commande Windows en mode administrateur. Vous pouvez exécuter Docker Compose dans PowerShell, Windows Command Prompt ou WSL 2 pour démarrer Milvus.

À partir de PowerShell ou de l'invite de commandes Windows

1. Ouvrez Docker Desktop en mode administrateur en cliquant avec le bouton droit de la souris et en sélectionnant Exécuter en tant qu'administrateur.

2. Exécuter les commandes suivantes dans PowerShell ou Windows Command Prompt pour télécharger le fichier de configuration Docker Compose pour Milvus Standalone et démarrer Milvus.

   # 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
   
   

   En fonction de votre connexion réseau, le téléchargement des images pour l'installation de Milvus peut prendre un certain temps. Une fois que les conteneurs nommés milvus-standalone, milvus-minio et milvus-etcd sont en place, vous pouvez constater que

   • Le conteneur milvus-etcd n'expose aucun port à l'hôte et mappe ses données sur les volumes/etcd dans le dossier actuel.

   • Le conteneur milvus-minio dessert les ports 9090 et 9091 localement avec les informations d'authentification par défaut et affecte ses données aux volumes/minio dans le dossier actuel.

   • Le conteneur milvus-standalone dessert localement les ports 19530 avec les paramètres par défaut et affecte ses données aux volumes/milvus dans le dossier actuel.

Vous pouvez également appeler la version Linux des commandes Docker Compose si le WSL 2 est installé.

À partir de WSL 2

La procédure est similaire à l'utilisation de Docker Compose pour installer Milvus dans les systèmes Linux.

1. Démarrer WSL 2.

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

2. Télécharger le fichier de configuration de Milvus.

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

3. Démarrer Milvus.

   $ sudo docker compose up -d
   
   Creating milvus-etcd  ... done
   Creating milvus-minio ... done
   Creating milvus-standalone ... done
   
   

FAQ

Comment puis-je résoudre l'erreur Docker Engine stopped?

Une fois que vous avez installé Docker Desktop dans Windows, vous pouvez rencontrer l'erreur Docker Engine stopped si votre ordinateur n'est pas configuré correctement. Dans ce cas, vous devrez peut-être effectuer les vérifications suivantes.

1. Vérifiez si la virtualisation est activée.

   Vous pouvez vérifier si la virtualisation est activée en consultant l'onglet Performance du Gestionnaire des tâches.

   Virtualisation dans le Gestionnaire des tâches

   Si la virtualisation est désactivée, vous devrez peut-être vérifier les paramètres du BIOS de votre carte mère. La manière d'activer la virtualisation dans les paramètres du BIOS varie selon les fournisseurs de cartes mères. Pour la carte mère ASUS, par exemple, vous pouvez vous référer à cet article sur l'activation de la virtualisation.

   Ensuite, vous devez redémarrer votre ordinateur et activer Hyper-V. Pour plus de détails, reportez-vous à cet article de Microsoft.

2. Vérifiez si le service Docker Desktop a été démarré.

   Vous pouvez exécuter la commande suivante pour démarrer le service Docker Desktop.

   C:\>net start com.docker.service
   The Docker for Windows Service service is starting.
   The Docker for Windows Service service was started successfully.
   
   

3. Vérifiez si WSL a été installé correctement.

   Vous pouvez exécuter la commande suivante pour installer ou mettre à jour la commande WSL 2.

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

4. Vérifiez si le Docker Daemon a été démarré.

   Vous devez vous rendre dans le répertoire d'installation de Docker Desktop et exécuter la commande .\DockerCli.exe -SwitchDaemon pour démarrer Docker Daemon.

   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. Vérifiez si vous avez démarré Docker Desktop en mode administrateur.

   Assurez-vous d'avoir démarré Docker Desktop en mode administrateur. Pour ce faire, cliquez avec le bouton droit de la souris sur Docker Desktop et choisissez Exécuter en tant qu'administrateur.

   Démarrer Docker Desktop en tant qu'administrateur

Comment puis-je traiter les problèmes liés au WSL lors du déploiement de Milvus ?

Si vous avez rencontré des problèmes liés au WSL lors de l'exécution de Milvus à partir du WSL 2, vous devrez peut-être vérifier si vous avez configuré Docker Desktop pour utiliser le moteur basé sur le WSL 2 comme suit.

1. Assurez-vous que l'option "Use the WSL 2 based engine" (Utiliser le moteur basé sur WSL 2) est cochée dans Settings > General ( Paramètres > Général).

   Utiliser le moteur WSL 2 dans les paramètres de Docker Desktop

2. Sélectionnez parmi les distributions WSL 2 installées celle sur laquelle vous souhaitez activer l'intégration Docker en vous rendant à l'adresse suivante : Paramètres > Ressources > Intégration WSL.

   Sélectionnez les distributions WSL 2 dans les paramètres de Docker Desktop.

Comment puis-je traiter les erreurs liées au volume qui s'affichent au démarrage de Milvus et qui se lisent Read config failed?

Erreur d'échec de lecture de la configuration au démarrage de Milvus

Pour traiter l'erreur qui s'affiche au démarrage de Milvus sous la forme "Read config failed", vous devez vérifier si le volume monté dans le conteneur Milvus est correct. Si le volume est correctement monté dans le conteneur, vous pouvez utiliser la commande docker exec pour accéder au conteneur et répertorier le dossier /milvus/configs comme suit.

Lister les fichiers de configuration de Milvus