Milvus 2.5.14 使用 milvus-backup v0.5.7 的备份实践

wget https://github.com/zilliztech/milvus-backup/releases/download/v0.5.7/milvus-backup_Linux_x86_64.tar.gz
tar -xzf milvus-backup_Linux_x86_64.tar.gz
chmod +x milvus-backup
mv milvus-backup /usr/local/bin/

2. 确认 Milvus 服务信息

查看 Kubernetes Service：

kubectl get svc -n milvus

输出：

NAME     TYPE       CLUSTER-IP      PORT(S)
milvus   ClusterIP  10.233.48.134   19530/TCP,9091/TCP

19530 → gRPC 客户端连接
9091 → HTTP API（gcPause 功能）

如果在集群内部运行 milvus-backup，可直接用 10.233.48.134；
如果在集群外运行，需要 kubectl port-forward：

kubectl port-forward svc/milvus 19530:19530 9091:9091 -n milvus

3. 编写 backup.yaml 配置

这是 v0.5.7 必须遵守的完整配置格式，注意 milvus.address 和 milvus.port 分开写，日志配置必须包含 log.file.rootPath。

log:
  level: info
  console: true
  file:
    rootPath: "logs/backup.log"

http:
  simpleResponse: true

milvus:
  address: 10.233.48.134
  port: 19530
  user: ""
  password: ""
  tlsMode: 0
  rpcChannelName: "by-dev-replicate-msg"

minio:
  storageType: "minio"
  address: 10.130.135.145
  port: 9000
  accessKeyID: "FGNB*****"
  secretAccessKey: "9VtCpfoO*****"
  bucketName: "milvus-data"
  rootPath: "files"

  backupStorageType: "minio"
  backupAddress: 10.130.135.145
  backupPort: 9000
  backupAccessKeyID: "FGNB*****"
  backupSecretAccessKey: "9VtCpfoO*****"
  backupBucketName: "milvus-data"
  backupRootPath: "backup"
  backupUseSSL: false
  crossStorage: "false"

backup:
  maxSegmentGroupSize: 2G
  parallelism:
    backupCollection: 4
    copydata: 128
    restoreCollection: 2
    importJobNum: 768
  gcPause:
    enable: true
    address: http://10.233.48.134:9091

4. 执行备份

创建备份：

milvus-backup create --config backup.yaml --set BACKUP_NAME=backup_$(date +%Y%m%d_%H%M%S)

恢复备份：

milvus-backup restore --config backup.yaml --set BACKUP_NAME=backup_20250723_153000

列出备份：

milvus-backup list --config backup.yaml

删除备份：

milvus-backup delete --config backup.yaml --set BACKUP_NAME=backup_20250723_153000

5. 遇到的问题及解决方案

(1) `invalid key: log.file.rootpath`

原因：配置文件缺少或拼写错误 log.file.rootPath
解决：必须写 rootPath，且区分大小写

(2) `invalid key: milvus.port` 或 `milvus.address`

原因：配置字段不能写成 host:port，必须拆分为 address 和 port 两个字段
解决：按官方示例写 address: 10.233.48.134 和 port: 19530

(3) 备份只有 meta 文件

检查 utility.list_collections() 和 Collection.num_entities，发现数据量只有 0 或 1
原因：Milvus 备份实际数据段（segment），数据过少时只备份 meta
解决：确认数据写入流程，或手动调用 flush() 生成 segment 后再备份

(4) `gcPause.address` 配置错误

需要指向暴露 9091 的 Milvus 服务
在集群内使用 ClusterIP:9091，外部使用 port-forward 127.0.0.1:9091

6. 数据验证

在 Python 中使用 pymilvus 检查数据：

from pymilvus import connections, utility, Collection

connections.connect("default", host="10.233.48.134", port="19530")

# 列出所有集合
collections = utility.list_collections()
for name in collections:
    c = Collection(name)
    print(f"{name}: {c.num_entities} entities")