文件

疑難排解

概觀

MinIO 用戶有兩種支援選項。

  1. 來自公開 Slack 頻道的社群支援。

    社群支援僅提供盡力而為的服務,沒有SLASLO

  2. MinIO 訂閱網路 SUBNET 根據訂閱級別提供 48 小時或 1 小時的 SLA

    如需目前的授權級別和定價,請參閱 MinIO SUBNET 頁面。

SUBNET

SUBNET 透過 MinIO 建置的入口網站提供 24/7/365 直接對工程師的支援,該入口網站結合了常用通訊工具的聊天功能與標準支援平台的功能。

SUBNET 的功能包括

  • 安全性與架構檢閱(取決於SLA

  • 存取 Panic Button,針對嚴重問題提供立即回應(取決於SLA

  • 用於交換日誌和軟體二進位的安全通訊管道

  • 您團隊的無限座位

  • 無限問題

如需更多資訊,請參閱 MinIO SUBNET 頁面的詳細資訊。

使用 SUBNET 註冊您的 MinIO 部署

RELEASE.2023-04-07T05-28-58Z 開始,在向 SUBNET 註冊後,主控台會提示您重新啟動部署。您可以透過在頂部橫幅中選取重新啟動,或使用 mc admin service restart,透過主控台重新啟動。

您可以從 MinIO 主控台註冊 SUBNET。

  1. 前往您的 MinIO 叢集 URL,然後登入

  2. 選取支援選項

  3. 選取註冊

  4. 選取使用註冊方法的索引標籤

    • 認證索引標籤,以使用您的 MinIO SUBNET 使用者名稱和密碼

    • API 金鑰索引標籤,以輸入您已有的 API 金鑰,或直接從 SUBNET 取得一個。

    • Airgap 頁籤,用於註冊無法直接連線至網際網路和/或 SUBNET 的部署的權杖和說明

請按照以下步驟註冊無法直接存取網際網路的 MinIO 部署。例如,存在於氣隙環境、防火牆後方,或任何其他無法直接存取網際網路的環境中的部署。

從主控台

  1. 前往您的 MinIO 叢集 URL,然後登入

  2. 選取 Support 頁籤,然後選取 Health

  3. 選取 Register your Cluster

  4. 選取 Airgap 頁籤

  5. 複製提供的連結,其中包含部署的權杖值

  6. 將連結貼到可存取網際網路的裝置上的網頁瀏覽器中

  7. 成功註冊後,複製提供的 API 金鑰

  8. 在 MinIO 主控台中,選取 API Key 頁籤

  9. 將從 SUBNET 複製的 API 金鑰貼到 API Key 欄位中,然後選取 Register

您可以從命令列註冊 SUBNET。

重要事項

mc license register 需要 MinIO Client 版本 RELEASE.2023-11-20T16-30-59Z 或更高版本。雖然不是硬性規定,最佳實務是讓 MinIO Client 版本 與 MinIO Server 版本保持一致。

如果您無法將 MinIO Client 升級到所需版本或更高版本,請改用主控台註冊。

請參閱 mc license register 以取得相關說明。

對於沒有直接網際網路存取的叢集,請參閱 airgap 範例 中的說明,位於 mc license register 文件中。

氣隙註冊流程適用於 MinIO Client 版本 RELEASE.2022-07-29T19-17-16Z 或更高版本。較舊版本的 MinIO Client 無法註冊氣隙部署。

下載授權檔案

在可存取網際網路的電腦上從 SUBNET 下載授權檔案。

  1. 登入 MinIO SUBNET

  2. 前往 Deployments 頁籤

  3. 選取頁面右側帳戶統計資訊方塊頂部附近的 License 按鈕,以顯示 Account License

  4. 選取 Download

SUBNET 問題

使用 SUBNET 問題與 MinIO 工程部門聯繫以獲得支援。

  1. 登入 https://subnet.min.io

  2. 選取 Issues 區段

使用搜尋列尋找現有的問題或新增問題。

MinIO SUBNET with the Issues section displaying a list of an organization's issues

從清單中選取現有的問題以展開對話或新增回覆。

A example MinIO SUBNET issue conversation

在 SUBNET 中檢閱健康資料

SUBNET 從 Deployments 區段提供組織註冊之叢集的健康資料。

此檢視畫面會顯示組織 MinIO 叢集的總大小,並提供每個叢集的詳細資訊。

MinIO SUBNET displaying the deployments overview

每個組織的叢集都會顯示在摘要資料下方。選取部署列以檢視其他健康詳細資訊。

部署健康狀況

部署的詳細資訊包含部署組態的摘要,以及執行和失敗的檢查次數。您可以選取 Upload 以新增從 mc support diag 命令或 MinIO 主控台的 Support > Health 頁面取得的診斷健康資料。

您也可以使用 Call Home 功能自動執行並上傳診斷健康報告。

如果您需要 MinIO 工程部門的支援,您可以為部署建立 New Issue

MinIO SUBNET displaying health summary information for a myminio deployment

SUBNET 會顯示 CPU、磁碟機、記憶體、網路和安全性等資料點的健康檢查。

失敗的檢查會先顯示。有警告的檢查會在失敗的檢查之後顯示。通過的檢查會最後顯示。

選取任何失敗或有警告的檢查,以顯示 JSON 輸出,取得更多詳細資訊。您可以垂直捲動所選檢查的輸出。

MinIO SUBNET's health report for a deployment showing a failed Health Report with details expanded

記錄

使用 mc admin logs 命令從命令列顯示記錄。此命令支援類型和數量篩選器,以進一步限制記錄輸出。

您可以選擇使用 Call Home,開始自動將即時錯誤記錄上傳到 SUBNET 以進行分析。

Call Home

新功能版本 minio:RELEASE.2022-11-17T23-20-09Z 和 mc RELEASE.2022-12-02T23-48-47Z

MinIO 的選擇加入 Call Home 服務會自動收集診斷資料或錯誤記錄,並上傳至 SUBNET。Call Home 要求叢集同時具有有效的 SUBNET 註冊,以及可靠的網際網路存取。

重要事項

Call Home 不適用於氣隙部署。

啟用後,Call Home 可以上傳以下一項或兩者

  • 即時錯誤記錄

  • 每 24 小時一次的新診斷報告

上傳後,您可以如上所述透過 SUBNET 檢視診斷報告結果或記錄,但無需自行手動上傳資料。讓這些記錄自動在 SUBNET 中可用,簡化了叢集健康狀況和功能的檢視。如果您提交支援問題以尋求 MinIO 工程師的協助,工程師可以立即存取您已上傳的錯誤和/或記錄。

診斷報告

診斷報告上傳會在您啟用 Call Home 時起每 24 小時發生一次。如果您在啟用 Call Home 後重新啟動部署中的所有節點,則上傳會在部署重新啟動後每 24 小時發生一次。

重要事項

診斷報告不會收集或上傳任何個人識別資訊。

此報告包含以下資訊:

  • 可能影響效能的系統設定、服務和組態

  • TLS 憑證狀態、有效性、到期日和演算法類型資訊

  • CPU 核心計數和資訊

  • 磁碟機計數、狀態、大小和可用空間

  • 叢集大小伺服器計數

  • 檔案系統類型

  • 記憶體大小和類型

  • 作業系統對稱性和 Linux 核心版本

  • 節點間延遲

  • NTP 同步

  • 可用資源

  • MinIO 版本

錯誤記錄

當 MinIO Server 遇到錯誤時,會將其寫入記錄。這些記錄可以即時上傳到 SUBNET,您或 MinIO 工程師可以在其中檢視錯誤。

啟用或停用 Call Home

Call Home 預設為停用。您可以使用 MinIO Client 的 enabledisable 命令,隨時 mc support callhome 來啟用和停用 Call Home 功能。此命令及其子命令可讓您僅針對診斷、僅針對錯誤記錄或兩者啟用 Call Home 上傳。如需更多詳細資訊,請參閱命令的文件。

使用 mc support callhome status 以檢查上傳的狀態。

將資料上傳到 SUBNET

如果您已使用 SUBNET 註冊叢集,效能和檢查檔案可以自動上傳到 SUBNET。

對於具有氣隙、防火牆或以其他方式直接從 SUBNET 封鎖的叢集,您可以在登入後手動將檔案上傳到 SUBNET。

  1. 從命令列使用 mc support diagmc support inspect 指令,產生要上傳的檔案。

  2. 登入 SUBNET

  3. 選取 部署 (Deployments)

  4. 選取 診斷 (Diagnostics)

  5. 拖放 .gzip 檔案,或瀏覽至檔案位置以上傳

加密資料

來自 控制台 中「檢查 (Inspect)」工具或 mc support inspect 命令的資料可以加密。有關加密或解密此類檔案的更多詳細資訊,請參閱加密檔案

升級與版本支援

MinIO 會定期發布更新,以引入新功能、提升效能、解決安全性問題或修正錯誤。這些發布可能會非常頻繁,並且會因產品而異。

在生產環境部署上進行升級之前,務必先在開發環境中測試軟體版本。

有效支援期間

版本支援因部署所使用的授權而異。

授權

支援期限

AGPLv3

最新版本

MinIO Enterprise Lite

任何版本的 1 年長期支援

MinIO Enterprise Plus

任何版本的 5 年長期支援,SUBNET 支援升級指南和建議

版本對齊

由於各種 MinIO 產品會按照自己的時程分別發布,我們建議遵循以下版本對齊做法

MinIO

更新至最新版本或不超過六個月的版本。

MinIO 用戶端

在 MinIO 版本發布後一到兩週內,更新至緊隨其後的 mc 版本。

MinIO Operator

使用的 MinIO 版本不得早於 Operator 版本發布時的最新版本。發布時的最新 MinIO 版本可以在 Operator 版本的範例租戶 kustomization yaml 檔案中的 quay.io 連結中找到。

  • 4.5.5:MinIO RELEASE.2022-12-07T00-56-37Z 或更新版本

  • 4.5.6:MinIO RELEASE.2023-01-02T09-40-09Z 或更新版本

  • 4.5.7:MinIO RELEASE.2023-01-12T02-06-16Z 或更新版本

  • 4.5.8:MinIO RELEASE.2023-01-12T02-06-16Z 或更新版本

在建立新的租戶時,Operator 會使用最新的可用 MinIO 版本映像或您在建立租戶時指定的映像。

升級 Operator不會 自動升級現有租戶。請分別升級現有租戶的 MinIO 版本。