Capturer un fichier de vidage de conteneur Windows à partir d’un nœud Windows dans un cluster AKS

Article
12/14/2024

Si un conteneur Windows échoue sur un cluster Microsoft Azure Kubernetes Service (AKS), vous devrez peut-être examiner le fichier de vidage du conteneur Windows pour examiner la cause racine. Cet article fournit des étapes pour capturer un fichier de vidage de conteneur Windows à partir d’un nœud Windows dans un cluster AKS. Il inclut également des instructions pour télécharger le fichier de vidage sur votre ordinateur local pour une analyse plus approfondie.

Prerequisites

Un cluster AKS. Si vous n’avez pas de cluster AKS, créez-en un à l’aide d’Azure CLI ou via le Portail Azure.
Pools d’agents Windows créés après 3/13/2024 ou une image de nœud qui a été mise à niveau vers la version 20240316 de l’image Windows AKS ou une version ultérieure. Vous pouvez également vérifier si la version windowsCSEScriptsPackage est v0.0.39 ou ultérieure, qui peut être située sur C:\AzureData\CustomDataSetupScript.log les nœuds Windows.

Étape 1 : Ajouter des métadonnées d’annotations à votre déploiement

Montez un dossier hôte dans le conteneur et ajoutez les métadonnées d’annotations pour demander que le conteneur Windows stocke le fichier de vidage dans un dossier désigné :

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

Étape 2 : Reproduire le problème

Redéployez votre déploiement et attendez que le conteneur Windows échoue. Vous pouvez utiliser kubectl describe pod -n [POD-NAMESPACE] [POD-NAME] pour savoir quel nœud Windows AKS héberge le pod.

Étape 3 : Se connecter au nœud Windows

Établissez une connexion au nœud de cluster AKS. Vous vous authentifiez à l’aide d’une clé SSH (Secure Shell) ou du mot de passe administrateur Windows dans une connexion RDP (Remote Desktop Protocol). Les deux méthodes nécessitent la création d’une connexion intermédiaire. Cela est dû au fait que vous ne pouvez pas vous connecter directement au nœud Windows AKS. Que vous vous connectiez à un nœud via SSH ou RDP, vous devez spécifier le nom d’utilisateur pour les nœuds AKS. Par défaut, ce nom d’utilisateur est azureuser.

Si vous disposez d’une clé SSH, créez une connexion SSH au nœud Windows. La clé SSH ne persiste pas sur vos nœuds AKS. La clé SSH rétablit ce qui a été initialement installé sur le cluster pendant l’une des actions suivantes :

Restart
Mise à niveau de version
Mise à niveau d’image de nœud

Si vous n’avez pas de clé SSH, connectez-vous à l’aide du protocole RDP et du mot de passe administrateur Windows. Si vous n’avez pas ce mot de passe pour votre cluster, réinitialisez le mot de passe dans Azure CLI en exécutant la commande az aks update . Spécifiez le groupe de ressources, le nom du cluster et le nouveau mot de passe. La commande affiche les détails du cluster une fois qu’il a terminé :

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

Utilisez votre mot de passe d’administrateur Windows pour vous connecter au nœud à l’aide de RDP. Cette action nécessite que vous déployiez une machine virtuelle « jump » qui se connecte au même sous-réseau auquel votre cluster se connecte.

Rediriger un lecteur de données vers la connexion RDP

Pour transférer les fichiers de capture vers votre ordinateur, vous devez rediriger un disque dur à partir de votre ordinateur sur la machine virtuelle créée et la connexion RDP au nœud Windows AKS. Cette redirection vous permet de copier les fichiers de capture que vous générez ultérieurement sur votre ordinateur.

Sur votre ordinateur, sélectionnez Démarrer, puis recherchez et sélectionnez Connexion Bureau à distance.
Dans la boîte de dialogue Connexion Bureau à distance, sélectionnez Afficher les options.
Dans l’onglet Ressources locales, sélectionnez Plus.
Dans une nouvelle boîte de dialogue Connexion Bureau à distance, sélectionnez Lecteurs pour développer la liste des lecteurs qui se trouvent sur votre ordinateur, puis sélectionnez le lecteur à rediriger.
Connectez-vous à la machine virtuelle Windows que vous avez configurée précédemment.

Étape 4 : Transférer le fichier de vidage localement

Une fois le conteneur défaillant, identifiez le pod d’assistance pour pouvoir copier le fichier de vidage localement. Ouvrez une deuxième console, puis obtenez une liste de pods en exécutant la kubectl get pods commande, comme suit :

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

Le pod d’assistance a un préfixe , node-debugger-akscomme indiqué dans la troisième ligne. Remplacez le nom du pod, puis exécutez les commandes scp (Secure Copy) suivantes pour récupérer les fichiers de vidage (.dmp) enregistrés lorsque le conteneur échoue :

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 .

Vous pouvez répertorier le C:\k\containerdumps dossier pour trouver le chemin complet des fichiers de vidage une fois la connexion établie au nœud Windows.

Pour transférer les fichiers de vidage TCP du nœud Windows AKS vers la machine virtuelle de saut, procédez comme suit :

Connectez-vous au nœud Windows AKS.
Exécutez la commande net use suivante pour mapper la ressource partagée de la machine virtuelle de saut à un lecteur nommé Z. Si la ressource partagée est autre que le lecteur C, ajustez la commande.
```
C:\Users\bookbinder>net use z: \\tsclient\c
The command completed successfully.
```
Pour copier les fichiers de vidage sur votre machine virtuelle de saut, exécutez la commande de copie suivante :
```
C:\Users\azureuser>copy C:\k\containerdumps\*\*.dmp z:\
```
Terminez la connexion de la machine virtuelle de saut vers le nœud Windows AKS. Les fichiers de vidage sont désormais sur le lecteur C de la machine virtuelle de saut.

Pour copier les fichiers de vidage de la machine virtuelle de saut vers votre ordinateur, procédez comme suit :

Dans Explorateur de fichiers sur la machine virtuelle de saut, accédez au répertoire racine du lecteur C.
Sélectionnez les fichiers *.dmp.
Faites glisser les fichiers .dmp vers la connexion nommée C sur <myComputerName>.

Les fichiers de vidage se trouvent désormais dans le répertoire racine du lecteur C sur votre ordinateur.

Contactez-nous pour obtenir de l’aide

Pour toute demande ou assistance, créez une demande de support ou posez une question au support de la communauté Azure. Vous pouvez également soumettre des commentaires sur les produits à la communauté de commentaires Azure.

Partager via