共用方式為

VMware 上 Azure Arc 所啟用之 AKS 中問題的疑難解答指南

  • 發行項

適用於：Azure Arc on VMware 啟用的 AKS （預覽）

本文概述在 VMware 預覽版上部署 Azure Arc 啟用的 AKS 時，可能發生之已知問題和錯誤的疑難解答步驟。 您也可以 在這裡 檢閱已知問題，或遵循 疑難解答概觀 來回報錯誤或提供產品意見反應。

此頁面會持續更新，因此請回到這裡以取得新資訊。 當我們識別需要因應措施的嚴重問題時，我們會加以新增。 在 VMware 預覽版上部署 AKS Arc 之前，請先仔細檢閱此資訊。

Arc 資源網橋

Azure Arc 資源網橋問題

如需 Azure Arc 資源網橋問題，請參閱 這裡的疑難解答指南。

從 Arc Resource Bridge 的失敗部署復原

請參閱這裡的疑難解答指南。

vCenter 連線至 Azure

如果出現錯誤訊息，指出「目前無法使用與此 vCenter 相關聯的資源網橋資源網 <橋名稱> 。 因此，在此 vCenter 上執行的作業可能會失敗，“它表示用來連接 vCenter 的資源網橋已關閉或刪除。

若要解決此問題，請執行下列步驟：

  • 如果已刪除 Arc 資源網橋，請再次部署它。
  • 如果 Arc 資源網橋已關閉（離線），請執行執行災害復原作業 - Azure Arc 中列出的災害復原步驟。

收集記錄

如果您遇到問題，您可以與支援工程師共享記錄檔和 CLI 版本，以供偵錯之用。

Arc Resource Bridge 部署之前的問題

在 c：\programdata\kva\kva.log 從系統擷取kva.log檔案，以取得詳細資訊。

Arc Resource Bridge 部署期間的問題

若要收集記錄，請從您先前用來嘗試部署Arc資源網橋的電腦執行下列命令。 從 CLI 1.0.0 版開始，您必須先執行 命令 az arcappliance get-credentials。 這可確保記錄收集的所有必要認證都會提取到機器上。 如需此命令的詳細資訊，請參閱 CLI 檔案：

az arcappliance get-credentials –name <name of Arc Resource Bridge> --resource-group <name of resource group>

執行az arcappliance get-credentials命令之後，您可以使用 命令繼續進行記錄收集az arcappliance logs vmware：

az arcappliance logs vmware --ip <Arc Resource Bridge VM control plane IP endpoint> --address <vCenter FQDN/IP address, same one used when creating config files> --username <vcenter username> --password <vcenter password>

如果您尚未建立設備 VM， az arcappliance logs vmware 命令就沒有用處，而且不會產生記錄密鑰檔案。

Arc 資源網橋啟動並執行時的問題

若要收集記錄，請從您用來部署 Arc Resource Bridge 的相同機器執行 az arcappliance logs vmware 命令 ：

  • 如果您的設備具有 kubeconfig，且設備 VM 正在與可連線的 API 伺服器一起執行，下列命令會從設備收集記錄，並輸出目前工作目錄中的.zip檔案：

    az arcappliance logs vmware --kubeconfig='<path to your kubeconfig>'

  • 如果您沒有 kubeconfig 或無法連線到您的 API 伺服器，下列命令會使用指定的設備 VM IP 位址收集記錄（請檢查您的虛擬化網狀架構;例如 Hyper-V 管理員，以找出設備 VM IP 位址）。 請注意，如果同時提供IP， kubeconfig 參數仍為必要參數，但可以當做空字串傳遞：

    az arcappliance logs vmware --kubeconfig='' --ip='<IP address of Arc Resource Bridge VM>'

填入值的範例

az arcappliance logs vmware --kubeconfig .\resourcebridge\kubeconfig
az arcappliance logs vmware --kubeconfig='kubeconfig'
az arcappliance logs vmware --kubeconfig='' --ip=10.0.1.166

取得 CLI 擴充功能版本

您可以執行下列命令來傳回裝置 CLI 擴充功能版本：

az extension show --name arcappliance -o table

您必須在實體叢集中的所有節點上安裝最新版本的 Az CLI 。

  • 執行 az -v以確認您有 Az CLI。
  • 執行 az upgrade升級至最新版本。

錯誤訊息和疑難解答步驟

本節提供常見錯誤訊息及其疑難解答步驟的清單。

錯誤：“AlreadyDeployedError”

  • 根本原因：之所以發生此錯誤，是因為環境尚未從先前的部署清除，然後再嘗試再次部署。
  • 解決方案：若要解決此問題，請卸載Arc Resource Bridge，然後再嘗試部署一次。

錯誤：x509：憑證已過期或尚未有效：目前時間1 是在 time2 <>之前<。> 檢查失敗

  • 根本原因：當憑證因用戶端計算機與 VM（或 ESXi 伺服器）之間的時間不符而過期時，就會發生此錯誤。 其中一個未啟用NTP。
  • 解決方法：
    1. 檢查 VM 上的時間是否符合您用於 ARB 部署之電腦上的時間。
    2. 將ESXi伺服器連線到NTP伺服器，以同步處理其時間並解決問題。

錯誤：『az』 一詞無法辨識為 Cmdlet、函式、腳本檔案或可操作程序的名稱。 檢查名稱的拼字，或是否包含路徑，請確認路徑正確無誤，然後再試一次

  • 根本原因：無法辨識 Az CLI，因為先前的 PowerShell 視窗已關閉，且未與 Azure CLI 的安裝同步。
  • 解決方法：
    1. 開啟新的 PowerShell 視窗，並流覽至您儲存 Arc 資源網橋上線腳本的資料夾。
    2. 執行 .temp\.env\Scripts\Activate.ps1 以安裝 Python venv。

下一步