Configurare l'object storage con Docker Compose o Helm
Milvus utilizza MinIO come storage a oggetti predefinito, ma supporta anche l'uso di Amazon Simple Storage Service (S3) e di altri storage a oggetti compatibili con S3 (ad esempio, Backblaze B2 o Cloudflare R2) come storage a oggetti persistente per i file di log e di indice. Questo argomento descrive come configurare S3 per Milvus. È possibile saltare questo argomento se si è soddisfatti di MinIO.
È possibile configurare S3 con Docker Compose o su K8s.
Configurazione di S3 con Docker Compose
1. Configurare S3
MinIO è compatibile con S3. Per configurare S3 con Docker Compose, specificare i valori nella sezione minio del file milvus.yaml, presente nel percorso milvus/configs.
minio:
address: <your_s3_endpoint>
port: <your_s3_port>
accessKeyID: <your_s3_access_key_id>
secretAccessKey: <your_s3_secret_access_key>
useSSL: <true/false>
bucketName: "<your_bucket_name>"
Per ulteriori informazioni, consultare Configurazioni MinIO/S3.
È possibile specificare in modo statico una chiave di accesso e una chiave segreta, ma se si esegue Milvus su un host o un cluster che supporta l’identità del carico di lavoro (ad esempio, un profilo di istanza EC2 o IRSA su EKS), si consiglia di utilizzare invece un ruolo IAM. Impostare ` useIAM ` su ` true ` e rimuovere ` accessKeyID ` e ` secretAccessKey`:
minio:
address: <your_s3_endpoint>
port: <your_s3_port>
useIAM: true
cloudProvider: "aws"
useSSL: <true/false>
bucketName: "<your_bucket_name>"
Milvus otterrà quindi le credenziali temporanee dal ruolo IAM associato al carico di lavoro. cloudProvider accetta aws, gcp o aliyun, mentre iamEndpoint può specificare facoltativamente un endpoint personalizzato per il recupero delle credenziali del ruolo IAM.
2. Modifica il file docker-compose.yaml
È inoltre necessario rimuovere la variabile d’ambiente ` MINIO_ADDRESS ` per il servizio Milvus all’indirizzo docker-compose.yaml. Per impostazione predefinita, Milvus utilizzerà Minio locale anziché S3 esterno.
3. Eseguire Milvus
Eseguire il seguente comando per avviare Milvus utilizzando le configurazioni S3.
docker compose up
Configurare S3 su K8s
Per i cluster Milvus su K8s, è possibile configurare S3 nello stesso comando che avvia Milvus. In alternativa, è possibile configurare S3 utilizzando il file ` values.yml ` presente nel percorso `/charts/milvus` del repository milvus-helm prima di avviare Milvus.
La tabella seguente elenca le chiavi per la configurazione di S3 nel file YAML.
| Chiave | Descrizione | Valore |
|---|---|---|
minio.enabled | Abilita o disabilita MinIO. | true/false |
externalS3.enabled | Abilita o disabilita S3. | true/false |
externalS3.host | L'endpoint per accedere a S3. | |
externalS3.port | La porta per accedere a S3. | |
externalS3.rootPath | Il percorso radice dell'archivio S3. | Per impostazione predefinita, è una stringa vuota. |
externalS3.accessKey | L'ID della chiave di accesso per S3. | |
externalS3.secretKey | La chiave di accesso segreta per S3. | |
externalS3.bucketName | Il nome del bucket S3. | |
externalS3.useSSL | Se utilizzare SSL durante la connessione | I valori predefiniti sono false |
externalS3.useIAM | Se utilizzare un ruolo IAM al posto delle chiavi di accesso e segrete per accedere a S3. | Il valore predefinito è false |
externalS3.cloudProvider | Fornitore di servizi cloud che emette le credenziali del ruolo IAM. | aws, gcp o aliyun; il valore predefinito è aws |
externalS3.iamEndpoint | Endpoint personalizzato per il recupero delle credenziali del ruolo IAM. | Lasciare vuoto per utilizzare l’impostazione predefinita del provider. |
Se il cluster supporta l’identità del carico di lavoro (ad esempio, IRSA su EKS), impostare externalS3.useIAM su true e rimuovere externalS3.accessKey e externalS3.secretKey — Milvus otterrà le credenziali temporanee dal ruolo IAM associato al carico di lavoro.
Utilizzo del file YAML
- Configurare la sezione
minionel filevalues.yaml.
minio:
enabled: false
- Configurare la sezione
externalS3utilizzando i propri valori nel filevalues.yaml.
externalS3:
enabled: true
host: "<your_s3_endpoint>"
port: "<your_s3_port>"
accessKey: "<your_s3_access_key_id>"
secretKey: "<your_s3_secret_key>"
useSSL: <true/false>
bucketName: "<your_bucket_name>"
- Dopo aver configurato le sezioni precedenti e salvato il file
values.yaml, eseguire il comando seguente per installare Milvus utilizzando le configurazioni S3.
helm install <your_release_name> milvus/milvus -f values.yaml
Utilizzo di un comando
Per installare Milvus e configurare S3, eseguire il comando seguente utilizzando i propri valori.
helm install <your_release_name> milvus/milvus --set cluster.enabled=true --set minio.enabled=false --set externalS3.enabled=true --set externalS3.host=<your_s3_endpoint> --set externalS3.port=<your_s3_port> --set externalS3.accessKey=<your_s3_access_key_id> --set externalS3.secretKey=<your_s3_secret_key> --set externalS3.bucketName=<your_bucket_name>
Prossimi passi
Scopri come configurare altre dipendenze di Milvus con Docker Compose o Helm: