Aggiornamento di Milvus Standalone con Docker Compose
Questa guida descrive come aggiornare una distribuzione standalone di Milvus 2.6.x alla versione v3.0.2 con Docker Compose.
Questa procedura è stata verificata con la configurazione ufficiale di Docker Compose per Milvus 2.6.20 standalone. L'aggiornamento ha mantenuto etcd, MinIO, Woodpecker e le directory dei dati esistenti, modificando solo l'immagine di Milvus in milvusdb/milvus:v3.0.2.
Prerequisiti
- Docker Engine e Docker Compose V2
- Una distribuzione standalone esistente di Milvus 2.6.x gestita da Docker Compose
- Il file Docker Compose e la configurazione utilizzati per l’implementazione esistente
- Un backup aggiornato dei metadati e dei dati persistenti di Milvus
Limiti della coda dei messaggi: durante l'aggiornamento a Milvus v3.0.2, è necessario mantenere la coda dei messaggi attualmente in uso. Il passaggio a sistemi di code dei messaggi diversi durante l'aggiornamento non è supportato. Il supporto per la modifica dei sistemi di code dei messaggi sarà disponibile nelle versioni future.
Non sostituire il file Compose attuale né modificare le versioni delle dipendenze nell’ambito di questa procedura. Mantieni l’etcd, l’object storage, la coda dei messaggi, i volumi e la configurazione esistenti. Aggiorna solo il tag dell’immagine di Milvus.
Questa procedura non garantisce la validità di un downgrade o di un rollback ottenuto riportando l’immagine di Milvus alla versione 2.6.x. Dopo che la v3.0.2 ha scritto i dati, un rollback che riguarda solo l’immagine potrebbe non riuscire a leggere lo stato aggiornato. Se l’aggiornamento fallisce, interrompere le operazioni di scrittura e utilizzare un piano di ripristino che ripristini i metadati precedenti all’aggiornamento e i backup dei dati persistenti. Verificare prima il piano di ripristino in un ambiente non di produzione.
Processo di aggiornamento
Passaggio 1: Eseguire il backup della configurazione corrente
Salvare una copia del file Compose corrente e di eventuali file di configurazione Milvus montati:
cp docker-compose.yml docker-compose-before-upgrade.yml
Verificare che i container attuali siano in buono stato prima di avviare l'aggiornamento:
docker compose ps
Passaggio 2: aggiornare l’immagine Milvus
Nel file Compose esistente, aggiornare solo l'immagine relativa al servizio standalone:
services:
standalone:
image: milvusdb/milvus:v3.0.2
Scaricare l'immagine di destinazione e ricreare solo il container Milvus:
docker compose pull standalone
docker compose up --detach standalone
Docker Compose mantiene in esecuzione i container etcd e object-storage esistenti e riutilizza le directory dei dati configurate.
Verifica l'aggiornamento
Controllare lo stato del container e l'immagine utilizzata dal container Milvus:
docker compose ps
docker compose images standalone
docker compose logs --tail 100 standalone
Verifica che il servizio standalone sia in buono stato, che la sua immagine sia milvusdb/milvus:v3.0.2 e che le collezioni esistenti rimangano interrogabili e ricercabili. Completa questi controlli prima di abilitare qualsiasi funzionalità specifica della versione v3.0.2.
