如何在Ubuntu上升級MinIO存儲

如何在Ubuntu上升級MinIO存儲

一、升級前的準備工作

1. 備份數據：升級前務必備份所有重要數據（如/data/minio目錄下的所有文件），防止升級過程中出現意外導致數據丟失。
2. 檢查兼容性：閱讀新版本的發布說明（Release Notes），確認是否有不兼容的配置變更（如API接口調整、配置文件格式修改）。
3. 準備工具：下載MinIO命令行工具mc（用于數據同步），可通過wget https://dl.min.io/client/mc/release/linux-amd64/mc獲取，賦予執行權限后移動到系統PATH目錄。

二、卸載舊版本MinIO（可選但推薦）

若舊版本是通過二進制文件直接安裝的，可執行以下命令卸載：

sudo rm -rf /usr/local/bin/minio       # 刪除MinIO二進制文件
sudo rm -rf /etc/systemd/system/minio.service  # 刪除systemd服務文件
sudo rm -rf /etc/default/minio         # 刪除環境變量配置文件

若舊版本是通過包管理器（如APT）安裝的，可使用sudo apt remove minio卸載。

三、下載并安裝新版本MinIO

1. 下載新版本：通過MinIO官方網站下載最新版本的Linux amd64二進制文件（如minio.RELEASE.2025-XX-XXT00-00-00Z），使用wget命令示例：

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

2. 賦予執行權限并移動：

   chmod +x minio                         # 賦予可執行權限
   sudo mv minio /usr/local/bin/          # 移動到系統PATH目錄
   

3. 配置環境變量（可選）：若需自定義管理員賬號或存儲路徑，可編輯/etc/default/minio文件，設置以下參數：

   minio_root_user=admin                  # 管理員賬號（默認admin）
   minio_root_password=your_strong_password  # 管理員密碼（至少8位）
   minio_volumes=/data                     # 存儲路徑（需與舊版本一致）
   minio_opts="--console-address :9001"    # 控制臺端口（默認9001）
   

四、數據同步（關鍵步驟：確保數據兼容）

由于新版本MinIO可能不兼容舊版本數據格式，需通過mc工具將舊數據同步到新目錄：

1. 配置mc別名：

   mc alias set minio-old http://127.0.0.1:9000 admin old_password  # 舊版本MinIO（原運行端口9000）
   mc alias set minio-new http://127.0.0.1:9001 admin new_password  # 新版本MinIO（臨時運行端口9001）
   

2. 啟動舊版本MinIO：確保舊版本正常運行，監聽原端口（如9000）：

   ./minio.RELEASE.2021-03-26T00-00-41Z server /data/minioData --console-address ":9000"
   

3. 同步數據到新目錄：使用mc mirror命令將舊數據同步到新目錄（如/data/minioData_v2）：

   mkdir -p /data/minioData_v2            # 新版本數據目錄
   mc mirror --overwrite --remove minio-old/minio minio-new/minio  # 全量同步（--overwrite覆蓋已有對象，--remove刪除目標多余對象）
   

4. 驗證數據一致性：通過mc ls命令檢查新舊目錄中的存儲桶和對象是否一致。

五、啟動新版本MinIO并驗證

1. 啟動新版本服務：使用新版本MinIO啟動新數據目錄：

   minio server /data/minioData_v2 --console-address ":9001"
   

2. 檢查服務狀態：通過systemctl命令確認服務是否正常運行：

   sudo systemctl status minio              # 查看服務狀態
   journalctl -u minio -f                   # 實時查看日志（排查錯誤）
   

3. 訪問控制臺：在瀏覽器中訪問http://your_server_ip:9001，使用配置的管理員賬號（minio_root_user）和密碼（minio_root_password）登錄，驗證存儲桶、對象是否正常顯示。

六、切換生產流量（可選：負載均衡場景）

若使用Nginx或負載均衡器（LB），可將流量從舊版本節點切換到新版本節點：

1. 更新LB配置：將后端服務器指向新版本MinIO的IP和端口（如9000）。
2. 停止舊版本服務：確認新版本運行穩定后，停止舊版本MinIO進程。

注意事項

• 生產環境建議：先在測試環境驗證升級流程，確保數據同步和功能正常。
• 回滾方案：保留舊版本MinIO二進制文件和數據目錄（如/data/minioData），若新版本出現問題，可快速回滾到舊版本。
• 監控日志：升級后密切關注MinIO日志（/var/log/minio.log），及時處理異常（如權限問題、存儲路徑錯誤）。