Mise à niveau de Milvus Standalone à l'aide d'un Helm Chart
Ce guide décrit comment mettre à niveau votre déploiement autonome de Milvus 2.6.x vers la version 3.0.3 à l'aide de Helm.
Cette procédure a été validée de Milvus 2.6.20 à Milvus v3.0.3 avec le Helm Chart Milvus 5.0.22. Si vous utilisez une autre version de Milvus 2.6.x ou une autre version du Helm Chart, testez d'abord la mise à niveau dans un environnement hors production.
Prérequis
- Helm 3.14.0 ou version ultérieure
- Un déploiement Milvus 2.6.x existant géré par Helm
- Les valeurs Helm utilisées 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.3, 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 modifiez pas et ne revenez pas à une version antérieure du Helm Chart dans le cadre de cette procédure. Conservez la version du Chart déjà installée pour votre version Helm. La configuration de référence testée a conservé le Helm Chart 5.0.22 et n’a modifié que le tag de l’image Milvus pour le remplacer par v3.0.3.
Cette procédure ne valide pas de retour à une version antérieure ni de restauration consistant à ramener l’image Milvus à la version 2.6.x. Une fois que la version 3.0.3 a écrit des données, une restauration 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. Validez d’abord le plan de reprise dans un environnement hors production.
Processus de mise à niveau
Étape 1 : Mettre à jour le référentiel Helm
Ajoutez ou mettez à jour le référentiel Helm de Milvus :
helm repo add zilliztech https://zilliztech.github.io/milvus-helm --force-update
helm repo update zilliztech
https://milvus-io.github.io/milvus-helm/ a été archivé. Utilisez le nouveau référentiel https://zilliztech.github.io/milvus-helm/ pour les versions 4.0.31 et ultérieures des charts.
Étape 2 : Mise à niveau de Milvus
Vérifiez la version du chart installée pour votre version Helm :
helm list --namespace <namespace>
Dans la colonne « CHART », supprimez le préfixe « milvus- » de la valeur et utilisez la version restante sous la forme « <current-chart-version> ». Exécutez ensuite la commande de mise à niveau :
helm upgrade <release-name> zilliztech/milvus \
--namespace <namespace> \
--version <current-chart-version> \
--set image.all.tag="v3.0.3" \
--reset-then-reuse-values \
--wait \
--timeout 20m
L’option ` --reset-then-reuse-values ` conserve les valeurs de la version précédente tout en appliquant le remplacement explicite de l’image par rapport aux valeurs par défaut du Chart sélectionné.
Vérifiez la mise à niveau
Vérifiez la révision Helm, l’état des pods et les images de conteneurs :
helm history <release-name> --namespace <namespace>
kubectl get pods --namespace <namespace>
kubectl get pods --namespace <namespace> \
-o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{range .spec.containers[*]}{.image}{" "}{end}{"\n"}{end}'
Vérifiez que toutes les charges de travail requises sont prêtes, que Milvus utilise v3.0.3 et que vos collections existantes restent consultables et recherchables. Effectuez ces vérifications avant d’activer toute fonctionnalité spécifique à la version 3.0.3.
La mise à niveau vers Milvus 3.0 n’active pas Storage V3. Après avoir vérifié la mise à niveau, consultez la documentation relative à Storage V3 avant d’activer les fonctionnalités qui en dépendent. Une fois que Milvus a écrit des données Storage V3, la rétrogradation vers une version antérieure de Milvus incapable de lire Storage V3 n’est pas prise en charge.
