如何在Ubuntu上升级MinIO服务

Ubuntu上升级MinIO服务的实操指南

一 升级前准备

• 备份与回滚预案：对数据盘、配置目录（如 /etc/minio）、以及必要的证书做完整备份；记录当前版本号，准备随时回滚到旧二进制。
• 版本策略：生产环境建议始终安装最新版本；若无法频繁升级，也应确保版本发布时间不超过6个月。
• 客户端与生态：MinIO升级后，mc（MinIO Client）应在其后1–2周内同步升级；如使用 Operator，请注意升级 Operator 不会自动升级现有租户，租户需单独升级。
• 环境验证：在测试环境充分验证新版本，再执行生产升级；升级前确保磁盘空间充足、网络稳定。

二 标准升级步骤 systemd 二进制部署

• 查看并记录当前版本
  • 服务版本：
    • systemd服务：执行 sudo systemctl status minio | grep ExecStart 查看启动的二进制路径，然后 /usr/local/bin/minio --version
    • 控制台/容器：访问 http://服务器:控制台端口 右上角 About，或 mc admin info <alias>
• 准备新版本二进制
  • 访问 https://min.io/download 下载对应架构的最新 Linux amd64 二进制（.tgz），或在服务器用 wget 下载：
    • wget https://dl.min.io/server/minio/release/linux-amd64/minio -O /tmp/minio
• 平滑切换
  1. 停止服务：sudo systemctl stop minio
  2. 备份旧二进制：sudo cp /usr/local/bin/minio /usr/local/bin/minio.bak-$(date +%F)
  3. 部署新二进制：sudo install -m 0755 /tmp/minio /usr/local/bin/minio
  4. 如用 systemd，建议执行一次：sudo systemctl daemon-reload（替换二进制通常不需要，但替换/新增服务文件时需要）
  5. 启动服务：sudo systemctl start minio
  6. 验证：/usr/local/bin/minio --version、sudo systemctl status minio、mc admin info <alias>
  7. 确认无误后删除备份：sudo rm /usr/local/bin/minio.bak-$(date +%F)
• 可选 就地升级命令：若旧版本支持，可直接执行 mc admin update <alias> 完成下载与重启（仅在明确支持该命令的版本上使用）。

三 常见问题与处理

• 启动失败且提示 systemd 服务文件被覆盖：部分包管理或手工替换可能覆盖 /etc/systemd/system/minio.service。恢复步骤：
  • 使用备份的服务文件或重新创建最小化服务（示例）：
    • `sudo tee /etc/systemd/system/minio.service >/dev/null <<‘EOF’ [Unit] Description=MinIO After=network.target

[Service] Type=simple User=minio Group=minio ExecStart=/usr/local/bin/minio server /data/minio --console-address “:9001” ExecReload=/bin/kill -HUP $MAINPID Restart=always LimitNOFILE=65536

[Install] WantedBy=multi-user.target EOF`

• 然后 sudo systemctl daemon-reload && sudo systemctl restart minio
• 版本跨度过大导致兼容性问题：个别老版本不支持 mc admin update，需手动替换二进制并分阶段升级到中间版本，再到目标版本。
• 控制台或静态资源异常（如通过 Nginx 反代）：升级后若浏览器控制台报错（如 WebSocket 失败），在 Nginx 为 /ws/ 与 /console/ 路径开启 HTTP/1.1 与升级头：
  • proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
• 集群/单机行为变化：新版本对磁盘挂载与纠删码提示更严格，例如根盘路径可能被拒绝使用，单机将显示 .xl.meta 等内部元数据文件；这是正常变化。若单机仅单盘，会提示 parity=0 的风险告警，需知悉数据保护边界。

四 验证与回滚

• 版本与运行状态
  • minio --version、systemctl status minio、mc admin info <alias> 均正常；访问控制台确认功能可用。
• 日志排查
  • mc admin logs <alias> 查看错误与告警；必要时用 mc admin trace 深入跟踪 S3 调用。
• 快速回滚
  • 停止服务：sudo systemctl stop minio
  • 恢复二进制：sudo cp /usr/local/bin/minio.bak-<日期> /usr/local/bin/minio
  • 启动服务：sudo systemctl start minio