Linux中MinIO如何升级

一、升级前的准备工作

1. 备份数据：升级前务必备份MinIO中的所有重要数据（可通过mc客户端或直接复制数据目录），防止升级过程中出现意外导致数据丢失。
2. 检查版本兼容性：确认新版本MinIO与当前系统环境（如Linux发行版、内核版本）、依赖组件（如mc客户端）的兼容性。特别注意：MinIO版本≥RELEASE.2023-10-12T01-33-48Z时，控制台参数需使用--console-address（带连字符），旧版本则使用--consoleaddress（无连字符），避免启动失败。

二、停止当前MinIO服务 若MinIO通过systemd管理，执行以下命令停止服务：

sudo systemctl stop minio

若通过脚本或其他方式启动，可使用pkill命令强制停止：

sudo pkill minio

三、卸载旧版本（可选但推荐）

1. 删除旧版本MinIO二进制文件：

   sudo rm -rf /usr/local/bin/minio
   

2. 删除旧版systemd服务文件和环境配置：

   sudo rm -rf /etc/systemd/system/minio.service
   sudo rm -rf /etc/default/minio
   

四、下载并安装新版本

1. 下载新版本二进制文件：访问MinIO官方下载页面（如https://dl.min.io/server/minio/release/linux-amd64/minio），获取最新版本链接，使用wget下载：

   wget https://dl.min.io/server/minio/release/linux-amd64/minio
   

2. 赋予执行权限：

   chmod +x minio
   

3. 移动至系统路径：

   sudo mv minio /usr/local/bin/
   

五、配置新版本

1. 创建systemd服务文件：若旧版服务文件已删除，新建/etc/systemd/system/minio.service，内容如下（根据实际情况调整minio_volumes和minio_opts）：

   [Unit]
   Description=MinIO
   Documentation=https://min.io/docs/minio/linux/index.html
   Wants=network-online.target
   After=network-online.target
   AssertFileIsExecutable=/usr/local/bin/minio
   
   [Service]
   WorkingDirectory=/usr/local
   ProtectProc=invisible
   EnvironmentFile=-/etc/default/minio
   ExecStartPre=/bin/bash -c "if [ -z \"${minio_volumes}\" ]; then echo \"variable minio_volumes not set in /etc/default/minio\"; exit 1; fi"
   ExecStart=/usr/local/bin/minio server $minio_opts $minio_volumes
   Restart=always
   LimitNoFile=65536
   TasksMax=infinity
   TimeoutStopSec=infinity
   SendSigKill=no
   
   [Install]
   WantedBy=multi-user.target
   

2. 配置环境变量：编辑/etc/default/minio，设置访问密钥、数据目录等参数（根据旧版配置调整，注意控制台参数格式）：

   minio_root_user=admin
   minio_root_password=your_strong_password
   minio_volumes=/data
   minio_opts="--address :9000 --console-address :9001"  # 新版本使用--console-address
   

六、启动新版本服务

1. 重载systemd配置：

   sudo systemctl daemon-reload
   

2. 启用开机自启动：

   sudo systemctl enable minio
   

3. 启动MinIO服务：

   sudo systemctl start minio
   

七、验证升级结果

1. 检查服务状态：

   sudo systemctl status minio
   

   若显示active (running)，说明服务已启动。
2. 查看版本信息：

   minio --version
   

   确认输出为新版本号。
3. 登录控制台：通过浏览器访问http://<服务器IP>:9001（根据minio_opts中的--console-address调整），使用配置的minio_root_user和minio_root_password登录，验证功能是否正常。

八、注意事项

• 集群环境：若为MinIO集群，需逐个节点升级，确保所有节点升级完成后再同步数据。
• 参数兼容性：升级前检查配置文件中的参数（如--consoleaddress），根据新版本要求调整，避免启动失败。
• 客户端兼容性：升级MinIO服务器后，建议同步升级mc客户端（如npm install minio@latest），确保客户端与服务端版本兼容，避免签名错误等问题。