Ubuntu环境下如何升级MinIO

Ubuntu环境下升级MinIO的详细步骤

1. 升级前准备工作

• 备份重要数据：升级过程中可能存在数据丢失风险，务必提前备份MinIO存储的所有关键数据（如通过rsync或MinIO自带的mc工具复制到本地或其他存储设备）。
• 检查系统环境：确保Ubuntu系统已更新至最新版本（sudo apt update && sudo apt upgrade -y），并确认网络连接稳定（升级需下载新版本安装包）。
• 查看版本兼容性：查阅MinIO官方发布说明，确认新版本与当前Ubuntu版本、内核版本（uname -r）及现有配置（如存储路径、端口）兼容。

2. 停止当前MinIO服务

• 若MinIO通过systemd服务运行，执行以下命令停止：
  sudo systemctl stop minio
• 若通过Docker容器运行，执行：
  docker stop <minio_container_name_or_id>（<minio_container_name_or_id>可通过docker ps获取）。

3. 下载最新版本MinIO

• 通过APT包管理器升级（推荐，适用于通过APT安装的MinIO）：
  ① 添加MinIO官方GPG密钥（确保软件包来源可信）：
  wget -qO - https://dl.min.io/server/minio/gpg/minio.gpg | sudo apt-key add -
  ② 添加MinIO官方APT仓库（替换为最新仓库地址，以官网为准）：
  echo "deb https://dl.min.io/server/minio/release/linux-amd64/ minio main" | sudo tee /etc/apt/sources.list.d/minio.list
  ③ 更新包列表并升级MinIO：
  sudo apt update && sudo apt install --only-upgrade minio
• 手动下载二进制文件（适用于自定义安装路径或非APT安装）：
  访问MinIO官方下载页面（https://dl.min.io/server/minio/release/），选择Ubuntu对应的linux-amd64架构版本（如minio.RELEASE.2025-XX-XXTXX-XXXXZ），使用wget下载：
  wget https://dl.min.io/server/minio/release/linux-amd64/minio.RELEASE.2025-XX-XXTXX-XXXXZ -O minio
  （将2025-XX-XXTXX-XXXXZ替换为最新版本号）。

4. 替换旧版本文件

• APT升级：APT会自动替换旧版本文件，无需手动操作。
• 手动升级：
  ① 删除旧版本MinIO二进制文件（默认路径为/usr/local/bin/minio或/opt/minio）：
  sudo rm -f /usr/local/bin/minio
  ② 将下载的新版本二进制文件复制到目标路径并赋予执行权限：
  sudo mv minio /usr/local/bin/ && sudo chmod +x /usr/local/bin/minio
  ③ 若修改过配置文件（如/etc/default/minio）或数据目录（如/data），需确认新版本配置项无重大变更（参考官方升级指南），必要时备份并替换旧配置。

5. 启动MinIO服务

• APT升级：
  sudo systemctl start minio
• 手动升级：
  若通过二进制文件手动安装，执行以下命令启动（替换/data为实际数据目录）：
  sudo minio server /data
• Docker升级：
  若使用Docker，需删除旧容器（保留数据卷）并启动新容器：
  docker rm -f <minio_container_name_or_id>
docker run -d --name minio -p 9000:9000 -p 9090:9090 -v /mnt/data:/data -e "MINIO_ROOT_USER=<your_access_key>" -e "MINIO_ROOT_PASSWORD=<your_secret_key>" minio/minio server /data --console-address ":9090"
  （替换<your_access_key>、<your_secret_key>为实际账号密码，/mnt/data为数据卷路径）。

6. 验证升级结果

• 检查服务状态：
  sudo systemctl status minio（应显示“active (running)”）
• 查看版本信息：
  ① 通过命令行：
  minio version（输出应包含新版本号）
  ② 通过MinIO控制台：
  访问http://<server_ip>:9090（控制台端口可能因配置不同而变化），使用升级前的账号密码登录，查看“关于”页面的版本信息。