Acquisire un file di dump del contenitore Windows da un nodo Windows in un cluster del servizio Azure Kubernetes

Se un contenitore Windows ha esito negativo in un cluster microsoft servizio Azure Kubernetes (servizio Azure Kubernetes), potrebbe essere necessario esaminare il file di dump del contenitore di Windows per analizzare la causa radice. Questo articolo illustra i passaggi per acquisire un file di dump del contenitore Windows da un nodo Windows in un cluster del servizio Azure Kubernetes. Include anche istruzioni per scaricare il file di dump nel computer locale per un'ulteriore analisi.

Prerequisiti

• Un cluster del servizio Azure Kubernetes. Se non si dispone di un cluster del servizio Azure Kubernetes, crearne uno usando l'interfaccia della riga di comando di Azure o tramite il portale di Azure.

• Pool di agenti Windows creati dopo 3/13/2024 o un'immagine del nodo aggiornata alla versione 20240316 dell'immagine windows del servizio Azure Kubernetes o a una versione successiva. In alternativa, verificare se la versione di WindowsCSEScriptsPackage è v0.0.39 o successiva, che può trovarsi nei C:\AzureData\CustomDataSetupScript.log nodi Windows.

Passaggio 1: Aggiungere metadati delle annotazioni alla distribuzione

Montare una cartella host nel contenitore e aggiungere i metadati delle annotazioni per richiedere che il contenitore di Windows archivi il file di dump in una cartella designata:

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

Passaggio 2: Riprodurre il problema

Ridistribuire la distribuzione e attendere l'esito negativo del contenitore Windows. È possibile usare kubectl describe pod -n [POD-NAMESPACE] [POD-NAME] per scoprire quale nodo windows del servizio Azure Kubernetes ospita il pod.

Passaggio 3: Connettersi al nodo Windows

Stabilire una connessione al nodo del cluster del servizio Azure Kubernetes. L'autenticazione viene eseguita usando una chiave SSH (Secure Shell) o la password di amministratore di Windows in una connessione RDP (Remote Desktop Protocol). Entrambi i metodi richiedono la creazione di una connessione intermedia. Ciò è dovuto al fatto che attualmente non è possibile connettersi direttamente al nodo Windows del servizio Azure Kubernetes. Sia che ci si connetta a un nodo tramite SSH o RDP, è necessario specificare il nome utente per i nodi del servizio Azure Kubernetes. Per impostazione predefinita, questo nome utente è azureuser.

SSH

Se si dispone di una chiave SSH, creare una connessione SSH al nodo Windows. La chiave SSH non viene mantenuta nei nodi del servizio Azure Kubernetes. La chiave SSH ripristina ciò che è stato installato inizialmente nel cluster durante una delle azioni seguenti:

• Riavvia
• Aggiornamento della versione
• Aggiornamento dell'immagine del nodo

RDP

Se non si dispone di una chiave SSH, connettersi usando RDP e la password di amministratore di Windows. Se questa password non è disponibile per il cluster, reimpostare la password nell'interfaccia della riga di comando di Azure eseguendo il comando az aks update . Specificare il gruppo di risorse, il nome del cluster e la nuova password. Il comando visualizza i dettagli del cluster al termine:

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

Usare la password di amministratore di Windows per connettersi al nodo usando RDP. Questa azione richiede la distribuzione di una macchina virtuale (VM) "jump" che si connette alla stessa subnet a cui si connette il cluster.

Reindirizzare un'unità dati alla connessione RDP

Per trasferire i file di acquisizione nel computer, è necessario reindirizzare un disco rigido dal computer sia alla macchina virtuale creata che alla connessione RDP al nodo Windows del servizio Azure Kubernetes. Questo reindirizzamento consente di copiare nel computer i file di acquisizione generati in un secondo momento.

1. Nel computer selezionare Start, quindi cercare e selezionare Connessione Desktop remoto.

2. Nella finestra di dialogo Connessione Desktop remoto selezionare Mostra opzioni.

   

3. Nella scheda Risorse locali selezionare Altro.

   

4. In una nuova finestra di dialogo Connessione Desktop remoto selezionare Unità per espandere l'elenco di unità presenti nel computer e quindi selezionare l'unità da reindirizzare.

   

5. Connettersi alla macchina virtuale Windows configurata in precedenza.

Passaggio 4: Trasferire il file di dump in locale

SSH

Dopo l'errore del contenitore, identificare il pod helper in modo che sia possibile copiare il file di dump in locale. Aprire una seconda console e quindi ottenere un elenco di pod eseguendo il kubectl get pods comando , come indicato di seguito:

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

Il pod helper ha il prefisso node-debugger-aks, come illustrato nella terza riga. Sostituire il nome del pod ed eseguire i comandi di copia sicura (scp) seguenti per recuperare i file di dump (.dmp) salvati quando il contenitore ha esito negativo:

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 .

È possibile elencare la C:\k\containerdumps cartella per trovare il percorso completo dei file di dump dopo la connessione al nodo Windows.

RDP

Per trasferire i file dump TCP dal nodo Windows del servizio Azure Kubernetes alla macchina virtuale jump, seguire questa procedura:

1. Connettersi al nodo Windows del servizio Azure Kubernetes.

2. Eseguire il comando net use seguente per eseguire il mapping della risorsa condivisa della macchina virtuale jump a un'unità denominata Z. Se la risorsa condivisa è diversa dall'unità C, modificare il comando.

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

3. Per copiare i file di dump nella macchina virtuale jump, eseguire il comando copy seguente:

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

4. Terminare la connessione dalla macchina virtuale di salto al nodo Windows del servizio Azure Kubernetes. I file di dump sono ora nell'unità C della macchina virtuale jump.

Per copiare i file di dump dalla macchina virtuale jump nel computer, seguire questa procedura:

1. In Esplora file nella macchina virtuale jump passare alla directory radice dell'unità C.
2. Selezionare i file *.dmp.
3. Trascinare i file .dmp nella connessione denominata C in <myComputerName>.

I file di dump si trovano ora nella directory radice dell'unità C nel computer.

Contattaci per ricevere assistenza

In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.