Ubuntu MinIO版本更新与升级指南

Ubuntu 上 MinIO 的版本更新与升级指南

一 升级前准备

• 明确安装方式：区分是二进制部署（systemd 服务）还是Docker 部署，两者升级路径不同。
• 做好数据与配置备份：至少备份 /etc/minio（或环境变量文件）、systemd 服务文件、以及所有 数据盘/存储目录；如为生产环境，建议先做全量备份与快照。
• 选择升级方式：
  • 二进制方式建议采用原地升级（下载新二进制→替换→重启服务），避免删除旧二进制导致配置与服务中断。
  • Docker 方式建议拉取新镜像→停旧容器→启新容器（挂载相同卷与环境变量）。
• 权限与账号：确保运行 MinIO 的系统用户对数据目录与配置目录具备读写权限；如使用环境变量，准备好 MINIO_ROOT_USER / MINIO_ROOT_PASSWORD。
• 版本与兼容性：升级前确认目标版本与现有环境（如 Linux 架构 x86_64/ARM、内核、磁盘空间）兼容；升级后管理功能可能变化，见下文“重要变更”。

二 二进制部署升级步骤 systemd

• 步骤 1 检查与备份
  • 查看当前版本：
    • 服务方式：sudo systemctl status minio 或 journalctl -u minio -b
    • 命令行方式：/usr/local/bin/minio --version
  • 备份数据与配置：sudo cp -a /etc/minio /etc/minio.bak-$(date +%F)；备份数据盘与 systemd 文件。
• 步骤 2 下载并替换二进制
  • 前往 MinIO 下载页获取与你架构匹配的版本（如 linux-amd64），下载 .tgz 包：
    • wget https://dl.min.io/server/minio/release/linux-amd64/archive/minio.RELEASE.<版本号>/minio.RELEASE.<版本号>-linux-amd64.tgz
  • 解压并替换二进制（保留原文件以便回滚）：
    • tar -xvf minio.RELEASE.<版本号>-linux-amd64.tgz
    • sudo cp /usr/local/bin/minio /usr/local/bin/minio.bak-$(date +%F)
    • sudo mv minio /usr/local/bin/minio
    • sudo chmod +x /usr/local/bin/minio
• 步骤 3 重启并验证
  • 重启服务：sudo systemctl restart minio
  • 查看状态与版本：sudo systemctl status minio；/usr/local/bin/minio --version
  • 可选：用 mc 或控制台检查集群/桶是否正常。
• 回滚方案
  • 快速回滚：sudo cp /usr/local/bin/minio.bak-<日期> /usr/local/bin/minio && sudo systemctl restart minio
• 重要提示
  • 若通过 RPM/DEB 包升级，可能覆盖 /etc/systemd/system/minio.service；升级后请核对服务文件与 EnvironmentFile 配置是否正确。

三 Docker 部署升级步骤

• 步骤 1 拉取新镜像
  • docker pull minio/minio:RELEASE.<版本号>
• 步骤 2 停止并启动新容器（保持卷与端口一致）
  • 建议先停旧容器：docker stop minio
  • 启动新容器（示例，按你的卷与环境变量调整）：
    • docker run -d --name minio \
-p 9000:9000 -p 9090:9090 \
-v /data:/data \
-e MINIO_ROOT_USER=minioadmin \
-e MINIO_ROOT_PASSWORD=minioadmin \
minio/minio:RELEASE.<版本号> server /data --console-address ":9090"
• 步骤 3 验证
  • docker ps 查看容器状态；docker logs -f minio 观察启动日志；用 mc 或控制台验证。
• 回滚方案
  • 停止新容器并启动旧版本镜像（保留相同卷与端口映射）。

四 重要变更与注意事项

• 控制台功能变更：自 RELEASE.2025-05-24T17-08-30Z 起，社区版 Web 控制台移除了用户管理、策略配置、系统设置等管理功能，仅保留对象浏览器；相关管理需通过 mc 命令行完成，或选择企业版。升级到该版本及之后时，请提前熟悉 mc 操作。
• 服务文件覆盖风险：使用 RPM/DEB 升级可能覆盖 systemd 服务文件；升级后务必核对 ExecStart、EnvironmentFile、WorkingDirectory 等关键项是否正确。
• 升级顺序与回滚：建议先在测试环境验证；生产环境选择低峰时段操作，保留旧二进制/旧镜像以便快速回滚；升级后第一时间用 mc admin info、控制台与业务连通性进行健康检查。