共用方式為

AKS 叢集啟動問題的基本疑難排解

  • 發行項

本文概述如果您無法成功啟動Microsoft Azure Kubernetes Service （AKS） 叢集的基本疑難解答方法。

必要條件

從 Azure CLI 檢視錯誤

當您使用 Azure CLI 啟動叢集時，如果作業失敗，錯誤會記錄為輸出。 以下是命令、使用者輸入和作業輸出在控制台中 Bash 顯示的方式：

$ az aks start --resource-group myResourceGroup --name MyManagedCluster

(VMExtensionProvisioningError) Unable to establish outbound connection from agents, please see https://learn.microsoft.com/en-us/troubleshoot/azure/azure-kubernetes/error-code-outboundconnfailvmextensionerror and https://aka.ms/aks-required-ports-and-addresses for more information.  
Details: instance 3 has extension error details : {vmssCSE error messages : {vmssCSE exit status=50, output=AGE_SHA=sha-16fd35

這些錯誤通常包含叢集啟動作業中發生錯誤的詳細描述，並提供包含更多詳細數據的文章連結。 此外，您可以根據 Azure CLI 作業產生的錯誤，使用我們的疑難解答文章作為參考。

在 Azure 入口網站 中檢視錯誤詳細數據

若要檢視 Azure 入口網站 中錯誤的詳細數據，請檢查 Azure 活動記錄檔。 若要在 Azure 入口網站 中尋找活動記錄清單，請在 [活動記錄] 上搜尋。 或者，選取 [通知] （鈴鐺圖示），然後在活動記錄中選取 [更多事件]。

[活動記錄] 頁面上的記錄清單包含一個行專案，其中作業名稱數據行值名為 [啟動受控叢集]。 由數據行值起始的對應事件會設定為公司或學校帳戶的名稱。 如果作業成功，[狀態] 資料行值會顯示 [已接受]。

AKS 叢集活動記錄刀鋒視窗的螢幕快照，其中顯示失敗的啟動作業。

如果發生錯誤，該怎麼辦？ 在此情況下，[啟動受控叢集作業狀態] 字段會顯示 [失敗]。 不同於建立叢集元件的作業，您必須在這裡展開失敗的作業專案，以檢閱子作業專案。 典型的子作業名稱是原則動作，例如 'audit' Policy action 和 'auditIfNotExists' Policy action。 某些子作業會繼續顯示其成功。

若要進一步調查，您可以選取其中一個失敗的子作業。 側邊窗格隨即開啟，讓您可以檢閱子作業的詳細資訊。 您可以針對 [摘要]、[JSON] 和 [變更歷程記錄] 等字段的值進行疑難解答。 JSON 欄位包含 JSON 格式錯誤輸出文字，而且通常會提供最有使用的資訊。

AKS 叢集活動記錄的子作業側窗格螢幕快照，其中顯示啟動作業失敗的原因。

檢視叢集深入解析

您也可以產生叢集深入解析，以協助您透過 Azure 入口網站 中的 [診斷和解決問題] 刀鋒視窗進行疑難解答。 若要存取這項功能，請遵循下列步驟：

  1. 在 Azure 入口網站 中，搜尋並選取 [Kubernetes 服務]。

  2. 選取 AKS 叢集的名稱。

  3. 在 AKS 叢集頁面的瀏覽窗格中，選取 [ 診斷並解決問題]。

  4. 在 [ 診斷和解決問題] 頁面上，選取 [ 叢集深入解析] 連結。 叢集深入解析工具會分析您的叢集，然後在 [叢集深入解析] 頁面的 [觀察與解決方案] 區段中提供其結果清單。

  5. 選取其中一個結果，以檢視問題及其可能解決方案的詳細資訊。

檢視 Azure 入口網站 中的資源

在 Azure 入口網站 中，您可能會想要檢視叢集建置時所建立的資源。 一般而言，這些資源位於以MC_開頭的資源群組中。 受控叢集資源群組的名稱，例如 MC_MyResourceGroup_MyManagedCluster_location-code>。< 不過，如果您使用自定義受控叢集資源群組來建置叢集，則名稱可能會不同。

若要尋找資源群組，請在 Azure 入口網站 中搜尋並選取 [資源群組]，然後選取叢集建立所在的資源群組。 資源清單會顯示在 資源群組的 [概觀 ] 頁面上。

警告

建議您不要修改MC_資源群組中的資源。 此動作可能會對您的 AKS 叢集造成不必要的影響。

若要檢閱虛擬機擴展集的狀態，您可以在資源群組的資源清單中選取擴展集名稱。 其名稱可能與 aks-nodepool1-12345678-vms 和虛擬機擴展集的 Type 值類似。 擴展集的狀態會出現在節點集區 [概觀] 頁面頂端，而 [基本資訊] 標題中會顯示更多詳細數據。 如果部署失敗，則顯示的狀態為 [失敗]。

針對所有資源，您可以檢閱詳細數據，以進一步瞭解部署失敗的原因。 針對擴展集，您可以選取 [失敗 狀態] 文字，以檢視失敗的詳細數據。 詳細數據列包含 [狀態]、 [層級] 和 [程序代碼] 資料行。 下列範例顯示數據行值的數據列。

資料行 範例值
狀態 布建失敗
層級 錯誤
代碼 ProvisioningState/failed/VMExtensionProvisioningError

選取資料列以查看 [ 訊息 ] 欄位。 這包含有關該失敗的詳細資訊。 例如， 範例數據列的 [訊息 ] 字段會以下列文字開頭：

VM 在處理擴充功能 'vmssCSE' 時回報失敗。 錯誤訊息：「啟用失敗：無法執行命令：結束狀態為 50 [stdout] [stderr] [stderr] 0 0 0 --：使用這項資訊，您可以得出結論，擴展集中的 VM 失敗併產生結束狀態 50。

使用 Kubectl 命令

如需協助針對叢集上的錯誤進行疑難解答的另一個選項，請輸入 kubectl 命令以取得叢集中所部署資源的詳細數據。 若要使用 kubectl，請先登入您的 AKS 叢集：

az aks get-credentials --resource-group MyResourceGroup --name MyManagedCluster

視失敗類型和發生失敗類型而定，您可能無法登入叢集以取得更多詳細數據。 但一般而言，如果您的叢集已建立並顯示在 Azure 入口網站 中，您應該能夠登入並執行 kubectl 命令。

檢視叢集節點 （kubectl get nodes）

若要取得更多詳細數據來判斷節點的狀態，請輸入 kubectl get nodes 命令來檢視叢集節點。 在此範例中，叢集中沒有報告任何節點：

$ kubectl get nodes

No resources found

在系統命名空間中檢視 Pod （kubectl get pods）

在 kube-system 命名空間中檢視 Pod 也是針對問題進行疑難解答的好方法。 此方法可讓您檢視 Kubernetes 系統 Pod 的狀態。 在此範例中，我們會輸入 kubectl get pods 命令：

$ kubectl get pods -n kube-system
NAME                                  READY   STATUS    RESTARTS   AGE
coredns-845757d86-7xjqb               0/1     Pending   0          78m
coredns-autoscaler-5f85dc856b-mxkrj   0/1     Pending   0          77m
konnectivity-agent-67f7f5554f-nsw2g   0/1     Pending   0          77m
konnectivity-agent-8686cb54fd-xlsgk   0/1     Pending   0          65m
metrics-server-6bc97b47f7-dfhbr       0/1     Pending   0          77m

描述 Pod 的狀態（kubectl 描述 Pod）

藉由描述 Pod 的狀態，您可以檢視組態詳細數據和 Pod 上發生的任何事件。 執行 kubectl describe pod 命令：

$ kubectl describe pod coredns-845757d86-7xjqb -n kube-system
Name:                 coredns-845757d86-7xjqb
Namespace:            kube-system
Priority:             2000001000
Priority Class Name:  system-node-critical
Node:                 <none>
Labels:               k8s-app=kube-dns
                      kubernetes.io/cluster-service=true
                      pod-template-hash=845757d86
                      version=v20
...
Events:
  Type     Reason            Age                 From               Message
  ----     ------            ----                ----               -------
  Warning  FailedScheduling  24m (x1 over 25m)   default-scheduler  no nodes available to schedule pods
  Warning  FailedScheduling  29m (x57 over 84m)  default-scheduler  no nodes available to schedule pods

在命令輸出中，您可以看到 Pod 無法部署到節點，因為沒有可用的節點。

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。 您也可以向 Azure 意見反應社群提交產品意見反應。