Exécuter Milvus dans Docker (Linux)
Cette page explique comment lancer une instance de Milvus dans Docker.
Prérequis
- Installez Docker.
- Vérifiez la configuration matérielle et logicielle requise avant l'installation.
Installer Milvus dans Docker
Milvus fournit un script d'installation permettant de l'installer en tant que conteneur Docker. Ce script est disponible dans le dépôt Milvus. Téléchargez et examinez le script avant de lancer un nouveau déploiement :
# Download the installation script
$ curl -sfL https://raw.githubusercontent.com/milvus-io/milvus/master/scripts/standalone_embed.sh -o standalone_embed.sh
# Inspect the Docker image selected by the script
$ grep -n "milvusdb/milvus:" standalone_embed.sh
# Start the Docker container
$ bash standalone_embed.sh start
Le script est téléchargé depuis la branche « master » de Milvus. Son identifiant d’image Docker est défini dans le script et peut différer de la version v3.0.3. Pour installer cette version précise, utilisez la configuration versionnée décrite dans la section « Exécuter Milvus avec Docker Compose ».
Ce déploiement Docker exécute Woodpecker en utilisant le système de fichiers local comme backend WAL ; aucun service de file d’attente de messages externe n’est donc nécessaire. Voir Woodpecker.
Si vous souhaitez utiliser Backup en mode de déploiement autonome, il est recommandé d’utiliser la méthode de déploiement Docker Compose.
Si vous rencontrez des difficultés pour récupérer l’image, contactez-nous à l’adresse community@zilliz.com en précisant les détails du problème, et nous vous fournirons l’assistance nécessaire.
Après avoir exécuté le script d’installation :
- Un conteneur Docker nommé milvus-standalone a été lancé 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 correspond au fichier embedEtcd.yaml situé dans le dossier actuel.
- Pour modifier la configuration par défaut de Milvus, ajoutez vos paramètres au fichier user.yaml situé dans le dossier actuel, puis redémarrez le service.
- Le volume de données Milvus est mappé vers volumes/milvus dans le dossier actuel.
Vérifiez l’image et l’état de santé actuels :
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
Attendez que l'healthy e avant de suivre le guide de démarrage rapide. Lorsque vous utilisez ce serveur, connectez le SDK à http://localhost:19530; l'URI locale .db lance Milvus Lite à la place.
Vous pouvez 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, reportez-vous à la documentation de l’interface Web de Milvus.
(Facultatif) Mise à jour des configurations de Milvus
Vous pouvez modifier les paramètres de configuration de Milvus dans le fichier user.yaml situé dans le dossier actuel. Par exemple, pour remplacer l’adresse proxy.healthCheckTimeout par 1000 ms, vous pouvez modifier le fichier comme suit :
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
Redémarrez ensuite le service comme suit :
$ bash standalone_embed.sh restart
Pour connaître les éléments de configuration concernés, consultez la section « Configuration du système ».
Mise à niveau de Milvus
La commande ` upgrade ` du script télécharge le script depuis master et recrée le conteneur à l’aide de l’image sélectionnée par ce script. Elle ne vérifie pas la compatibilité entre les versions source et cible et peut recréer les fichiers de configuration générés. Ne considérez pas cela comme une garantie qu’un déploiement antérieur quelconque puisse être mis à niveau en toute sécurité vers la version 3.0.3.
Avant toute mise à niveau, sauvegardez les métadonnées, les données persistantes, embedEtcd.yaml et user.yaml. Vérifiez la compatibilité de la version cible, de la file d’attente de messages et du stockage, puis validez la restauration dans un environnement hors production. Pour les déploiements gérés avec Docker Compose, suivez la procédure « Mise à niveau de Milvus Standalone avec Docker Compose » ; n’appliquez pas cette procédure directement à un conteneur géré par script.
Arrêter et supprimer Milvus
Vous pouvez arrêter et supprimer ce conteneur comme suit
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
Dépendances facultatives
Par défaut, ce déploiement utilise Woodpecker (WAL sur le système de fichiers local) comme file d’attente de messages et un etcd intégré pour les métadonnées — aucune autre installation n’est nécessaire. Pour utiliser une autre file d’attente de messages 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
Storage V3 est désactivé par défaut. Activez-le avant d’utiliser les fonctionnalités qui en dépendent. Pour connaître les prérequis et les considérations de compatibilité, consultez la page Storage V3.
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 :
Consultez les considérations relatives à la mise à niveau sur cette page avant de changer de version de Milvus.
Déployez votre cluster Milvus sur le cloud :
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 les mises à jour dynamiques de la configuration.
Découvrez Attu, un outil GUI open source permettant une gestion intuitive de Milvus.
