id: deploy_s3.md title: 使用 Docker Compose 或 Helm 配置对象存储 related_key: S3, 存储 summary: 学习如何使用 Docker Compose 或 Helm 为 Milvus 配置 S3 存储。

使用 Docker Compose 或 Helm 配置对象存储

Milvus 默认使用 MinIO 作为对象存储，但也支持使用 Amazon Simple Storage Service (S3) (opens in a new tab) 作为持久对象存储来存储日志和索引文件。本主题描述了如何配置 Milvus 的 S3 存储。如果你对 MinIO 满意，可以跳过本主题。

你可以使用 Docker Compose (opens in a new tab) 或在 K8s 上配置 S3。

使用 Docker Compose 配置 S3

1. 配置 S3

MinIO (opens in a new tab) 与 S3 兼容。要使用 Docker Compose 配置 S3，请在 milvus/configs 路径下的 milvus.yaml 文件中为 minio 部分提供你的值。

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>"

更多信息请参阅 MinIO/S3 配置。

2. 优化 docker-compose.yaml

你还需要在 docker-compose.yaml 文件中的 milvus 服务的 MINIO_ADDRESS 环境变量。默认情况下，Milvus 将使用本地的 MinIO 而不是外部的 S3。

3. 运行 Milvus

运行以下命令启动使用 S3 配置的 Milvus。

docker compose up

在 K8s 上配置 S3

对于在 K8s 上的 Milvus 集群，你可以在启动 Milvus 的同一命令中配置 S3。另外，你也可以在 milvus-helm (opens in a new tab) 仓库中 charts/milvus 路径下的 values.yml 文件中配置 S3，然后再启动 Milvus。

下表列出了在 YAML 文件中配置 S3 的键。

键	描述	值
minio.enabled	启用或禁用 MinIO	true / false
externalS3.enabled	启用或禁用 S3	true / false
externalS3.host	访问 S3 的终端节点
externalS3.port	访问 S3 的端口
externalS3.rootPath	S3 存储的根路径	默认为空字符串
externalS3.accessKey	S3 的访问密钥 ID
externalS3.secretKey	S3 的访问密钥
externalS3.bucketName	S3 存储桶的名称
externalS3.useSSL	连接时是否使用 SSL	值默认为 false

使用 YAML 文件

在 values.yaml 文件中配置 minio 部分。

minio:
  enabled: false

在 values.yaml 文件中使用你的值配置 externalS3 部分。

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>"
  useSSL: <true/false>

在配置上述部分并保存 values.yaml 文件后，运行以下命令安装使用 S3 配置的 Milvus。

helm install <your_release_name> milvus/milvus -f values.yaml

使用命令

要安装 Milvus 并配置 S3，请使用以下命令并使用你的值。

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>

下一步操作

Learn how to configure other Milvus dependencies with Docker Compose or Helm:

部署 Pulsar(Deploy_pulsar)动态配置(Dynamic_config)