centos minio升级注意事项

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

一 升级前检查清单

• 明确当前与目标版本，评估变更跨度。尤其是从非常老的版本（如 RELEASE.2020-05-08T02-40-49Z）升级时，注意中间变更：自 RELEASE.2022-10-29T06-21-33Z 起删除了网关与 filesystem 模式，无法“原地替换二进制”直接升级，需要新建实例并迁移数据。涉及安全修复时，建议至少升级到包含修复的版本，例如 RELEASE.2023-03-20T20-16-18Z 及以上。完成升级后，建议同步升级 mc（MinIO Client） 以避免兼容性问题。以上要点有助于确定升级路径（原地升级或迁移升级）与回滚边界。

二 原地升级与迁移升级的选择

• 原地升级（RPM/二进制替换）适用场景：版本跨度不大、配置与数据布局未发生结构性变更。步骤要点：先备份、停机、替换二进制（RPM 或 .tgz）、校验权限与目录、启动并验证。注意：使用 RPM 升级可能覆盖 /etc/systemd/system/minio.service，升级后需核对服务文件与启动参数是否被重置。
• 迁移升级（新建实例 + 数据迁移）适用场景：跨大版本、或老版本为 standalone/filesystem 模式（早于 2022-10-29）。做法：部署新版本实例（数据目录与旧实例隔离），通过 mc mirror 将旧实例的桶与对象复制到新实例，完成校验后再切换业务。此路径风险更可控，便于回滚。

三 常见不兼容与配置项变更

• 控制台端口参数更名：自 RELEASE.2023-10-12T01-33-48Z 起，命令行参数由 –consoleaddress 改为 –console-address（带连字符）。若 systemd 或脚本仍使用旧参数会导致启动失败，需按版本修正并重启服务。
• 存储与磁盘要求更严格：新版本对磁盘与路径更敏感，单机/集群建议使用 XFS，并将数据目录挂载到独立磁盘（避免根盘）；集群模式下，存储路径若位于根盘会被拒绝使用。升级前确认所有节点磁盘类型、数量与挂载一致。
• 单机部署提示与风险：升级后单机可能提示 “The standard parity is set to 0. This can lead to data loss.”，这是提醒单机容错能力有限，并非故障；如业务需要容错，请部署为分布式模式。
• 反向代理与控制台长连接：若通过 Nginx 代理 Console，需开启 HTTP/1.1 与 WebSocket 升级，否则控制台功能异常（如无法建立 WebSocket 连接）。示例配置：proxy_http_version 1.1、Upgrade/Connection 头。

四 回滚与验证

• 回滚预案：原地升级前备份旧二进制与配置；迁移升级保留旧实例与数据一段时间。出现异常可快速切回旧实例或回退到迁移前的数据状态。
• 升级后验证：使用 mc admin info 与 Console 检查集群/节点状态、磁盘使用与版本号；抽样校验关键桶的对象数量与可访问性；检查服务日志与监控告警，确认无启动报错与访问异常。