Exécuter Milvus avec Docker Compose (Linux)

Cette page explique comment lancer une instance Milvus dans Docker à l'aide de Docker Compose.

Prérequis

• Installez Docker.
• Vérifiez la configuration matérielle et logicielle requise avant l'installation.

Installer Milvus

Milvus fournit un fichier de configuration Docker Compose dans le référentiel Milvus. Pour installer Milvus à l'aide de Docker Compose, il suffit d'exécuter

# Download the configuration file
$ wget https://github.com/milvus-io/milvus/releases/download/v3.0.2/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

Après le démarrage de Milvus,

• les conteneurs nommés milvus-standalone, milvus-minio et milvus-etcd sont en cours d’exécution.
  • 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 courant.
  • 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 vérifier si les conteneurs sont opérationnels à l’aide de la commande suivante :

$ 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

Vous pouvez également accéder à l’interface Web de Milvus à l’adresse http://127.0.0.1:9091/webui/ pour en savoir plus sur votre instance Milvus. Pour plus de détails, consultez la section Interface Web de Milvus.

(Facultatif) Mise à jour des configurations de Milvus

Pour mettre à jour la configuration de Milvus en fonction de vos besoins, vous devez modifier le fichier ` /milvus/configs/user.yaml ` situé dans le conteneur ` milvus-standalone `.

1. Accédez au conteneur milvus-standalone.

   docker exec -it milvus-standalone bash
   

2. Ajoutez des paramètres supplémentaires pour remplacer les paramètres par défaut. La procédure suivante part du principe que vous devez remplacer les paramètres par défaut de ` proxy.healthCheckTimeout`. Pour connaître les éléments de configuration concernés, reportez-vous à la section « Configuration du système ».

   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. Redémarrez le conteneur milvus-standalone pour appliquer les modifications.

   docker restart milvus-standalone
   

Arrêter et supprimer Milvus

Vous pouvez arrêter et supprimer ce conteneur comme suit

# Stop Milvus
$ sudo docker compose down

# Delete service data
$ sudo rm -rf volumes

Mise à niveau de Milvus 2.5.x vers la version 2.6.x

Limitations relatives aux files d’attente de messages: lors de la mise à niveau vers Milvus v3.0.2, vous devez conserver votre choix actuel de file d’attente de messages. Le passage d’un système de file d’attente de messages à un autre pendant la mise à niveau n’est pas pris en charge. La prise en charge du changement de système de file d’attente de messages sera disponible dans les versions futures.

La version 2.6.x remplaçant la file d’attente de messages par défaut par Woodpecker, une instance exécutant RocksMQ sous la version 2.5.x doit explicitement verrouiller RocksMQ avant la mise à niveau — sinon, la mise à niveau tenterait de modifier la file d’attente de messages, ce qui n’est pas pris en charge. Après avoir téléchargé le fichier Docker Compose de la version 2.6.x, redéfinissez le type de file d'attente de messages sur « rocksmq » dans votre fichier de redéfinition « user.yaml », puis effectuez la mise à niveau :

# user.yaml — keep RocksMQ across the 2.5.x → 2.6.x upgrade
mq:
  type: rocksmq

Pour changer de file d’attente de messages après la mise à niveau, consultez la section « Changer de file d’attente de messages ».

Dépendances facultatives

Ce déploiement utilise Woodpecker (intégré, backend WAL MinIO) pour la messagerie, etcd pour les métadonnées et MinIO pour le stockage d’objets. Pour utiliser une file d’attente de messages différente ou connecter un stockage d’objets / des métadonnées externes, consultez :

• File d’attente de messages : Woodpecker (par défaut) · Pulsar · Kafka · RocksMQ
• Stockage d’objets : MinIO (par défaut) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · Compatible S3
• Métadonnées : etcd

Et ensuite

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.