Minio分布式模式部署报错：所有ServerPool需相同Deployment ID

问题原因 #

分布式Minio集群要求所有节点的Deployment ID完全一致。这个ID是Minio首次启动时自动生成，并存放在节点数据目录下的.minio.sys/config/config.json文件中。
如果之前在这些节点上单独启动过Minio（单节点模式），或者用过不同的集群配置启动，每个节点会生成独立的Deployment ID，后续组成分布式集群时就会触发ID不匹配的报错。

解决方法 #

方法一：统一已有节点的Deployment ID #

1. 停止所有节点的Minio服务

   # 以systemd管理为例，根据实际情况调整命令
   sudo systemctl stop minio
   

2. 选取一个节点作为基准，提取它的Deployment ID
   • 进入该节点的Minio数据目录，打开.minio.sys/config/config.json
   • 找到"deploymentid"字段，复制对应的ID值（比如"abcdef123456..."）
3. 修改其他所有节点的配置文件
   • 打开其他节点的.minio.sys/config/config.json
   • 将"deploymentid"字段的值替换为基准节点的ID，保存文件
4. 确保所有节点使用完全一致的启动命令（包含所有节点地址、存储路径）
   示例启动命令：

   minio server http://node-ip-1/data-path http://node-ip-2/data-path
   

5. 重新启动所有节点的Minio服务

方法二：全新初始化集群（适合未存储重要数据的场景） #

如果节点上没有需要保留的数据，直接删除所有节点的.minio.sys目录，然后用统一的启动命令同时启动所有节点，Minio会自动生成一致的Deployment ID：

# 删除元数据目录
rm -rf /path/to/minio/data/.minio.sys
# 启动集群（所有节点执行相同命令）
minio server http://node-ip-1/data-path http://node-ip-2/data-path

注意事项 #

• 所有节点的系统时间必须同步，时间偏差过大可能导致元数据同步异常
• 启动集群时，务必保证所有节点的启动参数完全一致，包括节点列表、存储路径、端口等

内容的提问来源于stack exchange，提问作者Rendy Muhardianto