Eseguire Milvus in Docker (Linux)
Questa pagina illustra come avviare un'istanza di Milvus in Docker.
Prerequisiti
- Installare Docker.
- Verificare i requisiti hardware e software prima dell'installazione.
Installare Milvus in Docker
Milvus fornisce uno script di installazione per installarlo come container Docker. Lo script è disponibile nel repository di Milvus. Scaricare e controllare lo script prima di avviare una nuova distribuzione:
# 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
Lo script viene scaricato dal ramo " master " di Milvus. Il tag dell'immagine Docker è definito nello script e può differire dalla versione v3.0.5. Per installare esattamente quella versione, utilizzare la configurazione con versione specificata in " Eseguire Milvus con Docker Compose".
Questa distribuzione Docker esegue Woodpecker utilizzando il filesystem locale come backend WAL, pertanto non è richiesto alcun servizio esterno di coda dei messaggi. Vedere Woodpecker.
Se si desidera utilizzare Backup in modalità di distribuzione autonoma, si consiglia di utilizzare il metodo di distribuzione Docker Compose.
Se si riscontrano problemi durante il download dell’immagine, contattarci all’indirizzo community@zilliz.com fornendo i dettagli del problema e forniremo l’assistenza necessaria.
Dopo aver eseguito lo script di installazione:
- È stato avviato un container Docker denominato milvus-standalone sulla porta 19530.
- Insieme a Milvus, nello stesso container è installato un etcd integrato, che opera sulla porta 2379. Il suo file di configurazione è mappato su embedEtcd.yaml nella cartella corrente.
- Per modificare la configurazione predefinita di Milvus, aggiungi le tue impostazioni al file user.yaml nella cartella corrente, quindi riavvia il servizio.
- Il volume di dati di Milvus è mappato su volumes/milvus nella cartella corrente.
Verifica l'immagine effettiva e lo stato di integrità:
docker inspect --format '{{.Config.Image}}' milvus-standalone
docker inspect --format '{{.State.Health.Status}}' milvus-standalone
Attendere che venga visualizzato il messaggio " healthy " prima di seguire la guida rapida. Quando si utilizza questo server, collegare l'SDK a http://localhost:19530; un URI locale .db avvia invece Milvus Lite.
È possibile accedere all’interfaccia utente web di Milvus all’indirizzo http://127.0.0.1:9091/webui/ per ottenere ulteriori informazioni sull’istanza di Milvus in uso. Per i dettagli, consultare la documentazione relativa all’interfaccia utente web di Milvus.
(Facoltativo) Aggiornamento delle configurazioni di Milvus
È possibile modificare le configurazioni di Milvus nel file user.yaml presente nella cartella corrente. Ad esempio, per cambiare l'URI da proxy.healthCheckTimeout a 1000 ms, è possibile modificare il file come segue:
cat << EOF > user.yaml
# Extra config to override default milvus.yaml
proxy:
healthCheckTimeout: 1000 # ms, the interval that to do component healthy check
EOF
Quindi riavviare il servizio come segue:
$ bash standalone_embed.sh restart
Per le voci di configurazione applicabili, consultare Configurazione di sistema.
Aggiornamento di Milvus
Il comando upgrade dello script scarica lo script da master e ricrea il container utilizzando l’immagine selezionata da tale script. Non verifica la validità del percorso di versione da origine a destinazione supportato e può ricreare i file di configurazione generati. Non considerarlo una garanzia che una distribuzione precedente arbitraria possa essere aggiornata in modo sicuro alla versione v3.0.5.
Prima di un aggiornamento, eseguire il backup dei metadati, dei dati persistenti, di embedEtcd.yaml e di user.yaml. Verificare la versione di destinazione, la coda dei messaggi e la compatibilità dello storage, e verificare il ripristino in un ambiente non di produzione. Per le distribuzioni gestite con Docker Compose, seguire la procedura "Aggiornamento di Milvus Standalone con Docker Compose"; non applicare tale procedura direttamente a un container gestito tramite script.
Arrestare ed eliminare Milvus
È possibile arrestare ed eliminare questo container come segue
# Stop Milvus
$ bash standalone_embed.sh stop
# Delete Milvus data
$ bash standalone_embed.sh delete
Dipendenze opzionali
Per impostazione predefinita, questa distribuzione utilizza Woodpecker (WAL su filesystem locale) come coda dei messaggi e un etcd incorporato per i metadati — non è necessario installare altro. Per utilizzare una coda dei messaggi diversa o collegare un sistema di archiviazione oggetti/metadati esterno, consultare:
- Coda di messaggi: Woodpecker (impostazione predefinita) · Pulsar · Kafka · RocksMQ
- Archiviazione a oggetti: MinIO (predefinito) · AWS S3 · Azure Blob · GCP Cloud Storage · Aliyun OSS · Tencent COS · Huawei OBS · Compatibile con S3
- Metadati: etcd
Storage V3 è disabilitato per impostazione predefinita. Abilitalo prima di utilizzare le funzionalità che ne dipendono. Per i requisiti e le considerazioni sulla compatibilità, consulta Storage V3.
Prossimi passi
Dopo aver installato Milvus in Docker, è possibile:
Consultare la Guida rapida per scoprire cosa può fare Milvus.
Imparare le operazioni di base di Milvus:
Prima di cambiare la versione di Milvus, consulta le considerazioni relative all'aggiornamento riportate in questa pagina.
Distribuisci il tuo cluster Milvus su cloud:
Scopri Milvus WebUI, un'interfaccia web intuitiva per l'osservabilità e la gestione di Milvus.
Scopri Milvus Backup, uno strumento open source per il backup dei dati di Milvus.
Scopri Birdwatcher, uno strumento open source per il debug di Milvus e gli aggiornamenti dinamici della configurazione.
Scopri Attu, uno strumento GUI open source per una gestione intuitiva di Milvus.
