minio版本更新centos注意

CentOS 上升级 MinIO 的关键注意事项

一 升级前检查

• 核对当前与目标版本差异，重点查看发行说明中的不兼容变更与升级路径；分布式集群升级前先在测试环境验证。
• 完整备份：对数据盘、配置目录（如 /etc/minio）、以及可能的systemd 服务文件与环境变量文件（如 /etc/default/minio）做备份。
• 选择升级方式：
  • 二进制替换/手动滚动重启（适用于自管环境）。
  • 使用 mc admin update 统一升级（更省心，但需满足权限条件）。
• 权限与目录：执行升级的用户必须对 MinIO 二进制所在父目录具备写权限（例如二进制在 /usr/local/bin/minio，则需要对 /usr/local/bin 可写）。
• 环境一致性：确认 SELinux/防火墙策略、数据目录权限、运行用户与启动参数在升级后仍然有效。

二 升级路径选择

• 二进制方式（通用）
  1. 停止服务：systemctl stop minio
  2. 备份旧二进制与配置：cp /usr/local/bin/minio /usr/local/bin/minio.bak-$(date +%F)
  3. 下载新版本二进制并赋权：wget https://dl.min.io/server/minio/release/linux-amd64/minio && chmod +x minio
  4. 替换二进制：mv minio /usr/local/bin/
  5. 启动并验证：systemctl start minio && minio --version
• RPM 包方式（CentOS 常用）
  1. 检查已装包：rpm -qa | grep minio
  2. 升级或重装：优先尝试 sudo dnf update minio.rpm；若出现“文件冲突”，先卸载旧包再安装新包：
     • 卸载：sudo rpm -e minio-<旧版本号>
     • 安装：sudo rpm -ivh minio-<新版本号>.rpm
  3. 注意：RPM 升级可能覆盖 /etc/systemd/system/minio.service，需按实际环境复核服务文件与 EnvironmentFile（如 /etc/default/minio）。

三 分布式与特殊环境

• 滚动升级：MinIO 支持在分布式集群中逐个节点替换二进制并重启，业务不中断；也可使用 mc admin update 一次性升级并重启全部节点。
• 前提条件与限制：
  • mc admin update 要求运行用户对二进制父目录可写。
  • Kubernetes/容器环境不支持 mc admin update，应使用 Operator/容器编排的滚动更新策略。
  • 若使用 KES/Vault/etcd 等外部组件，需按各自组件的升级流程先行处理。

四 CentOS 系统与服务注意事项

• 防火墙与端口：确保 API 端口 9000 与（如启用）控制台端口 9001 已放行。示例：
  • firewall-cmd --zone=public --add-port=9000/tcp --permanent && firewall-cmd --reload
  • 如使用 iptables：iptables -A INPUT -p tcp --dport 9000 -j ACCEPT && service iptables restart
• systemd 服务文件：RPM 升级可能覆盖自定义服务文件，升级后核对 /etc/systemd/system/minio.service 中的 ExecStart、EnvironmentFile、User/Group、LimitNOFILE 等关键项。
• 控制台端口：若通过 --console-address ":9001" 指定控制台端口，请同步开放 9001/tcp。
• 时间与一致性：生产环境建议开启 NTP，节点间时间差不宜过大（如不超过3秒），避免认证/复制异常。

五 升级后验证与回滚

• 版本与连通性：
  • 执行 minio --version 确认版本号；
  • 访问控制台 http://:9001 或使用 mc ls <alias> 验证对象与桶可正常访问。
• 功能与权限：如依赖 Web UI 的权限管理能力，注意社区版在 2025-05 之后有功能变更（Web UI 不再提供权限设置入口），需通过 mc 命令行管理；若需保留 UI 权限功能，请选择 2025-04-22 及之前的社区版。
• 日志与告警：检查 journalctl -u minio -xe 与服务日志，确认无启动失败、磁盘/权限告警。
• 快速回滚：
  • 二进制方式：将备份二进制移回 /usr/local/bin/minio 并重启服务；
  • RPM 方式：卸载新包后重装旧包，恢复服务文件与配置。