針對 Azure Arc VM 管理進行疑難排解

適用于:Azure Stack HCI 版本 22H2 和 21H2

本文提供如何針對使用 Azure Arc 虛擬機器 (VM) 時可能會遇到的問題進行偵錯的指引。 其也會描述目前存在的限制和已知問題。

重要

這項功能目前為「預覽」狀態。 請參閱 Microsoft Azure 預覽版增補使用規定,以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版,或尚未正式發行的版本) 的法律條款。

疑難排解和偵錯

如需任何錯誤和補救步驟,請參閱支援主題。 如果未提到錯誤狀況或您需要其他協助,請連絡 Microsoft 支援服務。

請先收集診斷資訊,再聯絡 Microsoft 支援服務,因為其可能會要求您提供此資訊。

針對 Arc VM 管理的相關問題,您可以使用下列命令,從叢集產生記錄:

注意

確定您具備記錄集合的最新 PowerShell 模組。

#Update the PowerShell module
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense
$csv_path="<input-from-admin>"
$VMIP="<input-from-admin>"
Get-ArcHCILogs -workDirectory $csv_path\ResourceBridge -kvaTokenPath $csv_path\ResourceBridge\kvatoken.tok -ip $VMIP

$csv_path 是用來建立 Arc Resource Bridge 所提供的叢集共用磁片區的完整路徑。

$VMIP 是 Arc Resource Bridge 虛擬機器的 IP 位址。

您可以選擇性地提供 -logDir 參數,以提供將儲存所產生記錄的目錄路徑。 如果您未提供路徑或參數,位置會預設為目前的工作目錄。

執行 arcappliance prepare 命令時的許可權遭拒錯誤

如果您的 PowerShell 會話在執行命令所在的 az arcapplicance prepare 資料夾中沒有寫入權限,它就會失敗,並出現下列錯誤:

錯誤:Appliance prepare command failed with error: [Errno 13] Permission denied: 'debug_infra.yaml'

以下是 PowerShell 會話沒有許可權在資料夾中寫入 C:\ClusterStorage 時的範例輸出:

反斜準備錯誤的螢幕擷取畫面。

解析度: 移至您的主目錄,然後重新執行 az arcapplicance prepare 命令。

KVA 逾時錯誤

Azure Arc 資源橋接器是 Kubernetes 管理叢集,可直接在內部部署基礎結構的 Arc 資源橋接器 VM 中部署。 嘗試部署 Azure Arc 資源橋接器時,如果網路問題不允許將 Arc 資源橋接器 VM 與主機、DNS、網路或網際網路通訊,就可能會出現「KVA 逾時錯誤」。 此錯誤通常會因為下列原因而顯示:

  • Arc Resource Bridge VM ($VMIP) 沒有 DNS 解析。
  • Arc Resource Bridge VM ($VMIP) 或$controlPlaneIP沒有網際網路存取權。
  • 主機無法連線到$controlPlaneIP或$VMIP。

若要解決此錯誤,請確定指派給 Arc 資源橋接器 VM 的所有 IP 位址都可以由 DNS 解析,並可存取網際網路,而且主機可以成功路由至 IP 位址。

限制與已知問題

  • 資源名稱對 Azure Stack HCI 叢集而言必須是唯一的,而且只包含字母、數字和連字號。

  • 透過命令列佈建的 Arc 資源橋接器必須在本機 HCI 伺服器 PowerShell 上執行。 機器若不是 Azure Stack HCI 叢集的主機,此資源橋接器無法在來自該機器的遠端 PowerShell 視窗中執行。 若要在 Azure Stack HCI 叢集的每個節點上連線,請使用以叢集網域使用者管理員身分連線的遠端桌面通訊協定 (RDP)。

  • 必須在下列部署順序中啟用相同 Azure Stack HCI 叢集上的 Azure Kubernetes 和 Arc VM:

    1. 部署 AKS 管理叢集
    2. 部署 Arc VM 的 Arc 資源橋接器

    注意

    如果已部署 Arc 資源橋接器,除非移除 Arc 資源橋接器,否則您不應該部署 AKS 管理叢集。

  • 您必須依照下列順序解除安裝這些項目:

    1. 解除安裝 Azure Arc 資源橋接器
    2. 解除安裝 AKS 管理叢集

    注意

    解除安裝 AKS 管理叢集可能會影響 Arc VM 管理功能。 您可以在清除之後部署新的 Arc 資源橋接器,但其不會記住之前建立的 VM 實體。

  • 從 Windows Admin Center、PowerShell 或其他 Hyper-V 管理工具佈建的 VM 不會顯示在 Azure 入口網站中,以進行管理。

  • 您必須只從 Azure 管理平面更新 Azure Stack HCI 上的 Arc VM。 從其他管理工具對這些 VM 進行的任何修改,都不會在 Azure 入口網站中更新。

  • Arc VM 必須和自訂位置建立在相同的 Azure 訂用帳戶中。

  • 如果 VM 是在 IT 管理員沒有至少唯讀存取角色的訂用帳戶中建立,IT 管理員無法從 Azure 入口網站中的叢集資源頁面檢視或管理這些 VM。

  • 如果伺服器代理程式的 Arc 安裝在透過 Azure 入口網站佈建的 VM 上,Azure 入口網站的 VM 會有兩個投影。

  • Azure Stack HCI 上的延展式叢集設定目前無法使用 Arc VM 管理。

  • 對於 Arc 資源橋接器和 Arc VM 管理,目前僅提供英文支援。

  • 將伺服器新增至 HCI 叢集時不會自動安裝 Arc 元件。

  • 針對 Azure 資源 (例如虛擬網路、資源庫映像、自訂位置、Arc 資源橋接器等),其命名慣例應遵循這些指導方針

後續步驟