Exécuter Milvus dans Docker (Windows)

Par défaut, ce déploiement utilise Woodpecker (système de fichiers local) comme file d'attente de messages ; aucun service externe de file d'attente de messages n'est donc nécessaire. Voir Woodpecker.

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

Prérequis

• Installez Docker Desktop.

• Installez le sous-système Windows pour Linux 2 (WSL 2).

• Installez Python 3.8 ou une version ultérieure.

Exécuter Milvus dans Docker

Milvus fournit un script d'installation permettant de l'installer en tant que conteneur Docker. Une fois Docker Desktop installé sous Microsoft Windows, vous pouvez accéder à l'interface CLI de Docker depuis PowerShell ou l'invite de commande Windows en mode administrateur, ainsi que depuis WSL 2.

Depuis PowerShell ou l'invite de commande Windows

Si vous êtes plus à l'aise avec PowerShell ou l'invite de commande Windows, la commande à utiliser 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 le nom « standalone.bat ».

   C:\>Invoke-WebRequest https://raw.githubusercontent.com/milvus-io/milvus/refs/heads/master/scripts/standalone_embed.bat -OutFile standalone.bat
   
   

3. Exécutez 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.
   
   

   Une fois le script d'installation exécuté :

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

   • Un etcd intégré est installé avec Milvus dans le même conteneur et est accessible sur le port 2379. Son fichier de configuration est mappé vers embedEtcd.yaml dans le dossier actuel.

   • Le volume de données Milvus est mappé vers le répertoire volumes/milvus du 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 WSL 2

Si vous préférez démarrer Milvus à l’aide de commandes Linux et de scripts shell sous Windows, assurez-vous d’avoir déjà installé WSL 2. Pour plus de détails sur l’installation de WSL 2, vous pouvez consulter cet article Microsoft.

1. Lancez WSL 2.

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

2. Téléchargez 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. Lancez 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 delete
   Delete Milvus container successfully.
   Delete successfully.
   
   

Exécutez Milvus avec Docker Compose

Une fois Docker Desktop installé sous Microsoft Windows, vous pouvez accéder à l'interface CLI de Docker depuis PowerShell ou l'invite de commande Windows en mode administrateur. Vous pouvez exécuter Docker Compose dans PowerShell, l'invite de commande Windows ou WSL 2 pour démarrer Milvus.

Depuis PowerShell ou l'invite de commande 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écutez les commandes suivantes dans PowerShell ou l’invite de commande Windows pour télécharger le fichier de configuration Docker Compose de 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/v3.0.0/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 opérationnels, vous pouvez constater que

   • le conteneur milvus-etcd n’expose aucun port vers l’hôte et mappe ses données vers le répertoire volumes/etcd du dossier actuel.

   • Le conteneur milvus-minio expose localement les ports 9000 et 9001 avec les identifiants d’authentification par défaut et mappe ses données vers le répertoire volumes/minio du dossier actuel.

   • Le conteneur milvus-standalone expose localement les ports 19530 avec les paramètres par défaut et mappe ses données vers le répertoire volumes/milvus du dossier actuel.

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

Depuis WSL 2

La procédure est similaire à celle consistant à utiliser Docker Compose pour installer Milvus sur des systèmes Linux.

1. Lancez WSL 2.

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

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

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

3. Lancez Milvus.

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

FAQ

Comment résoudre l'erreur « Docker Engine stopped » ?

Une fois Docker Desktop installé sous Windows, vous pouvez rencontrer l'erreur « Docker Engine stopped » si votre ordinateur n'est pas correctement configuré. 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 « Performances » du Gestionnaire des tâches.

   La 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 la carte mère. La procédure pour activer la virtualisation dans les paramètres du BIOS varie selon les fabricants de cartes mères. Pour les cartes mères ASUS, par exemple, vous pouvez consulter cet article sur l’activation de la virtualisation.

   Vous devez ensuite redémarrer votre ordinateur et activer Hyper-V. Pour plus de détails, consultez cet article 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é correctement installé.

   Vous pouvez exécuter la commande suivante pour installer ou mettre à jour 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 démon Docker 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 le démon Docker.

   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 que vous avez bien lancé Docker Desktop en mode administrateur.

   Assurez-vous d’avoir lancé Docker Desktop en mode administrateur. Pour ce faire, cliquez avec le bouton droit sur Docker Desktop et sélectionnez « Exécuter en tant qu’administrateur ».

   Lancer Docker Desktop en tant qu’administrateur

Comment résoudre les problèmes liés à WSL lors du déploiement de Milvus ?

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

1. Assurez-vous que l’option « Utiliser le moteur basé sur WSL 2 » est cochée dans Paramètres > Général.

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

2. Sélectionnez, parmi vos distributions WSL 2 installées, celles sur lesquelles vous souhaitez activer l’intégration Docker en accédant à : Paramètres > Ressources > Intégration WSL.

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

Comment puis-je résoudre les erreurs liées au volume qui s’affichent au démarrage de Milvus et qui indiquent « Read config failed » ?

Message d’erreur « Échec de la lecture de la configuration » au démarrage de Milvus

Pour résoudre l’erreur « Échec de la lecture de la configuration » qui s’affiche au démarrage de Milvus, 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 lister le dossier /milvus/configs comme suit :

Afficher les fichiers de configuration de Milvus

Étapes suivantes

Une fois Milvus installé dans Docker, vous pouvez :

• Consulter le guide de démarrage rapide pour découvrir les fonctionnalités de Milvus.

• Apprendre les opérations de base de Milvus :

  • Gérer les bases de données
  • Gérer les collections
  • Gérer les partitions
  • Insérer, mettre à jour ou supprimer
  • Recherche sur un seul vecteur
  • Recherche hybride

• Mettre à niveau Milvus à l'aide d'un Helm Chart.

• Faites évoluer votre cluster Milvus.

• Déployez votre cluster Milvus sur le cloud :

  • Amazon EKS
  • Google Cloud
  • Microsoft Azure

• Découvrez Milvus WebUI, une interface web intuitive pour la surveillance et la gestion de Milvus.

• Découvrez Milvus Backup, un outil open source dédié aux sauvegardes de données Milvus.

• Découvrez Birdwatcher, un outil open source permettant le débogage de Milvus et la mise à jour dynamique des configurations.

• Découvrez Attu, un outil GUI open source permettant une gestion intuitive de Milvus.

• Surveillez Milvus avec Prometheus.