mc admin rebalance

权限

执行此命令的用户必须拥有该部署的 admin:Rebalance 策略操作。

描述

mc admin rebalance 命令可用于在 MinIO 部署上启动、监控或停止再平衡操作。 再平衡会在部署中的所有池之间重新分配对象。

当新增 服务器池 时，MinIO 不会自动对对象执行再平衡。 相反，MinIO 会将 新对象写入 相较于部署中其他可用池可用空间更多的池。 触发手动再平衡流程会促使 MinIO 扫描整个部署，并按需移动对象，以使所有池的可用空间大致相当。

这是一项开销大且耗时的操作。 建议仅在部署负载较轻或空闲时运行再平衡流程。 如果在再平衡期间发生写操作，这些写操作会并行处理，并写入当前未参与再平衡的池。

你可以停止再平衡，并在之后按需重新启动。

使用以下命令跟踪正在进行的再平衡操作进度：

mc admin trace --call rebalance ALIAS

mc admin rebalance 命令具有以下子命令：

子命令说明
mc admin rebalance start在 MinIO 部署上启动再平衡操作。
mc admin rebalance status输出正在进行的再平衡操作的当前状态。
mc admin rebalance stop停止正在进行中的再平衡操作。

语法

mc admin rebalance start

mc-cmd

为 MinIO 部署启动再平衡操作。

假设一个 MinIO 部署有两个池，并分配了别名 minio1。 其中一个池有 250 GB 可用空间，另一个池有 3 TB 可用空间。

mc admin rebalance 命令会将对象从可用空间较少的池迁移到可用空间较多的池，使两个池的可用空间大致相等。

mc admin rebalance start minio1

该命令的语法如下：

mc [GLOBALFLAGS] admin rebalance start ALIAS
  • 将 ALIAS 替换为要执行再平衡的 MinIO 部署的 别名。

mc admin rebalance status

mc-cmd

查询具有活动再平衡进程的部署，并返回该再平衡进程的状态信息。

状态输出包括再平衡操作 ID、操作时间，以及部署中每个池的详细信息。 对每个池，状态会显示池 ID、该池的再平衡状态、已用空间百分比以及该池的再平衡进度。

mc admin rebalance status minio1

该命令的语法如下：

mc [GLOBALFLAGS] admin rebalance ALIAS
  • 将 ALIAS 替换为 MinIO 部署的 别名。

mc admin rebalance stop

mc-cmd

结束指定部署上正在进行中的再平衡任务。

mc admin rebalance stop minio1

该命令的语法如下：

mc [GLOBALFLAGS] admin rebalance stop ALIAS
  • 将 ALIAS 替换为 MinIO 部署的 别名。

全局标志

此命令支持 全局标志 中的任意选项。

行为

先备份集群设置

在开始下线操作前，使用 mc admin cluster bucket export 和 mc admin cluster iam export 命令分别对存储桶元数据和 IAM 配置进行快照。 必要时可使用这些快照恢复存储桶/IAM 设置，以便从用户或进程错误中恢复。

再平衡会忽略已过期对象和尾部 DeleteMarker

从 RELEASE.2023-06-23T20-26-00Z 开始，再平衡会忽略那些基于父存储桶已配置的 生命周期规则 而过期的对象版本。

再平衡还会忽略仅剩余版本为 删除标记 的对象。 这可避免对已被视为完全删除的对象执行跨池 I/O。

MinIO 依赖 scanner 来识别并清理这些过期对象或尾部 DeleteMarker 对象。

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档，© 2020–至今 MinIO, Inc.，依据 CC BY 4.0 授权，由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入，以英文原文为准。