跳到主要内容

配置 S3 或 MinIO 存储仓库

StorageRepository 描述 Velero 备份数据使用的对象存储。备份恢复和容灾同步都依赖它保存资源清单、PVC 数据和恢复元数据。

存储要求​

对象存储需要满足：

  • S3 兼容 API。
  • 源集群和目标集群都能访问 endpoint。
  • bucket 已创建，或有权限创建。
  • access key 和 secret key 权限足够。
  • 如果使用自签 CA，集群侧需要信任 CA。
  • 如果使用 MinIO，确认 path-style 或 virtual-host-style 地址模式配置正确。

控制台操作​

进入 资源配置 / 仓库配置管理，查看当前存储仓库和连接状态。

仓库配置管理

点击 添加仓库，填写：

  • 仓库名称。
  • endpoint 和 bucket。
  • region。
  • access key、secret key。
  • 地址模式、CA、容量配额等高级参数。

保存前先执行连接测试，确认管理集群、源集群和目标集群都可以访问。

添加仓库

API 等价操作​

GET  /apis/storage.testudo.softcdata.com/v1/storages
POST /apis/storage.testudo.softcdata.com/v1/storages
POST /apis/storage.testudo.softcdata.com/v1/storages/validate/connection
POST /apis/storage.testudo.softcdata.com/v1/storages/connectivity/validate

与 Velero BSL 的关系​

平台会根据仓库配置维护 Velero BackupStorageLocation。跨集群恢复时，目标集群必须能读取同一个备份仓库，否则恢复前置检查会失败。

建议为生产环境配置：

  • 独立 bucket 或清晰的 prefix。
  • 生命周期规则，避免历史备份无限增长。
  • 容量和对象数量告警。
  • 访问密钥轮换流程。
  • 对关键 bucket 开启版本保护或误删保护。

注册后验证​

  • 仓库状态为 Ready。
  • 源集群可以写入备份对象。
  • 目标集群可以读取备份对象。
  • 任务事件中没有 BackupStorageLocation unavailable。
  • MinIO 或云厂商控制台中能看到备份对象写入。