5.5. Générer une archive sosreport pour un nœud de cluster OpenShift Container Platform

Procédure

1. Obtenir une liste des nœuds de la grappe :

   $ oc get nodes

2. Entrez dans une session de débogage sur le nœud cible. Cette étape instancie un pod de débogage appelé <node_name>-debug:

   $ oc debug node/my-cluster-node

   Pour entrer dans une session de débogage sur le nœud cible entaché de l'effet NoExecute, ajoutez une tolérance à un espace de noms fictif et démarrez le module de débogage dans l'espace de noms fictif :

   $ oc new-project dummy

   $ oc patch namespace dummy --type=merge -p '{"metadata": {"annotations": { "scheduler.alpha.kubernetes.io/defaultTolerations": "[{\"operator\": \"Exists\"}]"}}}'

   $ oc debug node/my-cluster-node

3. Définissez /host comme répertoire racine dans le shell de débogage. Le pod de débogage monte le système de fichiers racine de l'hôte dans /host au sein du pod. En changeant le répertoire racine en /host, vous pouvez exécuter les binaires contenus dans les chemins d'exécution de l'hôte :

   # chroot /host

   Note

   Les nœuds de cluster OpenShift Container Platform 4.12 exécutant Red Hat Enterprise Linux CoreOS (RHCOS) sont immuables et s'appuient sur les opérateurs pour appliquer les changements de cluster. L'accès aux nœuds de cluster à l'aide de SSH n'est pas recommandé et les nœuds seront altérés en tant que accessed. Cependant, si l'API OpenShift Container Platform n'est pas disponible, ou si le kubelet ne fonctionne pas correctement sur le nœud cible, les opérations oc seront impactées. Dans de telles situations, il est possible d'accéder aux nœuds en utilisant ssh core@<node>.<cluster_name>.<base_domain> à la place.

4. Démarrer un conteneur toolbox, qui contient les binaires et les plugins nécessaires à l'exécution de sosreport:

   # toolbox

   Note

   Si un pod toolbox est déjà en cours d'exécution, la commande toolbox produit 'toolbox-' already exists. Trying to start…​. Supprimez le conteneur de boîte à outils en cours d'exécution avec podman rm toolbox- et créez un nouveau conteneur de boîte à outils, afin d'éviter tout problème avec les plugins sosreport.

5. Collecter des archives sur le site sosreport.

   1. Exécutez la commande sosreport et activez les plugins crio.all et crio.logs CRI-O container engine sosreport:

      # sosreport -k crio.all=on -k crio.logs=on 1

      1

      -k vous permet de définir les paramètres du plugin sosreport en dehors des paramètres par défaut.

   2. Appuyez sur Enter lorsque vous y êtes invité, pour continuer.
   3. Fournissez l'identifiant du dossier d'assistance de Red Hat. sosreport ajoute l'identifiant au nom de fichier de l'archive.

   4. La sortie sosreport indique l'emplacement de l'archive et la somme de contrôle. L'exemple de sortie suivant fait référence à l'identifiant de cas de support 01234567:

      Your sosreport has been generated and saved in:
        /host/var/tmp/sosreport-my-cluster-node-01234567-2020-05-28-eyjknxt.tar.xz 1
      
      The checksum is: 382ffc167510fd71b4f12a4f40b97a4e

      1

      Le chemin d'accès au fichier de l'archive sosreport se trouve en dehors de l'environnement chroot car le conteneur de la boîte à outils monte le répertoire racine de l'hôte à l'adresse /host.

6. Fournissez l'archive sosreport à l'assistance Red Hat pour analyse, en utilisant l'une des méthodes suivantes.

   • Téléchargez le fichier vers un cas d'assistance Red Hat existant directement à partir d'un cluster OpenShift Container Platform.

     1. Depuis le conteneur de la boîte à outils, exécutez redhat-support-tool pour attacher l'archive directement à un dossier d'assistance Red Hat existant. Cet exemple utilise l'ID de cas d'assistance 01234567:

        # redhat-support-tool addattachment -c 01234567 /host/var/tmp/my-sosreport.tar.xz 1

        1

        Le conteneur Toolbox monte le répertoire racine de l'hôte à l'adresse /host. Faites référence au chemin absolu du répertoire racine du conteneur Toolbox, y compris /host/, lorsque vous spécifiez les fichiers à télécharger par le biais de la commande redhat-support-tool.

   • Téléchargez le fichier vers un dossier d'assistance Red Hat existant.

     1. Concaténer l'archive sosreport en exécutant la commande oc debug node/<node_name> et rediriger la sortie vers un fichier. Cette commande suppose que vous avez quitté la session oc debug précédente :

        $ oc debug node/my-cluster-node -- bash -c 'cat /host/var/tmp/sosreport-my-cluster-node-01234567-2020-05-28-eyjknxt.tar.xz' > /tmp/sosreport-my-cluster-node-01234567-2020-05-28-eyjknxt.tar.xz 1

        1

        Le conteneur de débogage monte le répertoire racine de l'hôte à l'adresse /host. Faites référence au chemin absolu du répertoire racine du conteneur de débogage, y compris /host, lorsque vous spécifiez les fichiers cibles pour la concaténation.

        Note

        Les nœuds de cluster OpenShift Container Platform 4.12 exécutant Red Hat Enterprise Linux CoreOS (RHCOS) sont immuables et s'appuient sur les opérateurs pour appliquer les changements de cluster. Le transfert d'une archive sosreport à partir d'un nœud de cluster en utilisant scp n'est pas recommandé et les nœuds seront altérés en tant que accessed. Cependant, si l'API OpenShift Container Platform n'est pas disponible, ou si le kubelet ne fonctionne pas correctement sur le nœud cible, les opérations oc seront impactées. Dans de telles situations, il est possible de copier une archive sosreport à partir d'un nœud en exécutant scp core@<node>.<cluster_name>.<base_domain>:<file_path> <local_path>.

     2. Accédez à un dossier d'assistance existant sur https://access.redhat.com/support/cases/.
     3. Sélectionnez Attach files et suivez les instructions pour télécharger le fichier.