如何在Ubuntu上升级MinIO存储

如何在Ubuntu上升级MinIO存储

一、升级前的准备工作

备份数据：升级前务必备份所有重要数据（如/data/minio目录下的所有文件），防止升级过程中出现意外导致数据丢失。
检查兼容性：阅读新版本的发布说明（Release Notes），确认是否有不兼容的配置变更（如API接口调整、配置文件格式修改）。
准备工具：下载MinIO命令行工具mc（用于数据同步），可通过wget https://dl.min.io/client/mc/release/linux-amd64/mc获取，赋予执行权限后移动到系统PATH目录。

二、卸载旧版本MinIO（可选但推荐）

若旧版本是通过二进制文件直接安装的，可执行以下命令卸载：

sudo rm -rf /usr/local/bin/minio       # 删除MinIO二进制文件
sudo rm -rf /etc/systemd/system/minio.service  # 删除systemd服务文件
sudo rm -rf /etc/default/minio         # 删除环境变量配置文件

若旧版本是通过包管理器（如APT）安装的，可使用sudo apt remove minio卸载。

三、下载并安装新版本MinIO

下载新版本：通过MinIO官方网站下载最新版本的Linux amd64二进制文件（如minio.RELEASE.2025-XX-XXT00-00-00Z），使用wget命令示例：
```
wget https://dl.min.io/server/minio/release/linux-amd64/minio
```

赋予执行权限并移动：

chmod +x minio                         # 赋予可执行权限
sudo mv minio /usr/local/bin/          # 移动到系统PATH目录

配置环境变量（可选）：若需自定义管理员账号或存储路径，可编辑/etc/default/minio文件，设置以下参数：

minio_root_user=admin                  # 管理员账号（默认admin）
minio_root_password=your_strong_password  # 管理员密码（至少8位）
minio_volumes=/data                     # 存储路径（需与旧版本一致）
minio_opts="--console-address :9001"    # 控制台端口（默认9001）

四、数据同步（关键步骤：确保数据兼容）

由于新版本MinIO可能不兼容旧版本数据格式，需通过mc工具将旧数据同步到新目录：

配置mc别名：

mc alias set minio-old http://127.0.0.1:9000 admin old_password  # 旧版本MinIO（原运行端口9000）
mc alias set minio-new http://127.0.0.1:9001 admin new_password  # 新版本MinIO（临时运行端口9001）

启动旧版本MinIO：确保旧版本正常运行，监听原端口（如9000）：

./minio.RELEASE.2021-03-26T00-00-41Z server /data/minioData --console-address ":9000"

同步数据到新目录：使用mc mirror命令将旧数据同步到新目录（如/data/minioData_v2）：

mkdir -p /data/minioData_v2            # 新版本数据目录
mc mirror --overwrite --remove minio-old/minio minio-new/minio  # 全量同步（--overwrite覆盖已有对象，--remove删除目标多余对象）

验证数据一致性：通过mc ls命令检查新旧目录中的存储桶和对象是否一致。

五、启动新版本MinIO并验证

启动新版本服务：使用新版本MinIO启动新数据目录：
```
minio server /data/minioData_v2 --console-address ":9001"
```

检查服务状态：通过systemctl命令确认服务是否正常运行：

sudo systemctl status minio              # 查看服务状态
journalctl -u minio -f                   # 实时查看日志（排查错误）

访问控制台：在浏览器中访问http://your_server_ip:9001，使用配置的管理员账号（minio_root_user）和密码（minio_root_password）登录，验证存储桶、对象是否正常显示。

六、切换生产流量（可选：负载均衡场景）

若使用Nginx或负载均衡器（LB），可将流量从旧版本节点切换到新版本节点：

更新LB配置：将后端服务器指向新版本MinIO的IP和端口（如9000）。
停止旧版本服务：确认新版本运行稳定后，停止旧版本MinIO进程。

注意事项

生产环境建议：先在测试环境验证升级流程，确保数据同步和功能正常。
回滚方案：保留旧版本MinIO二进制文件和数据目录（如/data/minioData），若新版本出现问题，可快速回滚到旧版本。
监控日志：升级后密切关注MinIO日志（/var/log/minio.log），及时处理异常（如权限问题、存储路径错误）。