Mise à niveau de Milvus Standalone avec Docker Compose

Ce guide décrit comment mettre à niveau votre déploiement Milvus autonome de la version 2.5.x à la version 2.6.16 à l'aide de Docker Compose.

Avant de commencer

Nouveautés de la version 2.6.16

La mise à niveau de Milvus 2.5.x vers 2.6.16 implique des changements architecturaux importants :

  • Consolidation des coordinateurs: Les anciens coordinateurs séparés (dataCoord, queryCoord, indexCoord) ont été consolidés en un seul. mixCoord
  • Nouveaux composants: Introduction d'un nœud de streaming pour un meilleur traitement des données
  • Suppression de composants: indexNode supprimé et consolidé

Ce processus de mise à niveau garantit une migration correcte vers la nouvelle architecture. Pour plus d'informations sur les modifications de l'architecture, voir l'aperçu de l'architecture Milvus.

Exigences

Configuration requise :

  • Docker et Docker Compose installés
  • Milvus autonome déployé via Docker Compose

Exigences de compatibilité :

  • Milvus v2.6.0-rc1 n' est pas compatible avec v2.6.16. Les mises à niveau directes à partir des versions candidates ne sont pas prises en charge.
  • Si vous utilisez actuellement la version 2.6.0-rc1 et que vous devez préserver vos données, veuillez vous référer à ce guide de la communauté pour obtenir de l'aide à la migration.
  • Vous devez effectuer une mise à niveau vers la version 2.5.16 ou une version ultérieure avant d'effectuer une mise à niveau vers la version 2.6.16.

Limitations de la file d'attente des messages: Lors de la mise à niveau vers Milvus v2.6.16, 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 prochaines versions.

Pour des raisons de sécurité, Milvus met à niveau son MinIO vers RELEASE.2024-12-18T13-15-44Z avec la sortie de la v2.6.16.

Processus de mise à niveau

Étape 1 : Mise à niveau vers la version 2.5.16

Sautez cette étape si votre déploiement autonome utilise déjà la version 2.5.16 ou une version plus récente.

  1. Modifier votre fichier docker-compose.yaml existant et mettre à jour la balise d'image Milvus vers la version 2.5.16 :

    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.5.16
    ...
    
  2. Appliquer la mise à niveau vers la version 2.5.16 :

    docker compose down
    docker compose up -d
    
  3. Vérifier la mise à niveau vers la version 2.5.16 :

    docker compose ps
    

Étape 2 : Mise à niveau vers la version 2.6.16

Une fois que la version 2.5.16 fonctionne correctement, passez à la version 2.6.16 :

  1. Modifiez votre fichier docker-compose.yaml existant et mettez à jour les balises d'image Milvus et MinIO :

    ...
    minio:
      container_name: milvus-minio
      image: minio/minio:RELEASE.2024-12-18T13-15-44Z
    
    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.6.16
    
  2. Appliquez la mise à niveau finale :

    docker compose down
    docker compose up -d
    

Vérifier la mise à niveau

Confirmez que votre déploiement autonome exécute la nouvelle version :

# Check container status
docker compose ps

# Check Milvus version
docker compose logs standalone | grep "version"

Prochaines étapes