MinIO安装后如何更新

MinIO 升级指南

升级前准备

• 做好完整备份：至少备份 MinIO 数据目录 与 配置目录，并确保有可用的 root 凭据 或 mc 管理员别名。
• 选择维护窗口：虽然 MinIO 支持快速重启，仍建议避开业务高峰。
• 版本跨度评估：若当前版本非常老（例如 2020 年左右）或使用已废弃模式，可能无法直接二进制替换升级，需要迁移；MinIO 支持跨多个大版本直接升级，但老版本可能不支持 mc admin update。
• 环境检查：确认所有节点均为 MinIO 部署节点（非其他 S3 兼容服务），并准备好回滚方案。

Linux 二进制与 systemd 场景

• 方式一（推荐）mc 在线升级
  1. 使用 mc alias 配置对目标集群的别名（如：mc alias set myminio http://IP:9000 ACCESS_KEY SECRET_KEY）。
  2. 在所有节点上执行：mc admin update myminio。该命令会原子化更新所有服务器并重启，过程快速且不中断业务。
  3. 验证：mc admin info myminio 或访问 Console 查看版本。
• 方式二 手动替换二进制
  1. 停止服务：sudo systemctl stop minio。
  2. 备份旧二进制与配置：cp /usr/local/bin/minio /usr/local/bin/minio.bak-$(date +%F)。
  3. 下载新版本（.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）
  4. 如用 systemd，注意某些安装方式在升级 rpm 时会覆盖 /etc/systemd/system/minio.service，需按原有环境重新校正服务文件与 EnvironmentFile（如 /etc/default/minio）。
  5. 启动：sudo systemctl start minio；验证版本与运行状态。
• 方式三 就地重启升级
  直接替换二进制后执行 systemctl restart minio，MinIO 的快速重启与一致性保证可尽量降低影响。

Kubernetes 场景

• 升级 MinIO Operator：
  1. 检查 Operator 与资源状态：kubectl get all -n minio-operator；kubectl get pod -l ‘name=minio-operator’ -n minio-operator -o json | jq ‘.items[0].spec.containers’。
  2. 下载并更新 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/
  3. 执行升级：kubectl minio init（或按控制台/Helm 流程升级）。
  4. 验证新版本：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 不可用，采用“新实例 + 数据迁移”方案更稳妥。
• 变更窗口与回滚预案：在变更单中记录回滚路径与验证步骤，升级后第一时间完成健康检查与抽样验证。