MinIO安装后如何更新
小樊
48
2025-11-16 22:45:17
MinIO 升级指南
升级前准备
做好完整备份:至少备份 MinIO 数据目录 与 配置目录 ,并确保有可用的 root 凭据 或 mc 管理员别名 。
选择维护窗口:虽然 MinIO 支持快速重启,仍建议避开业务高峰。
版本跨度评估:若当前版本非常老(例如 2020 年 左右)或使用已废弃模式,可能无法直接二进制替换升级,需要迁移;MinIO 支持跨多个大版本直接升级,但老版本可能不支持 mc admin update 。
环境检查:确认所有节点均为 MinIO 部署节点 (非其他 S3 兼容服务),并准备好回滚方案。
Linux 二进制与 systemd 场景
方式一(推荐)mc 在线升级
使用 mc alias 配置对目标集群的别名(如:mc alias set myminio http://IP:9000 ACCESS_KEY SECRET_KEY)。
在所有节点上执行:mc admin update myminio。该命令会原子化更新所有服务器并重启,过程快速且不中断业务。
验证:mc admin info myminio 或访问 Console 查看版本。
方式二 手动替换二进制
停止服务:sudo systemctl stop minio。
备份旧二进制与配置:cp /usr/local/bin/minio /usr/local/bin/minio.bak-$(date +%F)。
下载新版本(.tgz 或 .rpm),替换二进制:
tgz:tar xzf minio--linux-amd64.tgz && mv minio /usr/local/bin/minio && chmod +x /usr/local/bin/minio
rpm:sudo dnf update minio-.rpm(或 rpm -Uvh)
如用 systemd,注意某些安装方式在升级 rpm 时会覆盖 /etc/systemd/system/minio.service ,需按原有环境重新校正服务文件与 EnvironmentFile (如 /etc/default/minio)。
启动:sudo systemctl start minio;验证版本与运行状态。
方式三 就地重启升级
直接替换二进制后执行 systemctl restart minio,MinIO 的快速重启与一致性保证可尽量降低影响。
Kubernetes 场景
升级 MinIO Operator:
检查 Operator 与资源状态:kubectl get all -n minio-operator;kubectl get pod -l ‘name=minio-operator’ -n minio-operator -o json | jq ‘.items[0].spec.containers’。
下载并更新 kubectl-minio 插件(替换版本号):
curl https://github.com/minio/operator/releases/download/v4.5.8/kubectl-minio_4.5.8_linux_amd64 -o kubectl-minio
chmod +x kubectl-minio && mv kubectl-minio /usr/local/bin/
执行升级:kubectl minio init(或按控制台/Helm 流程升级)。
验证新版本:kubectl minio version、kubectl get pod -n minio-operator。
说明:Operator 管理的集群升级遵循无中断理念,具体步骤以所用版本文档为准。
特殊与回滚
老版本直接替换失败或无法使用 mc admin update:这是已知现象。建议部署新实例,通过 mc mirror 或桶复制将旧数据迁移到新实例(注意新实例使用独立目录/磁盘),完成验证后再切换流量。
回滚:保留旧二进制(如 minio.bak-),出现异常时停止服务、恢复旧二进制并重启;若使用包管理器升级,按系统支持方式降级(如 dnf/yum/rpm)。
验证要点:
版本:mc admin info 或 Console 首页显示版本号。
健康:mc admin health 。
数据:抽查关键 bucket/对象 的可用性。
注意事项
避免混合版本:确保所有节点在同一时间窗口内完成升级,防止出现部分节点旧、部分节点新的不一致状态。
配置与服务文件:使用包管理器升级可能覆盖 systemd 服务文件 或环境变量文件,升级后务必复核 /etc/systemd/system/minio.service 与 /etc/default/minio 。
升级跨度:MinIO 通常支持跨多个版本直接升级,但极老版本可能需先过渡中间版本;若 mc admin update 不可用,采用“新实例 + 数据迁移”方案更稳妥。
变更窗口与回滚预案:在变更单中记录回滚路径与验证步骤,升级后第一时间完成健康检查与抽样验证。