5.11. Fournir des données de diagnostic au service d'assistance de Red Hat

Conditions préalables

• Vous avez accès au cluster en tant qu'utilisateur ayant le rôle cluster-admin.
• Vous avez un accès SSH à vos hôtes.
• Vous avez installé l'OpenShift CLI (oc).
• Vous avez un abonnement standard ou premium Red Hat.
• Vous disposez d'un compte Red Hat Customer Portal.
• Vous avez un numéro d'identification de dossier d'assistance Red Hat existant.

Procédure

• Télécharger les données de diagnostic vers un cas d'assistance Red Hat existant via le portail client de Red Hat.

  1. Concaténer un fichier de diagnostic contenu sur un nœud OpenShift Container Platform en utilisant la commande oc debug node/<node_name> et rediriger la sortie vers un fichier. L'exemple suivant copie /host/var/tmp/my-diagnostic-data.tar.gz d'un conteneur de débogage vers /var/tmp/my-diagnostic-data.tar.gz:

     $ oc debug node/my-cluster-node -- bash -c 'cat /host/var/tmp/my-diagnostic-data.tar.gz' > /var/tmp/my-diagnostic-data.tar.gz 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 de fichiers depuis un nœud de cluster en utilisant scp n'est pas recommandé et les nœuds seront entachés comme 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 les fichiers de diagnostic 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.

• Télécharger des données de diagnostic vers un cas d'assistance Red Hat existant directement depuis un cluster OpenShift Container Platform.

  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

  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 nécessaires à l'exécution de redhat-support-tool:

     # 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, pour éviter tout problème.

     1. Exécutez redhat-support-tool pour joindre un fichier du pod de débogage directement à un cas d'assistance Red Hat existant. Cet exemple utilise l'ID de cas d'assistance '01234567' et le chemin d'accès du fichier d'exemple /host/var/tmp/my-diagnostic-data.tar.gz:

        # redhat-support-tool addattachment -c 01234567 /host/var/tmp/my-diagnostic-data.tar.gz 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.