Mise à niveau de Milvus en mode autonome avec Docker Compose
Ce guide décrit comment mettre à niveau un déploiement autonome de Milvus 2.6.x vers la version 3.0.0 à l'aide de Docker Compose.
Cette procédure a été validée avec la configuration officielle Docker Compose de Milvus 2.6.20 en mode autonome. La mise à niveau a conservé etcd, MinIO, Woodpecker et les répertoires de données existants, et n’a modifié que l’image Milvus pour passer à milvusdb/milvus:v3.0.0.
Prérequis
- Docker Engine et Docker Compose V2
- Un déploiement autonome existant de Milvus 2.6.x géré par Docker Compose
- Le fichier Docker Compose et la configuration utilisés pour le déploiement existant
- Une sauvegarde récente des métadonnées et des données persistantes de Milvus
Limitations relatives à la file d’attente de messages: lors de la mise à niveau vers Milvus v3.0.0, 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.
Ne remplacez pas votre fichier Compose actuel et ne modifiez pas les versions des dépendances dans le cadre de cette procédure. Conservez l’etcd, le stockage d’objets, la file d’attente de messages, les volumes et la configuration existants. Mettez à jour uniquement le tag de l’image Milvus.
Cette procédure ne prend pas en charge la rétrogradation ou la restauration de l’image Milvus vers la version 2.6.x. Une fois que la version 3.0.0 a écrit des données, une annulation portant uniquement sur l’image peut ne pas parvenir à lire l’état mis à jour. Si la mise à niveau échoue, arrêtez les écritures et utilisez un plan de reprise qui restaure les métadonnées antérieures à la mise à niveau ainsi que les sauvegardes des données persistantes. Testez d’abord le plan de reprise dans un environnement hors production.
Processus de mise à niveau
Étape 1 : Sauvegardez la configuration actuelle
Enregistrez une copie du fichier Compose actuel et de tous les fichiers de configuration Milvus montés :
cp docker-compose.yml docker-compose-before-upgrade.yml
Vérifiez que les conteneurs actuels sont en bon état de fonctionnement avant de lancer la mise à niveau :
docker compose ps
Étape 2 : Mettre à jour l’image Milvus
Dans le fichier Compose existant, mettez à jour uniquement l’image du service « standalone » :
services:
standalone:
image: milvusdb/milvus:v3.0.0
Récupérez l'image cible et recréez uniquement le conteneur Milvus :
docker compose pull standalone
docker compose up --detach standalone
Docker Compose maintient en fonctionnement les conteneurs etcd et object-storage existants et réutilise les répertoires de données configurés.
Vérifiez la mise à niveau
Vérifiez l'état du conteneur et l'image utilisée par le conteneur Milvus :
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Vérifiez que le service standalone fonctionne correctement, que son image est milvusdb/milvus:v3.0.0 et que les collections existantes restent consultables et recherchables. Effectuez ces vérifications avant d’activer toute fonctionnalité spécifique à la version 3.0.0.
