從 AKS 叢集中的 Windows 節點擷取 Windows 容器傾印檔案

如果Microsoft Azure Kubernetes Service （AKS） 叢集上的 Windows 容器失敗，您可能必須檢查 Windows 容器傾印檔案，以調查根本原因。 本文提供從 AKS 叢集中 Windows 節點擷取 Windows 容器傾印檔案的步驟。 它也包含將傾印檔案下載到本機計算機的指示，以進一步分析。

必要條件

• AKS 叢集。 如果您沒有 AKS 叢集，請使用 Azure CLI 或透過 Azure 入口網站 建立一個叢集。

• 在 之後 3/13/2024 建立的 Windows 代理程式集區，或升級至 AKS Windows 映射版本 20240316 或更新版本的節點映像。 或者，確認 WindowsCSEScriptsPackage 版本為 v0.0.39 或更新版本，其可位於 C:\AzureData\CustomDataSetupScript.log Windows 節點上。

步驟 1：將註釋元數據新增至您的部署

在容器中掛接主資料夾，並新增註釋元數據，以要求 Windows 容器將傾印檔案儲存在指定的資料夾中：

metadata:
  ...
  annotations:
    "io.microsoft.container.processdumplocation": "C:\\CrashDumps\\{container_id}"
    "io.microsoft.wcow.processdumptype": "mini"
    "io.microsoft.wcow.processdumpcount": "10"
spec:
  ...
  containers:
  - name: containername
    image: ...
    ...
    volumeMounts:
      - mountPath: C:\CrashDumps
        name: local-dumps
  volumes:
  - name: local-dumps
    hostPath:
      path: C:\k\containerdumps
      type: DirectoryOrCreate

步驟 2：重現問題

重新部署您的部署，並等候 Windows 容器失敗。 您可以使用 kubectl describe pod -n [POD-NAMESPACE] [POD-NAME] 來了解裝載 Pod 的 AKS Windows 節點。

步驟 3：連線到 Windows 節點

建立與 AKS 叢集節點的連線。 您可以使用遠端桌面通訊協定 （RDP） 連線中的安全殼層 （SSH） 金鑰或 Windows 系統管理員密碼進行驗證。 這兩種方法都需要您建立中繼連線。 這是因為您目前無法直接連線到 AKS Windows 節點。 無論您是透過 SSH 或 RDP 連線到節點，都必須指定 AKS 節點的使用者名稱。 根據預設，此使用者名稱稱為 azureuser。

SSH

如果您有 SSH 金鑰， 請建立 Windows 節點的 SSH 連線。 SSH 金鑰不會儲存在您的 AKS 節點上。 SSH 金鑰會還原為叢集上最初在下列任何動作期間所安裝的內容：

• 重新啟動
• 版本升級
• 節點映像升級

RDP

如果您沒有 SSH 金鑰，請使用 RDP 和 Windows 系統管理員密碼進行連線。 如果您沒有叢集的這個密碼，請執行 az aks update 命令，以在 Azure CLI 中重設密碼。 指定資源群組、叢集名稱和新密碼。 命令會在完成之後顯示叢集詳細資料：

az aks update \
    --resource-group <myResourceGroup> \
    --name <myAKSCluster> \
    --windows-admin-password "<myNewPassword>"

使用您的 Windows 系統管理員密碼，使用 RDP 連線到節點。 此動作會要求您部署連線到叢集所連線之相同子網的「跳躍」虛擬機（VM）。

將數據磁碟驅動器重新導向至 RDP 連線

若要將擷取檔案傳輸至您的電腦，您必須將硬碟從您的電腦重新導向到建立的 VM 和 AKS Windows 節點的 RDP 連線。 此重新導向可讓您將稍後產生的擷取檔案複製到您的電腦。

1. 在您的電腦上，選取 [開始]，然後搜尋並選取 [ 遠端桌面連線]。

2. 在 [ 遠端桌面連線 ] 對話框中，選取 [ 顯示選項]。

   

3. 在 [ 本機資源] 索引 標籤中，選取 [更多]。

   

4. 在 [新的 遠端桌面連線 ] 對話框中，選取 [ 磁碟驅動器 ] 以展開您計算機上的磁碟驅動器列表，然後選取您要重新導向的磁碟驅動器。

   

5. 聯機到您稍早設定的 Windows VM。

步驟 4：在本機傳輸傾印檔案

SSH

容器失敗之後，請識別協助程式Pod，讓您可以在本機複製傾印檔案。 開啟第二個主控台，然後執行 kubectl get pods 命令以取得 Pod 清單，如下所示：

kubectl get pods
NAME                                                    READY   STATUS    RESTARTS   AGE
azure-vote-back-6c4dd64bdf-m4nk7                        1/1     Running   2          3d21h
azure-vote-front-85b4df594d-jhpzw                       1/1     Running   2          3d21h
node-debugger-aks-nodepool1-38878740-vmss000000-6ztp6   1/1     Running   0          3m58s

協助程式 Pod 的前置詞 node-debugger-aks為 ，如第三個數據列所示。 取代 Pod 名稱，然後執行下列安全複製 （scp） 命令來擷取容器失敗時所儲存的傾印檔案 （.dmp：

scp -o 'ProxyCommand ssh -p 2022 -W %h:%p azureuser@127.0.0.1' azureuser@10.240.0.97:/C:/k/containerdumps/{container_id}/{application}.dmp .

您可以在連線到 Windows 節點之後，列出 C:\k\containerdumps 資料夾以尋找傾印檔案的完整路徑。

RDP

若要將 TCP 傾印檔案從 AKS Windows 節點傳輸到跳躍 VM，請遵循下列步驟：

1. 聯機到 AKS Windows 節點。

2. 執行下列 net use 命令，將跳躍 VM 的共用資源對應至名為 Z 的磁碟驅動器。如果共用資源不是磁碟驅動器 C 以外的資源，請調整 命令。

   C:\Users\bookbinder>net use z: \\tsclient\c
   The command completed successfully.
   

3. 若要將傾印檔案複製到您的跳躍 VM，請執行下列複製命令：

   C:\Users\azureuser>copy C:\k\containerdumps\*\*.dmp z:\
   

4. 結束從跳躍 VM 到 AKS Windows 節點的連線。 傾印檔案現在位於跳躍 VM 的磁碟驅動器 C 上。

若要將傾印檔案從跳躍 VM 複製到您的電腦，請遵循下列步驟：

1. 在跳躍 VM 的 檔案總管 中，移至磁碟驅動器 C 的根目錄。
2. 選取 *.dmp 檔案。
3. 將.dmp檔案拖曳至 myComputerName> 上<名為 C 的連接。

傾印檔案現在位於您電腦上的磁碟驅動器 C 根目錄中。

與我們連絡，以取得說明

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