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

  • 發行項

適用於：Azure Arc 在 VMware 上啟用的 AKS (預覽版)

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

此頁面會持續更新，因此請參閱這裡以取得新資訊。 當我們找出需要因應措施的重要問題時，我們會新增它們。 請先仔細檢閱此資訊，再部署 VMware 預覽版上的 AKS Arc。

Arc 資源網橋

Azure Arc 資源網橋問題

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

從 Arc 資源網橋的失敗部署中復原

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

vCenter 與 Azure 的連線

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

若要解決此問題，請依照下列步驟執行︰

收集記錄

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

Arc Resource Bridge 部署之前的問題

從系統擷取 kva.log 檔案，網址為 c：\programdata\kva\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 資源網橋的相同機器執行 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 位址) 。 請注意， kubeconfig 如果也提供IP，仍需要 參數，但可以當做空字串傳遞：

    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 CLI az -v。
  • 執行 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。

下一步